Checkout

Sua página de checkout

Toda loja tem a própria página de checkout em /pay/<store>, onde <store> é o nome curto da sua loja. Lá, os clientes podem informar um valor ou escolher um dos seus links de pagamento. Compartilhe-a em qualquer lugar onde você fala com clientes: seu site, perfis nas redes sociais, chats ou e-mails.

Você encontra o link no portal, em Sua página de checkout.

A página da fatura

Toda fatura tem a própria página em /pay/i/<invoice_id>. A API retorna esse link como checkout_url. Nela, o cliente:

• escolhe uma moeda e uma rede entre as que você aceita;
• vê um endereço de depósito criado para esta fatura, com um QR code, e o valor exato a enviar, por uma cotação garantida naquele momento;
• pode trocar de moeda até que um pagamento seja detectado;
• acompanha a mudança de status em tempo real, de aguardando para confirmando e para paga.

Cada fatura fica aberta por um tempo limitado, exibido como contagem regressiva. Se o tempo acabar antes de algum pagamento ser detectado, a fatura expira. Se você definir um redirect_url, o cliente pode voltar ao seu site depois de pagar.

Se um cliente pagou, mas o pagamento não apareceu antes de a fatura expirar, ele pode relatar isso na página da fatura. O endereço então sai de rotação e fica sob monitoramento, e nossa equipe de suporte verifica o pagamento.

Links de pagamento

Um link de pagamento é um link reutilizável para um produto, serviço ou doação, em /pay/l/<link_id>. Dê a ele um título e um valor fixo, ou deixe o valor em branco para que o cliente o informe. Cada pagamento feito por um link vira uma fatura própria.

Crie links no portal, em Links de pagamento, ou com a API.

Prévias de compartilhamento

Quando você compartilha um link de pagamento ou a sua página de checkout no WhatsApp, Telegram, Instagram, X e apps parecidos, o app mostra um cartão de prévia. Ele traz o nome da sua loja, o seu domínio verificado, se você tiver um, e as moedas que você aceita. Em um link de pagamento, também mostra o produto e o preço.

Os links de pagamento não aparecem nos mecanismos de busca, então um link só chega às pessoas com quem você o compartilha.

Domínio verificado

Se você verificou o domínio do seu site, a sua página de checkout, os links de pagamento, as páginas de fatura e as páginas de reembolso o exibem ao lado do nome da sua loja, por exemplo shop.com · verificado. Isso mostra aos clientes que a loja da página controla o DNS desse domínio. Veja como verificar o seu domínio.

Cotações

As faturas têm preço em uma moeda como o dólar americano. Quando o cliente escolhe uma moeda, o valor nessa moeda é calculado com base nos preços atuais e fica garantido. Stablecoins como USDT e USDC valem um dólar americano cada. Se o pagamento for detectado pela primeira vez enquanto a fatura ainda estiver aberta, vale a cotação garantida.

Clientes que pagam de uma corretora

As corretoras costumam descontar a taxa de saque do valor que o cliente digita, então chega menos do que foi enviado. Essa é a causa mais comum de faturas pagas a menos. A página da fatura tem um aviso Pagando de uma corretora? que pede ao cliente para garantir que chegue o valor total.

Quando a taxa de saque da Binance para aquela moeda e rede está disponível, o aviso também mostra a taxa e o total a informar na Binance. Outras corretoras cobram as próprias taxas, que o cliente deve conferir na tela de saque.

Moeda ou rede errada

Às vezes os clientes pagam em uma moeda diferente da que a fatura pediu, ou por outra rede. O Crypto Merchant monitora o endereço de cada fatura para todas as moedas compatíveis, em todas as redes compatíveis que usam esse endereço, então esses pagamentos são detectados.

Um mesmo endereço EVM funciona em Ethereum, BNB Smart Chain, Polygon, Base e Arbitrum One, e guardamos a chave dele em todas essas redes. Assim, USDC enviado pela Base para uma fatura que pediu USDC na Ethereum ainda chega a um endereço que controlamos. Tron, Bitcoin, Litecoin, Solana, TON e XRP Ledger têm cada uma o próprio tipo de endereço. Nessas redes, isso vale para uma moeda diferente na mesma rede, por exemplo TRX enviado para uma fatura de USDT na Tron.

Quando é contabilizado automaticamente

O pagamento conta para a fatura sozinho quando as duas condições abaixo são verdadeiras:

• nada mais foi pago na fatura ainda;
• as moedas cobrem o valor da fatura, dentro da sua tolerância para pagamentos a menos.

A fatura passa então para a moeda que foi realmente enviada. A página da fatura informa ao cliente em qual moeda ele pagou no lugar da que foi pedida. Você vê a Moeda solicitada no pagamento e no e-mail do pagamento. Na API, coin é o que foi pago e requested_coin é o que a fatura pediu.

As moedas são avaliadas assim:

• stablecoins como USDT e USDC valem um dólar americano cada;
• a mesma moeda em outra rede, como ETH na Base para uma fatura em ETH na Ethereum, mantém a cotação que foi mostrada ao cliente;
• qualquer outra moeda é avaliada pelo preço de mercado no momento em que chegou.

