Confirmação de pagamento
Pressupomos aqui que a transação já tenha sido iniciada (OUT1). É o momento em que o pagador tem a possibilidade de confirmar os dados para envio, tais como destinatário e valor.
A partir do momento que o pagador confirma sua operação (OUT3), seja interagindo em alguma plataforma ou APP, ou mesmo por chamada de API, o participante deverá chamar a API BS2 (OUT6) de solicitação de confirmação de pagamento, passando como argumento principal o pagamentoId
, gerado na etapa de iniciação.
Confirmação da transação de pagamento
Para confirmarmos um pagamento iniciado na etapa Fluxo de envio de Pix, solicitamos os campos abaixo:
Campo | Descrição | Formato | Obrigatório |
---|---|---|---|
pagamentoId | Identificador do pagamento gerado pelo Banco BS2 | string | Sim |
recebedor | Dados do recebedor da transação. Os dados informados neste objeto deverão ser os mesmos informados na iniciação do pagamento | object | |
retirada | Valor da transação, quando se trata de Pix Saque e Troco | object | Não |
valor | Valor da transação, quando se trata de Pix normal (compra ou transferência) | double | Não |
descricaoPagamento | Mensagem destinada ao recebedor | string | Sim |
tipoPrioridade | Tipo de prioridade da transação, conforme tabela Tipo Prioridade | string | Não |
Resposta:
Campo | Descrição | Formato | Nullable |
---|---|---|---|
pagamentoId | Identificador do pagamento gerado pelo Banco BS2 | string | Sim |
endToEndId | Identificador da transação | Sim | |
situacao | Status da transação de pagamento, conforme tabela Status do pagamento | string | Não |
Bloqueio na conta de Lastro
No primeiro passo após a confirmação pelo participante indireto da solicitação de envio da transação, o Banco BS2 verifica se o participante possui em sua conta lastro saldo suficiente para a operação.
A operação será rejeitada em caso de insuficiência de saldo na conta lastro, e uma mensagem de erro será retornada evidenciando o fato. Tendo saldo para a operação na conta lastro, o BS2 realizará o (OUT7) bloqueio imediato do valor nesta conta.
Encaminhamento da mensagem da operação para o SPI
Após a confirmação interna de sucesso no bloqueio do valor na conta lastro, o Banco BS2 gerará (OUT 8) uma mensagem do tipo PACS.008, que é uma mensagem padrão entre os participantes Diretos e o SPI para envio de valores pelo arranjo Pix, e ela será encaminhada para o SPI neste momento em caso de operação imediata ou, em caso de Pix agendado, programada para envio posterior.
Notificação
Quando o Banco BS2 receber do SPI a mensagem de confirmação de operação finalizada (PACS.002), informando se a operação foi efetivada ou rejeitada, efetivaremos o débito na conta lastro em caso de operação efetivada ou reverteremos o bloqueio em caso de operação não realizada (OUT10) e, em seguida, repassaremos essa informação ao participante (OUT11) com a utilização do WEBHOOK cadastrado em nosso ambiente pelo próprio participante para este tipo de operação.
Acesse a página Webhooks para participantes indiretos para orientações de como cadastrar as notificações.
Updated 7 months ago