Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
L'app Pay by Bank è una modalità di pagamento disponibile per i paganti nel Regno Unito che consente di utilizzare l'app bancaria sul proprio smartphone per pagare beni e servizi senza scaricare alcuna applicazione. I paganti hanno completa visibilità del proprio saldo bancario durante le transazioni e la tranquillità che le transazioni saranno autorizzate e completate in un ambiente sicuro e affidabile della loro app di mobile banking. Utilizzando il servizio Faster Payment, l'app Pay by Bank offre pagamenti e trasferimento fondi quasi in tempo reale con i seguenti vantaggi:
L'app Pay by Bank supporta transazioni e trasferimento fondi solo in valuta GBP.
Prima di iniziare a integrare l'app Pay by Bank nel proprio ambiente, assicurarsi di:
Per l'elaborazione dei pagamenti tramite l'app Pay by Bank, in una richiesta di pagamento tramite browser, oltre ai campi standard obbligatori, è necessario fornire i seguenti campi nella richiesta Initiate Browser Payment
.
sourceOfFunds.type
= pbbaapioperation
= PAY (l'operazione Authorize non è supportata dall'app Pay by Bank).sourceOfFunds.provided.pbba.returnUrl
= L'URL dell'app dell'esercente a cui viene reindirizzato il pagante dalla sua app di mobile banking.Per l'integrazione con il gateway al fine di utilizzare l'app Pay by Bank, avviare una richiesta Pay
e fornire i seguenti campi:
Campo della richiesta | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
sourceOfFunds.type |
No | Stringa | Impostare il valore su Pay by Bank App . |
sourceOfFunds.provided.pbba |
No | Stringa | Ulteriori dettagli per la modalità di pagamento con l'app Pay by Bank. |
sourceOfFunds.provided.pbba.returnUrl |
No | Stringa | L'URL dell'app dell'esercente a cui viene reindirizzato il pagante dalla sua app di mobile banking. |
PAY
dell'API WS{ "apiOperation": "PAY", "order": { "amount": "45.46", "currency": "GBP" }, "sourceOfFunds": { "provided": { "pbba": { "returnUrl": "<URL_of_merchant_app>" } }, "type": "PBBA" }, "transaction": { "source": "INTERNET" } }
Parametro della risposta | Descrizione |
---|---|
sourceOfFunds.provided.pbba.paymentRequestId |
Un identificativo univoco della richiesta di pagamento di 18 caratteri, noto anche come token sicuro dell'app Pay by Bank. Viene utilizzato quando l'app bancaria del pagante viene richiamata sul suo dispositivo mobile durante l'esperienza di acquisto. |
sourceOfFunds.provided.pbba.paymentRequestInputCode |
Un codice una tantum di 6 caratteri che identifica la richiesta di pagamento, noto anche come numero di riferimento basket dell'app Pay by Bank. Questo codice può essere utilizzato dal pagante per confermare il pagamento nella propria app di mobile banking. |
{ "gatewayEntryPoint": "WEB_SERVICES_API", "merchant": "PBBA_MER_2", "order": { "amount": 45.46, "chargeback": { "amount": 0, "currency": "GBP" }, "creationTime": "2019-09-17T11:19:34.813Z", "currency": "GBP", "fundingStatus": "IN_PROGRESS", "id": "13347", "status": "INITIATED", "totalAuthorizedAmount": 0, "totalCapturedAmount": 0, "totalRefundedAmount": 0 }, "response": { "acquirerCode": "PENDING", "gatewayCode": "SUBMITTED" }, "result": "SUCCESS", "sourceOfFunds": { "provided": { "pbba": { "paymentRequestId": "120191291357676444", "paymentRequestInputCode": "PLJGLW" } }, "type": "PBBA" }, "timeOfRecord": "2019-09-17T11:19:34.813Z", "transaction": { "acquirer": { "id": "PBBA_PPRO", "merchantId": "MPGTESTCONTRACT", "timeZone": "+0000", "transactionId": "509260333" }, "amount": 45.46, "currency": "GBP", "funding": { "status": "IN_PROGRESS" }, "id": "1", "source": "INTERNET", "type": "PAYMENT" }, "version": "54" }
Nella tabella che segue sono illustrati i possibili scenari per i codici di risposta della transazione restituiti dopo l'avvio di un pagamento tramite app Pay by Bank.
Risposta Initiate Browser Payment | Cosa significa... |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Reindirizzare il pagante utilizzando l'URL fornito nella risposta. |
Risposta Retrieve Transaction | Cosa significa... |
response.gatewayCode=APPROVED result=SUCCESS |
Il pagamento è avvenuto correttamente. |
response.gatewayCode= PENDING result=PENDING |
Il gateway sta aspettando una notifica dall'acquirer sul risultato del pagamento. Riprovare RETRIEVE_TRANSACTION più tardi o controllare le notifiche del gateway. |
response.gatewayCode= DECLINED or ACQUIRER_SYSTEM_ERROR result=FAILURE |
Il pagamento è stato rifiutato. Offrire al pagante la possibilità di provare ad utilizzare un'altra modalità di pagamento. In presenza di un ACQUIRER_SYSTEM_ERROR è possibile richiedere all'acquirer il motivo dell'esito negativo del pagamento, oppure riprovare RETRIEVE_TRANSACTION . |
response.gatewayCode=TIMED_OUT result=FAILURE |
Considerare questo pagamento come rifiutato. Il gateway tenterà in ogni modo di garantire che la transazione non abbia esito positivo o revocherà la transazione. |
L'app Pay by Bank supporta pagamenti con rimborso totale o parziale. È necessario essere configurati per i rimborsi sul Mastercard Gateway e sul proprio conto esercente con il proprio aggregatore locale di modalità di pagamento.
Per testare l'integrazione dell'app Pay by Bank, è necessario avere accesso a Bank3App, un'applicazione demo utilizzata a scopo di test.
Seguire questi passaggi per ottenere l'accesso e installare Bank3App.
Accertarsi che l'indirizzo e-mail utilizzato per la registrazione sia l'indirizzo e-mail della propria azienda. Gli indirizzi e-mail personali non sono consentiti per motivi di sicurezza. L'assistenza clienti VL del team di assistenza clienti Zapp condivide i dettagli di installazione dell'applicazione tramite e-mail. Se la propria organizzazione ha bloccato questo ID di posta elettronica, controllare la cartella della posta indesiderata.
È possibile testare l'integrazione dell'app Pay by Bank quando sia Bank3App che l'app sono presenti sullo stesso dispositivo mobile.
Seguire questi passaggi per testare l'integrazione dell'app Pay by Bank dallo stesso dispositivo mobile.
Si viene reindirizzati al merchantredirecturl
in un browser.
È possibile testare l'integrazione dell'app Pay by Bank anche se Bank3App e l'applicazione si trovano su dispositivi mobili diversi.
Seguire questi passaggi per testare l'integrazione dell'app Pay by Bank da un dispositivo mobile diverso.
La pagina locale ospitata dall'aggregatore di modalità di pagamento reindirizza all'URL impostato merchantredirecturl
.