Criar pagamento em cripto
Cria um pagamento em cripto a partir de um valor em moeda fiduciária e devolve carteira e QR Code.
apiKeyAuthorizationBearer <token>Chave de API gerada no painel: Authorization: Bearer <chave>.
application/json- body
Campos fora desta lista fazem a requisição ser recusada com 400.
amount*numberValor na moeda fiduciária de fiat_currency, como número (500.00).
0.01 <= valuefiat_currency?stringMoeda fiduciária do valor. Padrão USD.
"USD""BRL""USD""EUR""GBP""JPY""CAD""AUD"pay_currency?stringMoeda cripto do pagamento. Padrão USDTBSC. Este endpoint usa
códigos próprios, diferentes dos tickers REDE_ATIVO de
POST /charge.
"USDTBSC""BTC""ETH""USDC""USDTBSC""USDTTRC20""MATIC"customer_name?stringNome do pagador.
customer_email?stringE-mail do pagador.
emailexternal_reference?stringIdentificador do pedido no seu sistema.
redirect_url?stringURL de retorno associada ao pagamento. Volta em redirect_url.
uriexpire_at?stringPrazo registrado do pagamento, em ISO 8601. Padrão: 24 horas após a criação.
date-timefixed_rate?booleantrue trava a cotação durante a janela de pagamento, a um custo
maior para o pagador (cerca de 1%). false usa cotação flutuante,
mais próxima do mercado. Omitido, vale a cotação flutuante.
Pagamento criado, aguardando a transferência.
application/json- response
id?stringId do pagamento (24 caracteres hexadecimais). Use em GET /invoices/payment-gateway/{id}.
id_transaction?stringId da transação.
uuidstatus?CryptoInvoiceStatusStatus do pagamento. Os principais: WAITING_PAYMENT (aguardando),
PAYMENT_RECEIVED (pago), PAYMENT_PARTIAL (pago abaixo do valor),
PAYMENT_EXPIRED, PAYMENT_FAILED e CREATION_FAILED.
"WAITING_PAYMENT""REVIEW_REQUIRED""PAYMENT_RECEIVED""PAYMENT_PARTIAL""PAYMENT_EXPIRED""PAYMENT_FAILED""CREATION_FAILED""REFUND_REQUESTED""REFUND_COMPLETED""WITHDRAWAL_IN_PROGRESS""WITHDRAWAL_IN_PROCESSING""WITHDRAWAL_COMPLETED""WITHDRAWAL_FAILED"payment_id?stringId do pagamento no processador de cripto.
qr_code?stringImagem do QR Code em base64 (PNG, sem o prefixo data:).
pay_address?stringEndereço da carteira com o valor em cripto (<endereço>?amount=<valor>).
amount?numberO valor enviado em amount, na moeda fiduciária.
currency?stringA moeda fiduciária do valor.
expires_at?stringPrazo registrado do pagamento.
date-timeredirect_url?|O redirect_url enviado.
curl -X POST 'https://api-gateway.gates2b.com/payments/v2/crypto' \ -H 'Content-Type: application/json' \ -d '{ "amount": 500, "fiat_currency": "BRL", "pay_currency": "USDTBSC", "customer_name": "Maria da Silva", "customer_email": "cliente@example.com", "external_reference": "pedido-0005"}'{ "id": "68d2fa97b30181b2d2f13600", "id_transaction": "d615bb9b-e935-47c4-ac19-ad046e4b5f1a", "status": "WAITING_PAYMENT", "payment_id": "6043353044", "qr_code": "iVBORw0KGgoAAAANSUhEUgAA...", "pay_address": "0x1CEfB8730786f34af8B10dC4e5B8028F79a63abd?amount=91.24", "amount": 500, "currency": "BRL", "expires_at": "2026-10-23T14:00:00.000Z", "redirect_url": null}Outro endereço base e outro formato de erro
Este endpoint responde em https://api-gateway.gates2b.com, não no endereço principal da API. Os erros
também têm outro corpo: sem code e sem traceId.
Regras
- Para integrações novas, prefira Criar cobrança com
paymentMethod: "CRYPTO": ela devolve link de checkout, status de cobrança e o eventocharge.paid. - Só
amounté obrigatório, mas envie semprefiat_currencyepay_currency. Sem eles, valemUSDeUSDTBSC. amounté número na moeda fiduciária (500.00), não string.pay_currencyusa os códigos deste endpoint (USDTBSC,BTC…), não os tickersREDE_ATIVOde/charge.- Campo desconhecido no corpo responde
400. qr_codeé a imagem PNG em base64 sem o prefixodata:. Para usar em<img>, prefixe comdata:image/png;base64,.- Consulte o andamento com Consultar pagamento em cripto, usando o
idda resposta.