Casos de uso

Aceite pagamentos em cripto em um SaaS ou assinatura

Um SaaS aceita cripto com o Crypto Merchant criando uma fatura para cada período de cobrança e renovando a conta quando o webhook assinado invoice.paid chega. Carteiras de cripto não podem ser cobradas automaticamente, então uma renovação é uma fatura que o cliente paga, com um lembrete quando uma expira. Para créditos pré-pagos, as carteiras fixas dão a cada cliente um endereço de depósito permanente que credita o saldo dele em deposit.confirmed. A taxa é de 1% por fatura paga, sem mensalidade.

Atualizado em 6 de novembro de 2026

Tudo nesta página descreve como o Crypto Merchant funciona hoje, conforme a Referência da API, a documentação do checkout e Preços. Nada aqui é uma afirmação sobre outros gateways.

Em resumo

Tema	Como funciona
Como os clientes pagam	Uma página de fatura por período de cobrança, com link na sua tela de cobrança ou em um e-mail de renovação. Para saldos pré-pagos, o próprio endereço de depósito permanente, um por rede.
O que você constrói	Um job que cria uma fatura quando um período termina, com `metadata` identificando a conta e o período, e um endpoint de webhook que renova a conta. Ou `POST /sticky-wallets` por conta.
Cobranças recorrentes	Não são automáticas. Uma carteira de cripto não pode ser debitada, então cada renovação é uma nova fatura que o cliente paga. O evento `invoice.expired` indica quando enviar um lembrete.
Preços e reserva	Precifique os planos em dólares ou em outra moeda suportada; stablecoins contam como um dólar americano cada. Converta tudo o que recebe para USDT ou USDC para que a receita não acompanhe o mercado.
Registros de clientes	Envie `customer_email` e os pagamentos são agrupados por cliente no portal; `order_id` e `metadata` voltam em todo webhook.
Documentos para o cadastro	Nenhum. Você não precisa de uma empresa registrada para abrir uma conta; os Termos continuam valendo.

Como funciona, passo a passo?

Um plano mensal, do fim de um período ao início do próximo:

1
Crie uma fatura quando o período terminar
Um job agendado chama POST /invoices com o preço do plano, um order_id como o ID da assinatura mais o período, o e-mail do cliente, uma redirect_url de volta para a sua página de cobrança e metadata identificando a conta e o período.
2
Mostre ao cliente onde pagar
Coloque a checkout_url atrás de um botão “Pagar com cripto” na página de cobrança e no e-mail de renovação. O cliente escolhe uma moeda, a cotação fica garantida, e a fatura fica aberta pelo tempo que você definir, 30 minutos por padrão.
3
Renove a conta em invoice.paid
Verifique a assinatura, salve o evento, responda 2xx e depois renove por um período a conta identificada em metadata. Use o id do evento para que uma entrega repetida não a renove duas vezes.
4
Lembre em invoice.expired
Se a fatura expirar sem pagamento, crie uma nova e envie por e-mail. Uma fatura expirada não guarda nada: a cotação ficou garantida só enquanto ela estava aberta.
5
Créditos pré-pagos: dê a cada cliente um endereço permanente
Com as carteiras fixas, POST /sticky-wallets com o seu próprio ID para o cliente retorna sempre os mesmos endereços. Mostre-os em uma página de recarga; em deposit.confirmed, credite o cliente indicado em sticky_wallet.reference.

A única chamada de API necessária

Faturar um período de cobrança

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "29.00",
    "currency": "USD",
    "order_id": "sub_8f3a-2026-11",
    "description": "Pro plan, November 2026",
    "customer_email": "[email protected]",
    "redirect_url": "https://app.example/billing?paid=1",
    "metadata": { "account": "8f3a", "period": "2026-11" }
  }'

# On "invoice.paid": extend account 8f3a by one month (metadata is echoed back).
# On "invoice.expired": send a reminder with a fresh invoice.

Quanto custa?

1% de cada fatura paga, descontados quando o pagamento é creditado no seu saldo. Não há taxa de configuração, mensalidade nem pagamento para ativar a conta; faturas expiradas e canceladas não custam nada. Mover moedas (varreduras, conversões e saques) tem uma taxa de gas, descontada do seu saldo de gas, se você adicionar um, ou, caso contrário, das moedas que estão sendo movidas. Os clientes também pagam uma taxa de gas em cada fatura: ela é somada ao valor que enviam, aparece no checkout e nunca passa de US$ 5. As cotações de conversão incluem uma margem de serviço de 1%. Todos os custos estão em uma única tabela em Preços.

O que o Crypto Merchant não faz aqui

Sem renovações automáticas. Não há cartão salvo para cobrar nem objeto de assinatura. O seu job cria a fatura de cada período, e o cliente a paga.
Sem motor de impostos ou de cobrança de inadimplentes. O Crypto Merchant cria faturas, recebe pagamentos e avisa o seu servidor; IVA, recibos e e-mails de lembrete são você quem constrói.
Custodial, só em cripto. Os saldos ficam em uma carteira pool que o Crypto Merchant guarda até você sacar para os seus próprios endereços. Não há liquidação bancária.

Para quem é?

Ferramentas para desenvolvedores, APIs e software vendidos para clientes em muitos países.
Produtos cujos clientes já têm stablecoins e preferem pagar com elas.
Equipes sem empresa registrada que não conseguem abrir uma conta de lojista tradicional.

Perguntas frequentes

O Crypto Merchant pode cobrar meus clientes automaticamente todo mês?

Não. Carteiras de cripto não podem ser debitadas por um lojista. Cada renovação é uma fatura que o cliente paga; você a cria com a API quando o período termina e lembra o cliente se ela expirar.

Como sei a qual conta um pagamento pertence?

Envie o ID da conta em order_id ou metadata ao criar a fatura. Ambos voltam sem alterações no objeto da fatura e em todo webhook sobre ela.

Posso precificar meus planos em USDT?

As faturas têm preço em uma moeda como o dólar americano, e stablecoins contam como um dólar cada, então um plano de $29 custa 29 USDT mais qualquer taxa de gas mostrada no checkout. O cliente ainda pode pagar em qualquer moeda que você aceite, e você pode converter tudo o que recebe para USDT ou USDC.

Para que servem as carteiras fixas?

Saldos pré-pagos. Cada cliente recebe endereços de depósito permanentes, um por rede, e todo depósito confirmado é somado ao seu saldo com um webhook que identifica o cliente, para que você credite a conta certa.

Outros casos de uso

Todos os casos de uso

Comece a aceitar cripto hoje

Configuração gratuita, sem documentos no cadastro, 1% por fatura paga e saques quando você quiser.

Crie sua conta Ler a documentação