Passa al contenuto principale

Come utilizzare Google Pay con integrazione diretta

Abilitazione del Servizio​

Questa modalità di pagamento necessita dell'abilitazione da parte di gestore per poter essere utilizzata. In caso contrario, il metodo di pagamento non sarà disponibile e il sistema restituirà l'errore IGFS_20001.

Configurazione API​

Per eseguire pagamenti diretti utilizzando metodi di pagamento alternativi alla carta di credito, il commerciante invia la richiesta di pagamento al gateway IGFS, utilizzando il servizio di pagamento diretto:

{{endpoint}}/pgw/payment/auth

Il messaggio richiede proprietà aggiuntive a seconda dello strumento di pagamento.

Nel parametro pitype occorre inserire il valore GPAY per abilitare Google Pay come metodo di pagamento:

"poiInfo": {
    "pitype": "GPAY"
}

Per completare l'integrazione, è necessario:

  1. Per l'integrazione in modalità diretta con Google Pay, il merchant deve prima implementare le API di Google seguendo le specifiche ufficiali disponibili all'indirizzo: https://developers.google.com/pay/api
  2. Nell'integrazione Google deve essere valorizzato il parametro gateway = netsgroup

Esempio configurazione Google​

"tokenizationSpecification": {
    "type": "PAYMENT_GATEWAY",
    "parameters": {
      "gateway": "netsgroup",
      "gatewayMerchantId": "merchantId rilasciato da Google"
    }
}
  1. Una volta completato il flusso di integrazione con Google, il merchant riceverà un payload JSON cifrato
  2. Questo payload cifrato deve essere trasmesso nel campo payload sotto parametro pi come mostrato nell'esempio

Esempio payload​

"pi": {
    "payload": "
        {
            'signature':'MEUCIBYWlxUS/jYfkZP2kGzFnpUuiqku+GO0tTt71+VfiQ+LAiEA+36AXPV...',
            'intermediateSigningKey':{
                'signedKey':'{
                    'keyValue':'MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgA...',
                    'keyExpiration':'1581601197323'
                }',
                'signatures':[
                    'MEUCIQDFjLOZb2pMKpgif7lc2Edxsc5DkWnmyYT/qaX0q0DieAIgBMlXm9fFg...'
                ]
            },
            'protocolVersion':'ECv2',
            'signedMessage':'{
                'encryptedMessage':'EBcm+jRxy+qfEPulT69QN90/vQu3Q2UgyM/...',
                'ephemeralPublicKey':'BPKr7Okrk7NRTSz1Gsrl...',
                'tag':'dgPiu0UtDL/xzpxxFvFuC+3xmmJ8Is5x3pkonu...'
            }'
        }
    "
}

Flusso di Pagamento​

Una volta configurato correttamente il campo, il cliente verrà automaticamente reindirizzato alla pagina di pagamento Google Pay dove potrà completare la transazione utilizzando il proprio wallet.

Requisiti​

  • Account merchant abilitato da gestore
  • Valore pitype impostato su GPAY
  • Integrazione API Google Pay
  • Valore payload impostato con payload Google Pay