Visão geral
O fluxo de captura de reserva é usado para processar pagamentos usando comunicação dupla de
mensagens. Os fundos são reservados primeiro com uma chamada para o método reserveFunds
hospedado pelo integrador de pagamentos. Se esse método retornar SUCCESS
de maneira síncrona, isso significa que os fundos
são reservados e podem ser capturados ou liberados. Essa etapa é comumente conhecida como a execução de uma autenticação ou autorização.
Capturar reserva de fundos
Para capturar os fundos, faça uma chamada para
asynchronousCaptureFundsReservation
.
Isso vai iniciar o processo de transferência dos fundos para a Conta do Google.
Cancelar reserva de fundos
Como alternativa, a reserva de fundos pode ser cancelada com uma chamada para
asynchronousCancelFundsReservation
.
Isso libera a retenção dos fundos. Se uma reserva for cancelada, não haverá movimentação de dinheiro. As reservas são canceladas automaticamente após um período fixo, geralmente sete dias.
Número de referência do adquirente
Se os fundos forem capturados, um número de referência do adquirente (ARN, na sigla em inglês) será gerado. Esse
valor geralmente não é conhecido pelo integrador de pagamentos alguns dias depois.
Depois que o valor for conhecido, o integrador de pagamentos precisa chamar o
setAcquirerReferenceNumberForCaptureNotification
hospedado pelo Google
para fornecer o ARN ao Google. A associação do ARN a essa transação permite
que o Google lide com disputas e fraudes relacionadas a essa transação.
Operações subsequentes
Se os fundos forem capturados, o pagamento poderá ser reembolsado pelo Google com uma chamada para o método asynchronousRefund
hospedado pelo integrador de pagamentos. Como alternativa, o usuário ou o banco emissor pode iniciar o processo de estorno,
que é tratado pelo fluxo de disputa.