Baraka Pay DOCS

← Voltar à documentação

Depósitos em numerário

Dinheiro que chega ao balcão de um banco, ligado ao cliente que o enviou.

A Baraka Pay é dona da conta e da referência

Peça as instruções em nome do seu cliente e ser-lhe-á dito para onde o enviar e que referência escrever no talão. Quando o dinheiro chega, a Baraka Pay resolve essa referência até ao cliente e emite cash_deposit.confirmed — e você credita o seu cliente nesse webhook, exactamente como faria com um vale resgatado.

Tal como nos vales, nada aqui lança no livro-razão nem movimenta um saldo. É uma autorização para creditar, uma vez.

A referência é estável de propósito

Pedir duas vezes para o mesmo cliente devolve o mesmo código. Um pagador que perdeu o talão precisa da referência que já deu ao banco, não de uma segunda que parta o seu histórico em dois.

O numerário nunca credita por mera afirmação

Um cliente que diz ter pago não é dinheiro. O reconhecimento é um acto separado e auditado, assente no próprio registo do banco — hoje um membro da equipa que concilia uma linha do extracto à mão, amanhã uma notificação bancária a chamar o mesmo serviço com a sua própria referência externa. Nada a jusante do reconhecimento muda nesse dia.

POST /v1/cash-deposits/instructions where to send a payer, and the reference GET /v1/cash-deposits what has been registered POST /v1/cash-deposits/recognitions record money the bank actually received