Infopago API Docs
Primeiros Passos
QRCodes API - Cash-InAPI Contas - Cash-Out
Primeiros Passos
QRCodes API - Cash-InAPI Contas - Cash-Out
  1. Pagamentos
  • 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. Pagamentos

Métodos de Pagamentos

Pagamentos#

Guia Prático de Métodos de Pagamento#

Com a evolução dos sistemas de pagamento, diferentes métodos foram desenvolvidos para facilitar as transações financeiras, cada um com suas particularidades e vantagens.
Este guia apresenta três métodos amplamente utilizados no Pix:
Copia e Cola
Chave Pix
Dados Bancários

Copia e Cola#

O pagamento por Copia e Cola no Pix é uma forma prática de realizar transações utilizando um código convertido em texto.

Como funciona#

O QR Code é convertido em um código textual
O usuário copia esse código
Cola no aplicativo do banco ou instituição financeira

Quando usar#

Compras online
Dispositivos sem câmera
Problemas na leitura do QR Code

Chave Pix#

O pagamento por Chave Pix é uma das formas mais utilizadas no ecossistema Pix.
A chave funciona como um identificador único vinculado à conta do recebedor.

Tipos de chave#

CPF ou CNPJ
E-mail
Número de telefone
Chave aleatória (EVP)

Vantagens#

Não exige dados completos da conta
Transferência rápida e simplificada
Alta adoção no mercado

Dados Bancários#

Neste método, o pagamento é realizado utilizando os dados completos da conta do recebedor.

Dados necessários#

Número da conta
Agência
Nome do titular
Documento (CPF/CNPJ)

Quando usar#

Integrações mais tradicionais
Situações sem chave Pix cadastrada

Códigos de Erro PIX#

Estrutura#

CódigoNomeDescriçãoOrigem
AB03AbortedSettlementTimeoutTimeout na liquidação no SPISPI
AB09ErrorCreditorAgentErro no PSP do recebedorRecebedor
AB11TimeoutDebtorAgentTimeout do PSP emissorSPI
AC03InvalidCreditorAccountNumberConta/agência inválidaRecebedor
AC06BlockedAccountConta bloqueadaRecebedor
AC07ClosedCreditorAccountNumberConta encerradaRecebedor
AC14InvalidCreditorAccountTypeTipo de conta inválidoRecebedor
AG03TransactionNotSupportedTransação não permitidaRecebedor
AG12NotAllowedBookTransferTransferência interna não permitidaSPI
AG13ForbiddenReturnPaymentDevolução inválidaSPI
AGNTIncorrectAgentParticipante não liquidanteSPI
AM01ZeroAmountValor zeroSPI
AM02NotAllowedAmountValor acima do limiteRecebedor
AM04InsufficientFundsSaldo insuficienteSPI
AM09WrongAmountValor de devolução inválidoRecebedor
AM12InvalidAmountDivergência de valoresSPI
AM18InvalidNumberOfTransactionsNúmero de transações inválidoSPI
BE01InconsistenWithEndCustomerCPF/CNPJ inconsistenteRecebedor
BE05UnrecognisedInitiatingPartyIniciador não cadastradoSPI
BE17InvalidCreditorIdentificationCodeQR inválidoRecebedor
CH11CreditorIdentifierIncorrectDocumento inválidoRecebedor
CH16ElementContentFormallyIncorrectPayload inválidoSPI
DS04OrderRejectedOrdem rejeitadaRecebedor
DS0GNotAllowedPaymentOperação não autorizadaSPI
DS24WaitingTimeExpiredTempo excedidoRecebedor
DS27UserNotYetActivatedParticipante não ativoSPI
DT02InvalidCreationDateData inválidaSPI
DT05InvalidCutOffDateFora do prazo de devoluçãoRecebedor
ED05SettlementFailedFalha genéricaSPI / Recebedor
FF07InvalidPurposeFinalidade inválidaSPI
FF08InvalidEndToEndIdE2E inválidoSPI
MD01NoMandateISPB inválido (Saque/Troco)SPI
OZ01InsufficientBalanceSaldo insuficiente-
RC09InvalidDebtorClearingSystemMemberIdentifierISPB pagador inválidoSPI
RC10InvalidCreditorClearingSystemMemberIdentifierISPB recebedor inválidoSPI
RR04RegulatoryReasonRestrição regulatória (ONU)Recebedor
SL02SpecificServiceOfferedByCreditorAgentServiço inválidoRecebedor
OZ02ProcessingErrorErro de processamento-

Observações importantes#

Erros originados do SPI geralmente são sistêmicos ou de liquidação
Erros do Recebedor indicam problema na conta ou regras do PSP
Erros de validação (400) são causados por payload incorreto

Boas práticas#

Validar dados antes de enviar requisições
Tratar erros por categoria (negócio vs infraestrutura)
Implementar retry para falhas temporárias
Logar erros com contexto técnico (sem dados sensíveis)

Resumo#

Pix suporta múltiplos métodos de pagamento
Cada método atende um cenário específico
Códigos de erro seguem padrão estruturado
Tratamento correto de erros é essencial para robustez da integração
Página anterior
Cobrança com data de vencimento
Próxima página
Configurando Token de Acesso
Built with