Recuperar uma única instrução de pagamento

Recupera os dados e o estado atual de uma instrução de pagamento de Pix Automático pelo ID.

Use esta operação para consultas pontuais quando o identificador da instrução já for conhecido, inclusive para confirmar seu estado atual ou investigar uma recusa. Para localizar instruções quando o ID não for conhecido, utilize Listar instruções de pagamento.

A resposta permite relacionar a instrução à cobrança por paymentId e à autorização de origem por authorization.id. Quando status for REFUSED, utilize refusalReason para identificar a causa da recusa.

A API Key utilizada deve possuir a permissão PIX_AUTOMATIC:READ.

📘

Acompanhamento de mudanças

Para acompanhar agendamento, recusa e cancelamento das instruções, utilize Webhooks em vez de consultar este endpoint repetidamente.

O estado DONE pode ser retornado pela API, mas a conclusão financeira da cobrança deve ser acompanhada pelos eventos de cobrança previstos no fluxo do Pix Automático.

Consulte os Fluxos de Webhook do Pix Automático.

Conteúdos relacionados

Guides

Webhooks

Path Params
string
required

Identificador único da instrução de pagamento de Pix Automático no Asaas

Responses

403

Forbidden. Ocorre quando o body da requisição está preenchido, chamadas de método GET precisam ter um body vazio.

404

Not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json