Informações verificadas em
Consulte o boleto antes de autorizar
Envie o código a POST /boletos/quote. A consulta traz os dados necessários para revisar o título, o beneficiário e o valor atualizado. Conferir o boleto não executa o pagamento.
Use data.quoteId como operation.quoteId e data.cents como operation.cents. Não substitua o valor retornado por um cálculo próprio de juros, multa ou desconto. Se a consulta falhar, revise o código e a disponibilidade antes de prosseguir.
Do valor em reais ao débito em USDT
- Consulte o boleto e revise os dados com o responsável pelo pagamento.
- Monte a operação
type: boletocom código, valor e identificador da consulta. - Envie a operação a
POST /quotespara conhecer o custo em USDT. - Confirme em
POST /operationscom o teto de débito e uma chave de idempotência persistida. - Salve o ID retornado para acompanhar a operação.
O depósito de cripto precisa ter sido processado e creditado antes do pagamento. A chave da integração precisa de payments:write para autorizar a saída.
Pagamento, processamento e baixa do boleto
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 conclusão na plataforma e a baixa no sistema do beneficiário são etapas diferentes. O prazo depende do processamento bancário e do título. Consulte o extrato e o comprovante disponível no painel, sem repetir o pagamento porque a cobrança ainda aparece em aberto.
O guia de boleto pendente e comprovante explica como interpretar essas etapas.
Tarifas, limites e janela de pagamento
Consulte os custos vigentes em GET /fees e na cotação. Limites da conta, disponibilidade do título e janelas de processamento também se aplicam. A consulta de boletos tem limite próprio descrito na documentação de erros e limites; evite repetir a consulta em um loop.
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
Esta API emite boletos para cobrar clientes?
Não. A função documentada é consultar e pagar boletos existentes com o saldo da conta. Emissão de boletos de cobrança não faz parte da API pública.
Consultar o boleto já desconta o saldo?
Não. A consulta e a simulação do custo não pagam o boleto. A saída exige criar a operação financeira e acompanhar seu resultado.
Como pagar um boleto que também tem QR Code Pix?
Você pode escolher o pagamento do boleto pelo código ou o fluxo de Pix copia e cola. Escolha um único caminho para a mesma cobrança e confira os dados para evitar pagamento duplicado.