I pagamenti di reindirizzamento possono essere disposti in due modi diversi:
Quando l'utente seleziona "Reindirizza pagamento", verrà reindirizzato alla sito web dell'integratore per selezionare la forma di pagamento da utilizzare. In questo nel caso in cui, il campo
noFopChosen
verrà compilato nella richiesta. In questi casi, l'integratore mostrerà all'utente un elenco di emittenti disponibili. Una volta seleziona una di queste opzioni, l'utente verrà inoltrato alla pagina sito web/app per completare l'acquisto.L'utente selezionerà una forma di pagamento (emittente) durante il flusso di acquisto. In questo caso, Google compilerà i campi
issuerId
nella richiesta e reindirizzare l'utente all'integratore. Quando l'integratore riceve questo messaggio, deve reindirizzare immediatamente l'utente alla sito web/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 Google.
L'integratore deve implementare un protocollo HTTPS utilizzando GET. I parametri GET, descritto in Parametri delle richieste di reindirizzamento, contengono informazioni sul pagamento di reindirizzamento richiesto.
L'integratore deve supportare URL di lunghezza pari a 2048 caratteri. È incluso il schema, host, porta, percorso e parametri. Per tutti i parametri viene utilizzata la codifica UTF-8 prima di essere codificato nell'URL.
Richiesta di reindirizzamento
Di seguito è riportato un esempio di URL a cui l'utente viene reindirizzato come parte della Avvia flusso di reindirizzamento (nota 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 richiesta di reindirizzamento
La richiesta GET HTTPS deve avere i seguenti parametri di query:
Campi | |
---|---|
callbackUrl
|
string
URL a cui reindirizzare l'utente quando viene completato un pagamento. Questo valore è codificato nell'URL e ha una lunghezza massima di 512 caratteri.
Questo URL includerà il |
redirectRequest
|
RedirectRequest
REQUIRED: |