Aceite pagamentos em cripto em uma loja online, sem plugin

Em resumo

Como funciona, passo a passo?

Do momento em que um cliente escolhe “Pagar com cripto” até o pedido sair do seu estoque:

1. 1

   Crie a fatura no checkout

   Quando o cliente escolhe cripto, o seu servidor chama POST /invoices com o total do pedido, o seu order_id, o e-mail do cliente, uma redirect_url de volta para a sua página de agradecimento e qualquer metadata que você queira receber de volta. A resposta é a fatura com uma checkout_url.

2. 2

   Envie o cliente para a página da fatura

   Redirecione para checkout_url. A página lista as moedas que você aceita; quando o cliente escolhe uma, o valor naquela moeda é calculado pelos preços atuais e fica garantido, e um endereço de depósito criado para esta fatura é exibido com um QR code. A fatura fica aberta pelo tempo que você definir, 30 minutos por padrão.

3. 3

   Receba os webhooks assinados

   O seu endpoint recebe invoice.confirming quando o pagamento é detectado on-chain e invoice.paid quando ele tem confirmações suficientes. Verifique o header CM-Signature, salve o evento, responda com um 2xx em até 10 segundos e depois libere o pedido a partir da sua cópia salva. Os eventos podem chegar duas vezes: use o id do evento para despachar uma só vez.

4. 4

   Trate os três casos especiais

   invoice.expired: nenhum pagamento chegou a tempo, então ofereça uma nova fatura. invoice.underpaid: o cliente pode enviar o restante para o mesmo endereço ou pedir reembolso na página da fatura. Uma fatura paga a mais continua paga; o excedente fica reservado para o cliente, que pode sacá-lo na página da fatura.

5. 5

   Saque

   Os pagamentos confirmados são creditados no seu saldo menos 1% e varridos para a carteira pool da sua empresa. Saque a qualquer hora para os seus próprios endereços, cada moeda como está ou tudo convertido para uma moeda de reserva.

A única chamada de API necessária

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

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 plugin para lojas. Não há módulo para WooCommerce, Shopify, Magento, PrestaShop nem OpenCart. Você mesmo adiciona a chamada de API, ou compartilha a sua página de checkout e os seus links de pagamento.
• Sem reembolsos automáticos e sem chamada de reembolso na API. Um pagamento em cripto confirmado é definitivo, então um reembolso é uma nova transferência. Para uma devolução, um Administrador cria um link de reembolso privado a partir do pagamento concluído no portal; o cliente informa o próprio endereço, a taxa de rede sai do reembolso e a taxa de 1% não é devolvida.
• Custodial, só em cripto. O Crypto Merchant guarda as chaves até você sacar, e os saques vão para os seus próprios endereços de carteira, não para uma conta bancária.

Para quem é?

• Lojas que já têm o próprio checkout e podem adicionar uma chamada de API e um webhook.
• Lojas que vendem para clientes em países onde é difícil ter cartão ou onde os chargebacks pesam.
• Lojas que precificam em dólares e querem receber em USDT ou USDC.

Páginas relacionadas

• Aceitar cripto na Shopify sem plugin
• Aceitar cripto no WooCommerce sem plugin
• Referência da API
• Webhooks
• Pagamentos a menos e a mais
• Melhores gateways de pagamento em cripto
• Preços e taxas

Outros casos de uso

• SaaS e assinaturas
• Freelancers
• Produtos digitais
• Doações

Todos os casos de uso