Inizia flusso di reindirizzamento

I pagamenti di reindirizzamento possono essere avviati in due modi diversi:

  1. Quando l'utente seleziona "Reindirizza pagamento", verrà reindirizzato al sito web dell'integratore per selezionare la forma di pagamento (FOP) da utilizzare. In questo caso, noFopChosen verrà completato nella richiesta. In questo caso, l'integratore mostrerà all'utente un elenco degli emittenti disponibili. Dopo che l'utente ne avrà selezionato una, verrà indirizzato al sito web/all'app dell'emittente per completare l'acquisto.

  2. L'utente seleziona una forma di pagamento (emittente) durante il flusso di acquisto. In questo caso, Google completerà il parametro issuerId nella richiesta e reindirizzerà l'utente all'integratore. Quando l'integratore lo riceve, deve reindirizzare immediatamente l'utente al sito web/all'app dell'emittente per completare l'acquisto.

In entrambi i casi precedenti, Google reindirizzerà l'utente direttamente al sito web dell'integratore senza alcuna precedente chiamata server-server da parte di Google.

L'integratore deve implementare un protocollo HTTPS utilizzando GET. I parametri GET, descritti in Parametri richiesta di reindirizzamento, conterranno informazioni sul pagamento di reindirizzamento richiesto.

L'integratore deve supportare URL di lunghezza pari a 2048 caratteri. Sono inclusi schema, host, porta, percorso e parametri. Prima della codifica URL, tutti i parametri avranno la codifica UTF-8.

Richiesta di reindirizzamento

Di seguito è riportato un esempio dell'URL a cui viene reindirizzato l'utente nell'ambito del flusso Inizia reindirizzamento (noto anche come richiesta di reindirizzamento):

https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H

Il valore decodificato nell'URL del parametro callbackUrl in questo esempio è:

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE

Il parametro redirectRequest viene criptato e firmato utilizzando PGP o JWE+JWS prima di essere codificato in base64url.

Parametri delle richieste di reindirizzamento

La richiesta HTTPS GET deve avere i seguenti parametri di query:

Campi
callbackUrl string

URL a cui reindirizzare l'utente al termine del pagamento. Questo valore è codificato nell'URL e ha una lunghezza massima di 512 caratteri.

Questo URL includerà il requestId dell'elemento criptato redirectRequest nel parametro GET redirectRequestId. Il fornitore deve convalidare che i valori redirectRequestId di callbackUrl e requestId del payload criptato siano identici per verificare che entrambi siano correlati.

redirectRequest RedirectRequest

OBBLIGATORIO: RedirectRequest deve essere criptato e firmato utilizzando PGP o JWE+JWS. Inoltre, questo valore deve essere sicuro per il web con la codifica base64.