Pagamenti standard di Google:

Forma di reindirizzamento

Panoramica

Google Standard Payments supporta le forme di pagamento (FOP) basate sul reindirizzamento. Una forma di pagamento di reindirizzamento consente agli utenti di prodotti o servizi Google di pagarli nell'interfaccia web di un'entità esterna. A livello generale, un utente che vuole pagare per dei beni viene inizialmente reindirizzato a un integratore dei pagamenti o a un emittente disponibile tramite un integratore di pagamenti. Se l'utente viene reindirizzato all'integratore, quest'ultimo deve inoltrarlo all'interfaccia web dell'emittente per completare l'acquisto. Una volta completato il pagamento, l'utente deve essere reindirizzato a Google tramite l'integratore.

Google utilizza due flussi principali per completare un pagamento per la forma di pagamento di reindirizzamento:

  1. Avvia reindirizzamento: esistono due flussi diversi che possono avviare un pagamento di reindirizzamento. L'integratore dei pagamenti deve implementare solo una di queste opzioni:
  2. Flusso di reindirizzamento completo: una volta che l'utente completa l'acquisto, l'integratore utilizza questo flusso per confermare il pagamento con Google.

Infine, tutti i movimenti di denaro tra la banca dell'integratore e la banca di Google avvengono nel flusso di pagamento.

Panoramica della forma di pagamento Reindirizzamento

La figura seguente illustra un'ampia panoramica dei flussi:

Diagramma panoramica della forma di pagamento di reindirizzamento

A livello generale, l'aggiunta del tuo servizio come forma di pagamento ai prodotti Google prevede i seguenti flussi:

  1. Avvia reindirizzamento:
  2. Flusso di reindirizzamento completo
  3. Procedura di rimborso
  4. Flusso di pagamento

Concetti e terminologia

Simboli e convenzioni

Le parole chiave "DEVE", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" e "OPTIONAL" in questi documenti devono essere interpretate come descritto nel documento RFC 2119.

Timestamp

Tutti i timestamp sono rappresentati in millisecondi dall'epoca Unix (1 gennaio 1970) nel fuso orario UTC.

Ad esempio:

  • 23 aprile 2019 20:23:25 GMT = 1556051005000 millisecondi
  • 16 agosto 2018 12:28:35 GMT = 1534422515000 millisecondi

Importi

I valori monetari in questa API sono in un formato chiamato "micros", uno standard di Google. I micro sono un formato a precisione fissa basato su numeri interi. Per rappresentare un valore monetario in micro, moltiplica il valore della valuta standard per 1.000.000.

Ad esempio:

  • 1,23 USD = 1230000 micro USD
  • 0,01$= 10.000 micro USD

Idempotenza

Tutte le chiamate al metodo all'interno di questa API devono avere un comportamento idempotente. sporadicamente Google riproverà le richieste per garantire che le transazioni siano nello stesso stato su entrambi i lati. Gli integratori non devono tentare di rielaborare le richieste già elaborate correttamente. La risposta per l'elaborazione corretta dovrebbe essere invece registrata. Tutti i metodi hanno un RequestHeader comune che contiene un requestId. Questo requestId è la chiave di idempotenza per tutte le chiamate.

Qualsiasi risposta non terminale (un errore HTTP 200 con esito positivo) non deve essere elaborata in modo idempotente. Pertanto, una richiesta che in precedenza riceveva un valore 400 (precondizione errata/non valida), quando chiamata una seconda volta, non deve restituire idempotentemente 400, deve essere rivalutata. Al momento della nuova valutazione, potrebbe restituire un valore 400 o essere elaborato correttamente.

Per ulteriori informazioni sull'idempotenza, consulta questa guida dettagliata.

Integratore

Una società che utilizza la piattaforma di pagamento di Google per la propria attività. Può essere un'azienda interna (1P), come YouTube o AdWords, o anche un'attività esterna (3P) che vuole integrare il proprio servizio per funzionare con l'ecosistema di Google.

FOP

Forma di pagamento. Questa procedura è più generica rispetto a uno strumento. Visa, MasterCard e PayPal sono tutte forme di pagamento.

Strumento

Un caso particolare di una forma di pagamento da parte di un cliente specifico. ad esempio la carta di credito di un utente o l'account PayPal. Anche una forma di pagamento tokenizzata per un determinato cliente è uno strumento, perché è un'istanza di una forma di pagamento per quel cliente, memorizzata in modo sicuro nel nostro sistema.

Token

Una rappresentazione, sul sistema di Google, del metodo di pagamento di un utente specifico. Poiché contiene tutte le informazioni necessarie per effettuare un acquisto, anche il token è uno strumento. Ciò può includere informazioni quali il numero di account che un utente ha presso il suo integratore.

Flussi principali

Inizia flusso di reindirizzamento

Il primo passaggio in un pagamento di reindirizzamento è il flusso Inizia reindirizzamento. Lo scopo del flusso Inizia reindirizzamento è reindirizzare l'utente, tramite l'integratore, all'interfaccia web dell'emittente scelto, in modo che possa autorizzare un pagamento. Al momento del reindirizzamento, Google fornisce informazioni di base sulla transazione all'integratore, che a sua volta le inoltra all'emittente.

Per ulteriori informazioni, consulta la sezione Inizio del flusso di reindirizzamento.

Flusso di reindirizzamento completo

Una volta che l'utente si trova nell'interfaccia web dell'emittente, dovrebbe eseguire tutti i passaggi necessari per completare un pagamento (questi passaggi possono variare a seconda dell'emittente). Nell'ambito del flusso di reindirizzamento completo, l'emittente deve reindirizzare l'utente all'integratore con informazioni sul pagamento andato a buon fine. L'integratore, a sua volta, reindirizza l'utente a Google, includendo i dettagli di pagamento nella risposta di reindirizzamento. Una volta confermato il pagamento, Google fornirà i beni o i servizi acquistati all'utente.

Per ulteriori informazioni, consulta la sezione Flusso di reindirizzamento completo.