Isso também vale para pagamentos atrasados: quando a fatura já expirou, mas o endereço dela ainda está sendo monitorado, o que dura pelo menos 24 horas.

Valores menores e tokens avulsos

Todo o resto nunca altera a fatura: um pagamento parcial em outra moeda, uma segunda moeda em uma fatura que já tem um pagamento ou um token avulso. Isso é creditado no seu saldo como um pagamento sem fatura, descontada a taxa de 1%, e um ticket de suporte avisa você, para que você possa resolver com o cliente. Um token minúsculo enviado ao endereço não consegue tomar conta de uma fatura.

Um pagamento atrasado para uma fatura cancelada ou reembolsada é tratado da mesma forma: ele é creditado no seu saldo e você recebe um ticket.

O que ainda pode ser perdido

Moedas em uma rede ou em uma moeda que o Crypto Merchant não suporta, e moedas enviadas para qualquer endereço que não seja o da fatura, não podem ser contabilizadas e podem ser perdidas para sempre. Os clientes devem continuar enviando a moeda exibida, na rede exibida.

Faturas pagas a menos

Você define uma tolerância para pagamentos a menos nas suas configurações; recomendamos pelo menos US$ 1. Se um pagamento confirmado ficar abaixo do valor em no máximo a tolerância, a fatura conta como paga.

Se faltar mais do que isso, a fatura fica paga a menos. O que foi enviado fica reservado para o cliente, que pode enviar o restante para o mesmo endereço ou receber o reembolso do que enviou em um endereço que ele informar. A taxa de rede do reembolso é descontada do próprio reembolso.

Faturas pagas a mais

Se um cliente envia mais do que a fatura pede, a fatura conta como paga mesmo assim. O que acontece com o excedente depende do valor:

• A fatura conta como paga, e o excedente fica reservado para o cliente. O cliente pode sacá-lo para a própria carteira na página da fatura, menos a taxa de rede do envio.
• Até lá, o Crypto Merchant guarda o valor para o cliente. Ele não é somado ao saldo da empresa e nunca fica retido como taxa.

Reembolsos depois de um pagamento

Você pode devolver dinheiro de um pagamento concluído, por exemplo em uma devolução ou em um pedido cancelado. Abra o pagamento no portal e use Reembolsar este pagamento. Somente Administradores podem fazer isso, e antes eles confirmam que são eles mesmos com um código novo recebido por e-mail ou no app autenticador.

• Você pode reembolsar qualquer valor até o que ficou com você desse pagamento: o que foi creditado para você depois da taxa de 1%, menos os reembolsos anteriores e os links de reembolso que ainda estão abertos. A taxa de 1% não é devolvida.
• O valor é reservado do seu saldo na hora, para que não possa ser sacado por engano enquanto isso.
• Se o pagamento tiver o e-mail do cliente, ele recebe um e-mail com um link privado. Você também pode copiar o link e enviá-lo você mesmo.
• O cliente abre o link, informa o próprio endereço para aquela moeda e rede, marca uma confirmação e envia. O reembolso sai da sua carteira pool, e a taxa de rede é descontada do reembolso.
• Um link fica aberto por 14 dias. Se o cliente não o resgatar a tempo, ou se você o cancelar, o valor volta automaticamente para o seu saldo. Cada link pode ser resgatado uma única vez.

Um reembolso parcial mantém o pagamento com o status Paga e mostra o valor reembolsado. Reembolsar tudo o que ficou com você muda o status para Reembolsada. Cada resgate envia um webhook invoice.refunded, e o objeto de fatura mostra o total em refunded_amount.

Como o cliente digita o endereço na página de reembolso, ninguém precisa trocar endereços por chat, onde um erro de digitação ou um impostor pode mandar as moedas para o lugar errado. As transferências de cripto não podem ser revertidas, então o cliente deve informar um endereço que ele controla, na rede exibida.

As faturas pagas a menos continuam tendo a própria opção de reembolso para o cliente na página da fatura, e os clientes ainda podem sacar por lá um excedente, como descrito acima. Um reembolso não recupera as partes já reservadas para os parceiros da divisão de receita.

Taxas

1% de cada fatura paga é descontado quando o pagamento é creditado no seu saldo. Faturas expiradas e canceladas não custam nada.

Não há taxa adicional quando um pagamento é contabilizado depois de chegar em outra moeda ou por outra rede. Quando você reembolsa um pagamento, a taxa de 1% não é devolvida, e a taxa de rede do reembolso é descontada do reembolso.

O valor a pagar também inclui uma taxa de gas para mover esse pagamento para a sua carteira pool, nunca mais de US$ 5. Na maioria das redes, são alguns centavos. USDT na Tron custa mais, porque a Tron queima energia a cada transferência de token. O checkout mostra a taxa ao lado do preço, e a API a retorna como network_fee_amount e network_fee_usd. Ela cobre a varredura desse pagamento, não é sua receita, e nenhuma taxa de pagamento é cobrada sobre ela.