Panoramica
La forma di pagamento tokenizzata può supportare il caso d'uso dei numeri di riferimento. Un utente che vuole pagare per i beni genera un numero di riferimento tramite l'integratore dei pagamenti. L'utente porta poi questo numero di riferimento a un minimarket, un chiosco o una banca e paga questo numero.
Cash FOP supporta anche il caso d'uso dei numeri di riferimento. La principale differenza tra la forma di pagamento tokenizzata e la forma di pagamento in contanti è che la forma di pagamento tokenizzata richiede l'associazione e supporta i rimborsi, mentre la forma di pagamento contanti non richiede l'associazione e non supporta i rimborsi. Questo documento descrive il funzionamento dell'integrazione per il caso d'uso del numero di riferimento.
A livello generale, l'integrazione coinvolge i seguenti flussi:
- Flusso di autenticazione
- Flusso di associazione
- Flusso di acquisto (come per la forma di pagamento contante)
- Procedura di rimborso
- Flusso di pagamento
Il flusso di acquisto sarà uguale al flusso di acquisto della forma di pagamento in contanti.
Esempio di un'integrazione che utilizza l'autenticazione del reindirizzamento web.
API correlate
Flusso di autenticazione
API implementata dall'integratore: Web Authentication (Autenticazione web).
Procedura di associazione
API implementata dall'integratore: associateAccount nell'API Payment Integrator Hosted Tokenized FOP.
Flusso di acquisto
API implementata dall'integratore: generateReferenceNumber e cancelReferenceNumber nell'API Payment Integrator Hosted Tokenized FOP.
API implementata da Google: referenceNumberPaidNotification sull'API FOP tokenizzata in hosting su Google.
Flusso di rimborso
API implementata dall'integratore: refund sull'API Payment Integrator Hosted Tokenized FOP.
Flusso di versamento
API implementata dall'integratore: vedi Payment Integrator Hosted Remittance API.
API implementata da Google: consulta la pagina relativa all'API Hosted Remittance di Google.
Come si integrano tutti i flussi
Crea strumento
Nella UI di Google, un utente viene reindirizzato a una pagina web ospitata dall'integratore per eseguire l'autenticazione web. Dopo l'autenticazione, l'utente viene reindirizzato a Google. Google chiamerà associateAccount. requestId
in authenticationResponse
sarà il authenticationRequestId
della richiesta associateAccount. Dopo l'associazione, Google archivia googlePaymentToken
(GPT) e altri metadati come strumento per l'utente.
Crea strumento - Flusso di autenticazione
Crea strumento - Flusso di associazione
Genera numero di riferimento
Quando l'utente vuole acquistare beni/servizi con lo strumento, Google chiama generateReferenceNumber con GPT. Il requestId
nell'intestazione della richiesta generateReferenceNumber verrà utilizzato per identificare la transazione per le API correlate.
Numero di riferimento del pagamento
Dopo che l'utente ha pagato il numero di riferimento offline, l'integratore chiamerà referenceNumberPaidNotification. Il requestId
nell'intestazione della richiesta generateReferenceNumber sarà il valore generateReferenceNumberRequestId
di referenceNumberPaidNotification.
Annullare una transazione
Se l'utente decide di annullare la transazione prima del pagamento, Google chiamerà cancelReferenceNumber. Il requestId
nell'intestazione della richiesta generateReferenceNumber sarà il valore generateReferenceNumberRequestId
di cancelReferenceNumber.
Rimborsare una transazione
Se l'utente vuole un rimborso dopo il pagamento del numero di riferimento, Google chiamerà refund. Il requestId
nell'intestazione della richiesta generateReferenceNumber sarà il valore transactionId
di refund.
Versamento
In base al contratto, Google chiamerà remittanceStatementNotification per informare l'integratore quando l'estratto conto sarà pronto. Quindi, l'integratore chiamerà l'API Hosted Remittance di Google per eseguire la riconciliazione.