Pay by Bank App
Pay by Bank App est une méthode de paiement disponible pour les payeurs du Royaume-Uni, leur permettant d'utiliser leur application bancaire sur leur smartphone pour payer des biens et des services sans avoir à télécharger d'application. Les payeurs ont une visibilité complète de leur solde bancaire au cours des transactions et ont l'esprit tranquille sachant que leurs transactions seront autorisées et effectuées dans un environnement sécurisé et de confiance sur leur application mobile. En utilisant la fonction Faster Payment Service, Pay by Bank App propose des paiements et des règlements presqu'en temps réel, avec les avantages suivants :
- Réduction des frictions et des abandons pouvant contribuer à augmenter les revenus
- Réduction des litiges avec les clients pouvant entraîner une réduction des coûts
- Réduction des fraudes potentielles
- Conformité avec les normes PSD2, SCS et autres exigences réglementaires
Pay by Bank App ne prend actuellement en charge que les transactions et règlements en GBP.
Conditions préalables
Avant de commencer à intégrer Pay by Bank App à votre environnement, assurez-vous d'avoir au préalable :
- Enregistré votre compte commerçant avec votre agrégateur de méthode de paiement local.
- Un compte bancaire en devise GBP associé à votre compte commerçant enregistré auprès de votre agrégateur de paiement local.
- Configuré votre profil de commerçant de la passerelle en utilisant les détails du compte fournis par votre agrégateur de méthodes de paiement local.
Intégration de la méthode Pay by Bank App
En plus des champs standard requis dans une demande de paiement avec redirection, vous devez renseigner les champs suivants dans la demande Initiate Browser Payment (Lancer un paiement avec redirection) pour le traitement des paiements Pay by Bank App.
sourceOfFunds.type= pbbaapioperation= PAY (l'opération Authorize (Autoriser) n'est pas prise en charge par Pay by Bank App)sourceOfFunds.provided.pbba.returnUrl= URL de l'application du commerçant vers laquelle le payeur est redirigé depuis son application mobile.
Pour l'intégration de la passerelle pour une utilisation de Pay by Bank App, initiez une demande Pay (Payer) et renseignez les champs suivants :
| Champ de demande | Obligatoire | Type | Description |
|---|---|---|---|
sourceOfFunds.type |
Non | Chaîne | Définissez la valeur sur Pay by Bank App. |
sourceOfFunds.provided.pbba |
Non | Chaîne | Détails supplémentaires pour la méthode de paiement Pay by Bank App. |
sourceOfFunds.provided.pbba.returnUrl |
Non | Chaîne | URL de votre application vers laquelle le payeur est redirigé depuis son application bancaire mobile. |
PAY
{
"apiOperation": "PAY",
"order": {
"amount": "45.46",
"currency": "GBP" },
"sourceOfFunds": {
"provided": {
"pbba": {
"returnUrl": "<URL_of_merchant_app>"
}
},
"type": "PBBA"
},
"transaction": {
"source": "INTERNET"
}
}
Paramètres de la réponse
| Paramètre de la réponse | Description |
|---|---|
sourceOfFunds.provided.pbba.paymentRequestId |
Identifiant unique de demande de paiement à 18 caractères, également appelé jeton sécurisé Pay by Bank App. Utilisé lors de l'appel de l'application bancaire du payeur sur son appareil mobile au cours de l'expérience d'achat. |
sourceOfFunds.provided.pbba.paymentRequestInputCode |
Code unique à 6 caractères identifiant la demande de paiement, également appelé numéro de référence du panier Pay by Bank App. Ce code peut être utilisé par le payeur pour confirmer le paiement sur son application bancaire mobile. |
{
"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"
}
Codes de réponse de transaction
Le tableau ci-dessous illustre les codes de réponse de transaction pour les scénarios possibles auxquels vous pouvez devoir faire face après avoir initié un paiement Pay By Bank App.
| Réponse Initiate Browser Payment (Lancer un paiement avec redirection) | Qu'est-ce que cela signifie... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirigez le payeur en utilisant l'URL indiquée dans la réponse. |
| Réponse Retrieve Transaction (Extraire la transaction) | Qu'est-ce que cela signifie... |
response.gatewayCode=APPROVEDresult=SUCCESS |
Le paiement a réussi. |
response.gatewayCode=PENDINGresult=PENDING |
La passerelle attend une notification de l'acquéreur à propos du résultat du paiement. Réessayez la transaction RETRIEVE_TRANSACTION plus tard ou surveillez les notifications de la passerelle. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer une autre méthode de paiement. Dans le cas d'une erreur ACQUIRER_SYSTEM_ERROR, vous pouvez vouloir demander à l'acquéreur la raison de l'échec du paiement, ou vous pouvez réessayer la transaction RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Traitez cela comme un paiement refusé. La passerelle vérifiera que la transaction a échoué ou l'annulera. |
Remboursements
Pay By Bank App prend en charge les remboursements complets ou partiels. Vous devez être configuré pour les remboursements sur Mastercard Gateway et, sur votre compte commerçant, avec l'agrégateur de méthode de paiement local.
Tester votre intégration Pay By Bank App
Pour tester l'intégration Pay By Bank App, vous devez avoir accès à Bank3App, qui est une application de démonstration utilisée à des fins de test.
Suivez ces étapes pour accéder et installer Bank3App.
- Envoyez un e-mail à integrations@ppro.com pour demander l'accès à Bank3App, qui est l'application de démonstration Pay by Bank App.
Assurez-vous que l'adresse e-mail que vous utilisez pour l'enregistrement est l'adresse e-mail de votre entreprise. Vos adresses e-mail personnelles ne sont pas autorisées pour des raisons de sécurité. Le support client VL de l'équipe de support client Zapp partage les détails d'installation de l'application par e-mail. Si votre organisation a bloqué cet identifiant de messagerie, vérifiez le dossier des indésirables.
- Suivez les instructions fournies dans l'e-mail pour installer Bank3App.
- Enregistrez-vous avec votre identifiant de messagerie, de préférence un identifiant d'entreprise et connectez-vous à l'application.
- Ouvrez l'application Pay by Bank et entrez votre code PIN de connexion.
Tester l'intégration Pay by Bank App depuis le même appareil mobile
Vous pouvez tester l'intégration Pay by Bank App lorsque Bank3App et l'application se trouvent sur le même appareil mobile.
Suivez ces étapes pour tester l'intégration Pay by Bank App à partir du même appareil mobile.
- Touchez l'URL zapp://paymentRequestId sur un navigateur mobile ou dans l'application mobile.
- Suivez les instructions pour vous connecter à Bank3App à l'aide de votre code PIN ou TouchID.
- Sélectionnez un compte fictif pour effectuer le paiement.
Vous êtes redirigé vers merchantredirecturl dans un navigateur.
Tester l'intégration Pay by Bank App depuis un appareil mobile différent
Vous pouvez tester l'intégration Pay by Bank App même si Bank3App et l'application se trouvent sur des appareils mobiles différents.
Suivez ces étapes pour tester l'intégration Pay by Bank App à partir d'un appareil mobile différent.
- Dans Bank3App, touchez le logo Pay by Bank App dans l'angle inférieur droit de l'écran et entrez le code à six caractères renvoyé dans paymentRequestInputCode.
- Sélectionnez un compte bancaire fictif, puis touchez Confirmer le paiement.
La page hébergée par l'agrégateur de méthodes de paiement locales redirige vers l'URL définie dans le champ merchantredirecturl.