Fluxo de remessa

Informações gerais

Remessa é quando o dinheiro é transferido de uma parte para outra. Um exemplo pode ser quando dinheiro é enviado do banco do integrador de pagamentos para o banco do Google. O diagrama a seguir ilustra como isso ocorre.

Como o fluxo funciona

O diagrama a seguir ilustra um exemplo de como o fluxo de remessa pode funcionar.

Integrador de pagamento de remessa para o Google

Integrador de pagamento de remessa do Google

Veja uma lista dos objetos usados no diagrama:

  • Servidor do Google: o servidor de back-end no Google que faz a verificação de autenticação, além de outras tarefas.
  • Integrador de pagamentos: a empresa que oferece uma forma de pagamento aos clientes.
  • Banco do integrador de pagamentos: o banco emissor usado pelo integrador para transações financeiras.
  • Google Bank: o banco que o Google usa em transações.

O fluxo de remessa acima começa com o servidor do Google.

  1. Nos dias T+N, o Google envia a notificação do extrato de remessa (remittanceStatementNotification).
  2. O integrador de pagamentos notifica o servidor do Google de que recebeu a notificação do extrato de remessa.
  3. O integrador de pagamentos também envia detalhes do extrato de remessa (remittanceStatementDetails).
  4. O servidor do Google responde com a instrução com o transactionDetails.
  5. O integrador de pagamentos reconcilia os detalhes.
  6. O integrador de pagamentos envia uma mensagem (acceptRemittanceStatement) ao servidor do Google informando que a fatura foi aceita.
  7. O integrador de pagamentos também envia uma mensagem informando que o banco do integrador de pagamentos deve enviar fundos ao banco do Google.
  8. O banco do integrador de pagamentos transfere fundos para o Google Bank.

Práticas recomendadas e outras considerações

Cronograma

As condições de pagamento são definidas no contrato e normalmente expressas como T+N. T é a frequência com que um extrato de remessa é gerado e a duração do período que cada extrato abrange. No exemplo a seguir, T é um dia de transação. N é o número de dias após o período de transação que o extrato de remessa chega.

Se N estiver configurado como 2 e uma transação for contabilizada às 23:59:59.999 no fuso horário do faturamento na terça-feira, ela aparecerá em um extrato na quinta-feira.

Declarações negativas ou de zero

Nos dias em que não houver transações dentro do período de faturamento, as notificações de extrato de remessa não serão enviadas. Além disso, se houver reembolsos dentro de um período de faturamento que resulte em um valor líquido negativo da fatura, os extratos de remessa também não serão enviados. No entanto, essas transações serão incluídas na próxima fatura líquida positiva, para a qual a notificação do extrato de remessa será enviada. Caso o valor da transação seja 0 em um período de faturamento específico, serão enviadas notificações de extrato de remessa.

Limites

Veja abaixo alguns exemplos com vários limites. Um limite transacional é quando a transação começa ou é confirmada. O carimbo de data/hora da contabilidade é quando o Google registrou essa transação. Um limite de declaração de remessa começa às 00:00:00.000 e termina às 23:59:59.000.

Transação dentro dos limites

Evento
Capturar requestHeader.requestId
001

requestHeader.requestTimestamp
01/01/2017 23:26:32.253

responseHeader.responseTimestamp
01/01/2017 23:26:34.248

accounting/20121/201.26
RemittanceStatementNotification requestHeader.requestTimestamp
01/03/2017 03:17:18.132


billingPeriod.startDate
01/01/2017 00:00:00.000

billingPeriod.endDate
Esta notificação 01/01/2019 23:59.

ultrapassar os limites da transação

Uma das capturas abaixo tem todos os carimbos de data/hora de 01/01/2017, mas não é contabilizado até 02/01/2017.

Evento
Capturar requestHeader.requestId
001

requestHeader.requestTimestamp
01/01/2017 23:26:32.253

responseHeader.responseTimestamp
01/01/2017 23:26:34.248

accounting/20121/201.26
Capturar requestHeader.requestId
002

requestHeader.requestTimestamp
01/01/2017 23:59:58.253

responseHeader.responseTimestamp
01/01/2017 23:59:59.800

accounting202020
01.0/carimbo de data/hora da conta
RemittanceStatementNotification requestHeader.requestTimestamp
01/03/2017 03:17:18.132

billingPeriod.startDate
01/01/2017 00:00:00.000


billingPeriod.endDate
Esta notificação
01/01/2019 mitance 23:59 inclui apenas a notificação 23:59.
RemittanceStatementNotification requestHeader.requestTimestamp
01/03/2017 00:27:34.321

billingPeriod.startDate
01/02/2017 00:00:00.000

billingPeriod.endDate
Essa notificação inclui 01/02/2019 23.59.

Como 002 foi contabilizado em 02/01/2017, não em 01/01/2017.

Reconciliação.

Pode haver casos em que o Google envie uma declaração de remessa mais tarde do que o esperado. Por exemplo, se o Google encontrar um bug que atrasa a notificação do extrato de remessa em um dia.

Se houver transações retornadas pelo método remittanceStatementDetails que o integrador não tiver dentro do período de faturamento, ele precisará notificar o Google sobre a discrepância imediatamente. Outra possibilidade seria se houver transações que o integrador espera, mas não sejam retornadas. Assim que a discrepância for resolvida, o Google poderá enviar uma nova fatura com um novo ID.

Aceitação da declaração de remessa

O integrador vai aceitar uma instrução quando ele chamar o método acceptRemittanceStatement.

Os extratos devem ser pagos dentro dos termos NET definidos no contrato após a aceitação. As disputas devem ser tratadas manualmente entre o integrador e o gerente de contas.

Pagamento

Os extratos de remessa fornecem os detalhes necessários sobre o valor a ser pago. Cada extrato deve ser pago integralmente. Se houver uma disparidade, o integrador precisará entrar em contato com o gerente de contas para lidar com a disputa. Esses casos podem resultar no não pagamento de uma fatura integral.

Precisão

Cada taxa será calculada com a precisão definida como o número de unidades secundárias especificado no padrão ISO 4217 para essa moeda. Por exemplo, INR e USD usará unidades secundárias de 2 dígitos e JPY usará unidades secundárias de 0 dígitos.

Se forem necessárias mais casas decimais para representar a taxa, o Google arredondará para a unidade menor mais próxima. Os empates serão arredondados para a menor unidade mais próxima. Por exemplo, usando as unidades secundárias de 2 dígitos da INR:

Taxa calculada Taxa arredondada
0.013 0,01
0,015 0,02
0,025 0,02
-0.013 -0,01
-0,025 -0,02

Esse arredondamento vai acontecer em todas as transações, não de maneira agregada no extrato.