Envie Pix com cripto pela sua aplicação.

Como funciona o Pix com USDT pela API

O fluxo começa com um depósito de USDT ou outra criptomoeda habilitada. Após as confirmações e o processamento, o saldo em USDT fica disponível para pagamentos. O destinatário recebe reais por Pix e não precisa de conta CriptoCore.

1. Consulte GET /balances e GET /capabilities.
2. Informe operation.type = pix, o valor em cents e a chave em POST /quotes.
3. Revise debit_micros, os dados do destinatário e as condições da operação.
4. Envie POST /operations com max_debit_micros e uma Idempotency-Key persistida.
5. Guarde o ID e acompanhe a conclusão.

Pix por chave e Pix copia e cola

Para uma chave Pix, informe key e, quando aplicável, keyType. Para um código copia e cola, use primeiro POST /pix/decode para ler os dados. Se a resposta informar um valor em centavos, respeite-o na operação do tipo pixqr.

A integração recebe o texto do código Pix, não uma imagem de QR Code. Caso seu produto tenha câmera, a leitura da imagem deve produzir o código antes de chamar a API. Veja a referência de pagamentos para os campos e validações.

Cotação, valor em reais e teto de débito

O campo cents representa centavos de reais: 10000 equivale a R$ 100. A cotação retorna o custo em micros de USDT; 1000000 equivale a 1 USDT. Não trate esses campos como a mesma unidade.

A simulação não congela a taxa. Na confirmação, max_debit_micros limita o débito aceito. Se o custo ultrapassar esse teto, a operação é recusada com DEBIT_CEILING_EXCEEDED. Consulte GET /fees e as tarifas para os custos vigentes.

Como confirmar o pagamento e evitar duplicidade

Uma resposta 202 significa que a operação foi aceita para processamento; ainda não comprova a conclusão. Salve data.id e acompanhe em GET /operations/{id}, por webhook ou callback. Se houver timeout, consulte a operação e repita com a mesma Idempotency-Key e o mesmo corpo. Uma nova chave pode criar outra operação.

A confirmação vem do estado final e das transações associadas, incluindo o identificador E2E quando disponível. Uma operação em revisão exige acompanhamento; não envie outro Pix automaticamente. Use reference para localizar a operação a partir da referência do seu sistema.

O que é necessário para integrar

Crie uma chave com leitura e payments:write. Confira a política de IP, o saldo e os limites de saída. Comece por POST /quotes e POST /operations na documentação.

As chamadas usam a conta CriptoCore e o saldo real em produção. Não há sandbox público. Consulte GET /capabilities, GET /fees e a cotação antes de operar. Disponibilidade, saldo, permissões e limites da conta continuam valendo para a API.

Dúvidas frequentes