Panoramica
Il pagamento avviene quando il denaro viene trasferito da una parte all'altra. Ad esempio, l'invio di denaro dalla banca dell'integratore dei pagamenti alla banca di Google. Il seguente diagramma illustra come accade.
Come funziona il flusso
Il seguente diagramma illustra un esempio di come funziona il flusso di versamenti.
Integratore pagamenti versamenti a Google
Di seguito è riportato un elenco degli oggetti utilizzati in questo diagramma:
- Server Google: il server di backend di Google che esegue il controllo dell'autenticazione, insieme ad altre attività di autenticazione.
- Integratore pagamenti: l'azienda che offre una forma di pagamento ai propri clienti.
- Banca per l'integrazione dei pagamenti: la banca emittente utilizzata dall'integratore per le transazioni finanziarie.
- Banca Google: la banca utilizzata da Google nelle transazioni.
Il flusso di pagamento di cui sopra inizia dal server di Google.
- Ogni T+N giorni, Google invia la notifica di distinta di accompagnamento (
remittanceStatementNotification). - L'integratore dei pagamenti notifica al server Google di aver ricevuto correttamente la notifica dell'estratto conto.
- L'integratore dei pagamenti invia anche i dettagli della distinta di accompagnamento (
remittanceStatementDetails). - Il server di Google risponde con l'istruzione insieme ai dettagli transactionDetails.
- L'integratore dei pagamenti riconcilia i dettagli.
- L'integratore dei pagamenti invia un messaggio (
acceptRemittanceStatement) al server Google che informa che la dichiarazione è stata accettata. - L'integratore dei pagamenti invia anche un messaggio per comunicare che la banca per l'integrazione dei pagamenti deve inviare fondi a Google Bank.
- La banca dell'integratore dei pagamenti trasferisce i fondi a Google Bank.
Best practice e altre considerazioni
Tempi
I termini di pagamento sono indicati nel contratto e generalmente sono espressi in T+N. "T" indica la frequenza con cui viene generata una dichiarazione di versamento e la durata del periodo relativo a ciascuna dichiarazione. Nell'esempio seguente, T corrisponde a un giorno di transazione. N indica il numero di giorni dopo il periodo della transazione in cui arriva l'estratto conto.
Se N è configurato per essere 2 e una transazione viene conteggiata alle 23:59:59.999 nel fuso orario di fatturazione di martedì, verrà visualizzata in un estratto conto il giovedì.
Dichiarazioni negative o nette
Per i giorni in cui non si verificano transazioni nel periodo di fatturazione, le notifiche sull'estratto conto non verranno inviate. Inoltre, se in un periodo di fatturazione vengono effettuati rimborsi che risultano in un importo di fattura negativo netto, non verranno inviati nemmeno gli estratti conto. Queste transazioni verranno tuttavia inserite nella successiva fattura netta positiva, a cui verrà inviata la notifica dell'estratto conto. Nel caso in cui per un determinato periodo di fatturazione la transazione abbia un importo netto pari a 0, verranno inviate notifiche sull'estratto conto.
Confini
Di seguito sono riportati alcuni esempi con diversi limiti. Un confine transazionale è il momento in cui inizia o viene eseguito il commit della transazione. Ricorda che il timestamp di contabilità si riferisce alla data e all'ora in cui Google ha preso in considerazione la transazione. Il limite della dichiarazione di versamento inizia alle ore 00:00:00.000 e termina alle ore 23:59:59.000.
Transazione entro i confini
| Evento | |
|---|---|
| Acquisizione | requestHeader.requestId
001 requestHeader.requestTimestamp 01/01/2017 23:26:32.253 responseHeader.responseTimestamp 01/01/2017 23:26:34.248 accounting timestamp1/32.32:201 |
| RemittanceStatementNotification | requestHeader.requestTimestamp
03/01/2017 03:17:18.132 billingPeriod.startDate 01/01/2017 00:00:00.000 billingPeriod.endDate 01/01/2017 23:59: |
Definizione dei confini delle transazioni
Una delle immagini acquisite di seguito ha tutti i timestamp del 1° gennaio 2017, ma non dell'01/02/2017.
| Evento | |
|---|---|
| Acquisizione | requestHeader.requestId
001 requestHeader.requestTimestamp 01/01/2017 23:26:32.253 responseHeader.responseTimestamp 01/01/2017 23:26:34.248 accounting timestamp1/32.32:201 |
| Acquisizione | requestHeader.requestId
002 requestHeader.requestTimestamp 01/01/2017 23:59:58.253 responseHeader.responseTimestamp 01/01/2017 23:59:59.879 accounting timestamp02/00.02:01/002 |
| RemittanceStatementNotification | requestHeader.requestTimestamp
01/03/2017 03:17:18.132 billingPeriod.startDate 01/01/2017 00:00:00.000 billingPeriod.endDate 01/01/2017 23:59: |
| RemittanceStatementNotification | requestHeader.requestTimestamp
03/01/2017 00:27:34.321 billingPeriod.startDate 02/01/2017 00:00:00.000 billingPeriod.endDate 02/01/2017 23:59: Dal momento che 002 è stato rappresentato per il 01/02/2017, non 01/01/2017. |
Riconciliazione
In alcuni casi, Google invia una distinta di accompagnamento più tardi del previsto. Ad esempio, se Google rileva un bug che ritarda la notifica della dichiarazione di pagamento di un giorno.
Se ci sono transazioni restituite dal metodo remittanceStatementDetails che l'integratore non ha durante il periodo di fatturazione, quest'ultimo deve informare immediatamente Google della discrepanza. Un'altra possibilità potrebbe essere che ci sono transazioni che l'integratore si aspetta ma che non vengono restituite. Una volta risolta una discrepanza, Google potrebbe inviare una nuova distinta di accompagnamento con un nuovo documento di identità.
Accettazione della dichiarazione di versamento
Un'istruzione si dice che sia accettata dall'integratore una volta che l'integratore chiama il metodo acceptRemittanceStatement.
Le dichiarazioni devono essere pagate entro i termini NETTI definiti nel contratto dopo l'accettazione. Le controversie devono essere gestite manualmente tra l'integratore e l'account manager.
Pagamento
Gli estratti conto forniscono i dettagli necessari sull'importo da pagare. Ogni estratto conto deve essere pagato per intero. In caso di disparità, l'integratore deve contattare il proprio account manager per gestire la controversia. In questi casi, è possibile che tu non paghi l'intero estratto conto.
Precisione
Ogni tariffa verrà calcolata alla precisione definita come numero di unità secondarie specificato nello standard ISO 4217 per la valuta in questione. Ad esempio, INR e USD utilizzeranno unità secondarie a 2 cifre e JPY utilizzerà unità secondarie a 0 cifre.
Se sono necessarie più cifre decimali per rappresentare la tariffa, Google lo arrotonderà all'unità secondaria più vicina; i legami verranno arrotondati all'unità minore pari più vicina. Ad esempio, utilizzando le unità secondarie a 2 cifre dell'INR:
| Tariffa calcolata | Tariffa arrotondata |
|---|---|
| 0.013 | 0,01 |
| 0,015 | 0,02 |
| 0,025 | 0,02 |
| -0.013 | -0,01 |
| -0,025 | -0,02 |
Questo arrotondamento verrà applicato a ogni transazione, non in forma aggregata nel riepilogo.