Fluxo de recebimento de Pix
O fluxo de recebimento tem início com a chegada (IN1) ao Banco BS2 de uma mensagem PACS.008 (pagamento), encaminhada pelo SPI.
Validação do crédito pelo participante indireto
Sendo uma mensagem destinada ao participante indireto, o Banco BS2 solicitará, de modo síncrono, ao participante que valide o crédito (IN2) através da chamada de uma API desenvolvida pelo próprio participante indireto.
Caso o participante não responda a requisição dentro do limite de tempo definido, tentaremos reenviar a notificação. (Saiba mais em Webhooks para participantes indiretos).
Importante:
O tempo hábil para responder à requisição de validação do recebimento é de até 300ms.
Persistindo o problema, o Banco BS2 retornará ao SPI o código de erro AB09 (Transação interrompida devido a erro no participante do usuário recebedor) e o recebimento não será efetivado.
Caso a transação seja validada e possa prosseguir, o participante deverá retornar o return code 200. Em caso de rejeição, retornar o 200, mas detalhando o motivo conforme a tabela de domínios SPI para rejeições de recebimentos.
Após o retorno da etapa IN2, o Banco BS2 criará a mensagem PACS.002 (validação) com a resposta recebida do participante indireto e a encaminhará para o SPI (IN4).
O SPI registrará a operação na conta PI dos participantes diretos e, em seguida, notificará a esses mesmos participantes diretos que a transação foi finalizada (OUT10 e IN5).
Crédito na conta Lastro do participante
No momento em que o Banco BS2 recebe a PACS.002 (confirmação), realizamos o crédito do valor na conta Lastro do participante indireto (IN6).
Notificação de Crédito
Nesta etapa o participante indireto é notificado do recebimento, através do WebHook cadastrado (IN7).
Acesse a página Webhooks para participantes indiretos para orientações de como cadastrar as notificações.
Créditos, integrações e avisos aos clientes finais
A partir deste ponto, caberá ao participante indireto realizar o crédito (IN8), notificação para o cliente final (IN9) e, se for o caso, realizar integrações com seus processos (IN10).
Consulta de recebimento
Nesta funcionalidade permitimos a consulta a recebimentos.
Solicitamos os campos:
Campo | Descrição | Formato | Obrigatório |
---|---|---|---|
EndToEndId | Identificador da transação | string | Sim, se TransactionId não for informado |
TransactionId | Código usado para identificar o pagamento. | string | Sim, se EndToEndIdnão for informado |
Resposta:
Campo | Descrição | Formato | Nullable |
---|---|---|---|
EndToEndId | Identificador da transação | string | Sim |
TransactionId | Código usado para identificar o pagamento | string | Sim |
valor | Valor do recebimento | double | Não |
solicitadoEmUtc | Data e hora em que o pagamento foi solicitado pelo pagador | date-time | Não |
dataContabil | Data da contabilização da transação em UTC -3 | date-time | Sim |
recebedor | Dados do recebedor do Pix (banco, agência, conta, documento) | object | Não |
pagador | Dados do pagador do Pix (banco, agência, conta, documento) | object | Não |
status | Status do recebimento, conforme tabela Status recebimento | string | Não |
tipoIniciacao | Tipo de iniciação utilizado no recebimento, conforme tabela Tipo de iniciação | string | Não |
motivoRejeicao | Em caso de rejeição da transação, este campo apresenta o código e motivo conforme retornado na PACS.002 | string | Não |
erroDescricao | Apresenta a descrição do erro, se tiver ocorrido erro no recebimento | string | Sim |
chaveDict | Chave Pix utilizada no pagamento da transação Pix | string | Sim |
finalidade | Finalidade da transação, conforme tabela Finalidade Transação | string | Sim |
prioridadeTransacao | Prioridade da transação, conforme tabela Prioridade Transação | string | Não |
tipoPrioridadeTransacao | Tipo de prioridade da transação, conforme tabela Tipo Prioridade | string | Não |
valorSaqueOuTroco | Valor do Saque ou troco, utilizado para finalidades de Pix Saque/Troco | double | Sim |
ispbFacilitadorServicoSaqueOuTroco | ISPB do facilitador do serviço de Saque ou Troco | Sim | |
modalidadeAgente | Tipo de modalidade do agente, conforme tabela Modalidade do Agente | string | Não |
campoLivre | Mensagem destinada ao recebedor | string | Sim |
cnpjIniciadorPagamento | CNPJ da instituição iniciadora do pagamento | string | Sim |
Updated 5 months ago