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:

CampoDescriçãoFormatoObrigatório
pagamentoIdIdentificador do pagamento gerado pelo Banco BS2stringSim
recebedorDados do recebedor da transação. Os dados informados neste objeto deverão ser os mesmos informados na iniciação do pagamentoobject
retiradaValor da transação, quando se trata de Pix Saque e TrocoobjectNão
valorValor da transação, quando se trata de Pix normal (compra ou transferência)doubleNão
descricaoPagamentoMensagem destinada ao recebedorstringSim
tipoPrioridadeTipo de prioridade da transação, conforme tabela Tipo PrioridadestringNão

Resposta:

CampoDescriçãoFormatoNullable
pagamentoIdIdentificador do pagamento gerado pelo Banco BS2stringSim
endToEndIdIdentificador da transaçãoSim
situacaoStatus da transação de pagamento, conforme tabela Status do pagamentostringNão

Confirmação de um pagamento

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.