Infopago API Docs
Primeiros Passos
QRCodes API - Cash-InAPI Contas - Cash-Out
Primeiros Passos
QRCodes API - Cash-InAPI Contas - Cash-Out
  1. Cobranças
  • Guia de Integração Infopago
  • Ambiente Sandbox
  • Roteiro de sugestão de integração
  • Gerenciamento de Notificações (Webhooks)
  • Perguntas Frequentes
  • Assuntos relacionados ao Pix
  • Autenticação e Certificados
    • Certificado mTLS
    • Autenticação
  • Cobranças
    • Jornada da cobrança
    • Configurando Token de acesso
    • Jornadas do PIX Automático
    • Configurando Webhook
    • Cobrança de pagamento imediato
    • Cobrança com data de vencimento
  • Pagamentos
    • Métodos de Pagamentos
    • Configurando Token de Acesso
    • Configurando Webhooks
    • Fila de Saída
    • Infrações
    • O que é MED
    • MED 2.0
  1. Cobranças

Jornadas do PIX Automático

Jornada 1 — Autorização via notificação externa#

Na Jornada 1, o usuário pagador aceita a recorrência por meio de uma notificação externa ao ecossistema Pix.
Para mais detalhes, consulte o tópico 3.2 do Guia de Implementação do Pix Automático.
jornada-1.png
Nota: Diagrama conforme especificado pelo Banco Central do Brasil. Para mais detalhes, consulte o Guia de Implementação do Pix Automático.

Ordem de execução#

1.
Criar a recorrência
Utilize o endpoint de criação de recorrência Criar recorrência. com os dados do contrato.
2.
Criar solicitação de confirmação
Após a criação da recorrência, crie uma solicitação de confirmação de recorrência em Criar solicitação de confirmação de recorrência.
A partir disso, serão enviadas notificações ao usuário pagador.
3.
Gerenciar recorrência e confirmação (opcional)
Utilize endpoints para consulta, atualização ou cancelamento.
Gerenciamento de recorrências
Gerenciamento de solicitações de recorrências

Jornada 2 — Autorização via QR Code de recorrência#

Na Jornada 2, o usuário pagador autoriza a recorrência ao escanear um QR Code específico da recorrência em seu aplicativo bancário.
Para mais detalhes, consulte o tópico 3.3 do Guia de Implementação do Pix Automático.
jornada-2.png
Nota: Diagrama conforme especificado pelo Banco Central do Brasil. Para mais detalhes, consulte o Guia de Implementação do Pix Automático.

Ordem de execução#

1.
Criar a recorrência
Crie a recorrência em Criar recorrência. com os dados do contrato.
2.
Consultar recorrência para obter QR Code
Consulte a recorrência Consultar recorrência. para obter o QR Code no campo dadosQR.
⚠️ Importante
Não preencha o campo txid nessa etapa.
Ele será utilizado apenas nas Jornadas 3 e 4.
3.
Gerenciar recorrência (opcional)
Utilize endpoints para consulta, atualização ou cancelamento.
Gerenciamento de recorrências

Jornada 3 — QR Code composto com cobrança imediata#

Nesta jornada, o usuário paga uma cobrança imediata e, simultaneamente, autoriza a recorrência futura.
Para mais detalhes, consulte o tópico 3.4 do Guia de Implementação do Pix Automático.
jornada-3.png
Nota: Diagrama conforme especificado pelo Banco Central do Brasil. Para mais detalhes, consulte o Guia de Implementação do Pix Automático.

Ordem de execução#

1.
Criar a recorrência
Inicialmente, utilize o endpoint de criação de recorrência Criar recorrência. para criar a recorrência com os dados do contrato especificados na documentação.
2.
Criar cobrança imediata
Crie uma cobrança imediata utilizando o endpoint de Criar cobrança imediata. que será combinada com a recorrência no QR Code composto.
3.
Consultar recorrência com txid para obter QR Code composto
Consulte a recorrência informando o campo txid da cobrança imediata utilizando o endpoint Consultar recorrência. para obter os dados do QR Code composto. Os dados do QR Code serão encontrados no campo dadosQR retornado no response da requisição.
4.
Gerenciar recorrência e cobranças (opcional)
Gerenciamento de recorrências
Gerenciamento de cobranças para pagamento imediato

Jornada 4 — QR Code composto com cobrança com vencimento#

Nesta jornada, o usuário paga uma cobrança com vencimento e, ao realizar o pagamento, autoriza as recorrências futuras.
Para mais detalhes, consulte o tópico 3.5 do Guia de Implementação do Pix Automático.
jornada-4.png
Nota: Diagrama conforme especificado pelo Banco Central do Brasil. Para mais detalhes, consulte o Guia de Implementação do Pix Automático.

Ordem de execução#

1.
Criar a recorrência
Inicialmente, utilize o endpoint de criação de recorrência Criar recorrência. para criar a recorrência com os dados do contrato especificados na documentação.
2.
Criar cobrança com vencimento
Crie uma cobrança com vencimento utilizando o endpoint Criar cobrança com vencimento. que será combinada com a recorrência no QR Code composto.
3.
Consultar recorrência com txid para obter QR Code composto
Consulte a recorrência informando o txid da cobrança com vencimento utilizando o endpoint Consultar recorrência. para obter os dados do QR Code composto. Os dados do QR Code serão encontrados no campo dadosQR retornado no response da requisição.
4.
Gerenciar recorrência e cobranças (opcional)
Gerenciamento de recorrências
Consultar cobrança com vencimento.

Resumo comparativo das jornadas#

JornadaMétodo de autorizaçãoQR CodeCobrança inicial
Jornada 1Notificação externaNãoNão
Jornada 2QR Code de recorrênciaSimNão
Jornada 3QR Code compostoSimSim (cobrança imediata)
Jornada 4QR Code compostoSimSim (cobrança com vencimento)

Próximos passos#

Após a autorização da recorrência:
Monitorar recorrência
Utilize webhooks para acompanhar mudanças de status
Criar cobranças recorrentes
Gere cobranças conforme o calendário definido
Consultar cobranças
Verifique o status das cobranças geradas
Gerenciar recorrência
Atualize ou cancele recorrências conforme necessário
Para mais detalhes, consulte a documentação completa da API.
Página anterior
Configurando Token de acesso
Próxima página
Configurando Webhook
Built with