I pagamenti di reindirizzamento possono essere avviati in due modi diversi:
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.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 |
redirectRequest
|
RedirectRequest
OBBLIGATORIO: |