Guia de integração rápida

Conecte pagamentos de stablecoin (USDT / USDC) em quatro etapas. Configure primeiro uma chave API, um segredo Webhook e receba carteiras para redes habilitadas. O exemplo à direita verifica sua chave API.

1

Criar uma ordem de pagamento

Seu back-end

Ligue para /api/v1/order/create de seu backend com o preço, moeda, rede e pedido do comerciante ID. A resposta contém sua carteira configurada e o valor final a pagar; vários pedidos podem compartilhar a mesma carteira.

GET /api/v1/ping verifica sua chave API. A criação de um pedido também requer um timestamp e uma assinatura de solicitação.
2

Exibir detalhes de pagamento

Sua interface

Abra checkoutUrl da resposta ou exiba valor, endereço, rede e moeda do objeto payment. Os fundos chegam diretamente à carteira configurada.

Use o payment.amount completo. payment.qrData contém QR data, não uma imagem.
3

Aguarde a confirmação do pagamento

BoltUtil

BoltUtil corresponde às transferências por rede, moeda, carteira e valor e, em seguida, envia uma notificação ao notifyUrl associado quando os requisitos de confirmação são atendidos. As exceções de pagamento qualificadas exigem análise do comerciante.

A confirmação e a entrega dependem do blockchain e das condições da rede. Um redirecionamento de página não comprova pagamento.
4

Verificar e cumprir

Seu back-end

Verifique a assinatura do corpo original e o timestamp, e associe o evento ao seu pedido. Confira o valor devido, o valor pago e o tipo de liquidação. Retorne HTTP 2xx após salvar o evento de forma durável e não repita a entrega do mesmo pedido.

Identifique eventos duplicados por eventId e não entregue o mesmo pedido comercial mais de uma vez. Em pagamentos insuficientes aceitos manualmente, o valor pago pode ser menor que o devido.

Redes e moedas

Verifique as moedas suportadas, as versões dos tokens e as regras de confirmação de pagamento.

Ver redes suportadas →