Come utilizzare Apple 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 APAY per abilitare Apple Pay come metodo di pagamento:

"poiInfo": {
    "pitype": "APAY"
}

Per completare l'integrazione, è necessario:

1. Per l'integrazione in modalità diretta con Apple Pay, il merchant deve prima implementare le API di Apple seguendo le specifiche ufficiali disponibili all'indirizzo: https://developer.apple.com/documentation/ApplePayontheWeb
2. Una volta completato il flusso di integrazione con Apple, il merchant riceverà un payload JSON cifrato
3. Questo payload cifrato deve essere trasmesso nel campo payload sotto parametro pi come mostrato nell'esempio

Esempio

"pi": {
    "payload": "
    {
        'token':{
            'paymentData':{
                'version':'EC_v1',
                'data':'m6jCgrMa0ZIBR4/CgRcCuh[...]HTtR',
                'signature':'MIAGCSqGSIb3DQEHA[...]N2+nx+VdMwlwIcvaAAAAAAAA',
                'header':{
                    'ephemeralPublicKey':'MFkwEwYHKoZIzj0CAQYIK...BTX/Bvpg==',
                    'publicKeyHash':'OyxkZBtLI0xwS9flwFNfiPoQfOwzv5Ht7Q0tMv/0rlU=',
                    'transactionId':'2766eb624aeb2cbd0a89516268c73417fc71bb7eae50c3fefaeede91947c8984'
                }
            },
            'paymentMethod':{
                'displayName':'MasterCard 1471',
                'network':'MasterCard',
                'type':'debit'
            },
            'transactionIdentifier':'2766EB624AEB2CBD0A89516268C73417FC71BB7EAE50C3FEFAEEDE91947C8984'
        }
    } "
}

Flusso di Pagamento

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

Requisiti

• Account merchant abilitato da gestore
• Valore pitype impostato su APAY
• Integrazione API Apple Pay
• Valore payload impostato con payload Apple Pay