- Pautas de integración
- Características soportadas (métodos de pago)
- Aplicación Pay by Bank
Aplicación Pay by Bank
La aplicación Pay by Bank es un método de pago disponible para los pagadores en el Reino Unido, que les permite usar su aplicación bancaria en su teléfono inteligente para pagar productos y servicios sin tener que descargar ninguna otra aplicación. Los pagadores tienen una visibilidad completa de su saldo bancario durante las transacciones y la tranquilidad de que sus transacciones se autorizarán y se llevarán a cabo en un entorno seguro y fiable de su aplicación bancaria móvil. Puesto que utiliza Faster Payment Service, la aplicación Pay by Bank ofrece pagos y liquidación casi en tiempo real junto con los siguientes beneficios:
- Reducción de la fricción y el abandono, lo que ayuda a aumentar los ingresos
- Reducción de las disputas con clientes, lo que podría generar una disminución de los costos
- Potencial de reducir el fraude
- Preparación para PSD2, SCS y otros requisitos reglamentarios
La aplicación Pay by Bank admite actualmente transacciones y liquidaciones solo en moneda GBP.
Prerrequisitos
Antes de comenzar a integrar la aplicación Pay by Bank en su entorno, asegúrese de haber:
- Registrado su cuenta de negocio con el agregador local del método de pago.
- Vinculado una cuenta bancaria en moneda GBP con su cuenta de negocio ya registrada con el agregador local de pagos.
- Configurado su perfil del negocio en el motor de pagos usando los detalles de la cuenta proporcionados por el agregador local del método de pago.
Integración de la Aplicación Pay by Bank
Además de los campos estándar necesarios en una solicitud de pago mediante explorador, debe proporcionar los siguientes campos en la solicitud Initiate Browser Payment para el procesamiento de pagos de la aplicación Pay by Bank.
sourceOfFunds.type= pbbaapioperation= PAY (la operación Authorize no es compatible con aplicación Pay by Bank)sourceOfFunds.provided.pbba.returnUrl= la dirección URL de la aplicación de negocio a la que se redirige al pagador desde su aplicación móvil
Para la integración en el motor de pagos para usar la aplicación Pay by Bank, inicie una solicitud Pay y proporcione los campos siguientes:
| Campo de solicitud | Obligatorio | Tipo | Descripción |
|---|---|---|---|
sourceOfFunds.type |
No | Cadena | Establece el valor en Pay by Bank App. |
sourceOfFunds.provided.pbba |
No | Cadena | Detalles adicionales del método de pago con Aplicación Pay by Bank. |
sourceOfFunds.provided.pbba.returnUrl |
No | Cadena | La URL de su aplicación a la que se redirige al pagador desde su aplicación bancaria móvil. |
PAY de la API de servicios web
{
"apiOperation": "PAY",
"order": {
"amount": "45.46",
"currency": "GBP" },
"sourceOfFunds": {
"provided": {
"pbba": {
"returnUrl": "<URL_of_merchant_app>"
}
},
"type": "PBBA"
},
"transaction": {
"source": "INTERNET"
}
}
Parámetros de respuesta
| Parámetro de respuesta | Descripción |
|---|---|
sourceOfFunds.provided.pbba.paymentRequestId |
Identificador único de solicitud de pago de 18 caracteres, que también se conoce como token seguro de la aplicación Pay by Bank. Se utiliza cuando se invoca la aplicación bancaria del pagador en su dispositivo móvil durante la experiencia de compra. |
sourceOfFunds.provided.pbba.paymentRequestInputCode |
Código de 6 caracteres de un solo uso que identifica la solicitud de pago, que también se conoce como el número de referencia de la canasta de la aplicación Pay by Bank. El pagador puede usar este código para confirmar el pago dentro de su aplicación bancaria móvil. |
{
"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"
}
Códigos de respuesta de transacción
La tabla siguiente muestra los códigos de respuesta de la transacción para los posibles escenarios que puede encontrarse después de iniciar un pago mediante la aplicación Pay by Bank.
| Respuesta de Initiate Browser Payment | Qué significa esto... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirigir al pagador utilizando la URL proporcionada en la respuesta. |
| Respuesta de Retrieve Transaction | Qué significa esto... |
response.gatewayCode=APPROVEDresult=SUCCESS |
El pago se realizó correctamente. |
response.gatewayCode=PENDINGresult=PENDING |
El motor de pagos está esperando una notificación del adquirente sobre el resultado del pago. Pruebe RETRIEVE_TRANSACTION nuevamente más tarde o escuche las notificaciones del motor de pagos. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
El pago fue rechazado. Ofrezca al pagador la opción de probar otro método de pago. En caso de un ACQUIRER_SYSTEM_ERROR, puede consultar con el adquirente el motivo del error del pago, o bien puede intentar RETRIEVE_TRANSACTION de nuevo. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Trate esto como un pago rechazado. El motor de pagos hará todo lo posible para asegurarse de que la transacción no se pudo realizar o revertirá la transacción. |
Reembolsos
La aplicación Pay by Bank admite pagos de reembolso total o parcial. Debe estar configurado para reembolsos en el CommWeb payment gateway y en su cuenta de negocio con su agregador de métodos de pago local.
Prueba de la integración de la aplicación Pay by Bank
Para probar la integración de la aplicación Pay by Bank, debe tener acceso a Bank3App, que es una aplicación de demostración utilizada con fines de prueba.
Siga estos pasos para obtener acceso e instalar Bank3App.
- Envíe un correo electrónico a integrations@ppro.com para solicitar acceso a Bank3App, que es la aplicación de demostración de la aplicación Pay by Bank.
Asegúrese de que la dirección de correo electrónico que utilice para registrarse sea la dirección de correo electrónico de su empresa. Las direcciones de correo electrónico personales no están permitidas por razones de seguridad. El servicio de atención al cliente de VL del equipo de atención al cliente de Zapp comparte los detalles de instalación de la aplicación a través de un correo electrónico. Si su organización ha bloqueado este ID de correo electrónico, revise su carpeta de correo no deseado.
- Siga las instrucciones facilitadas en el correo electrónico para instalar Bank3App.
- Regístrese con su ID de correo electrónico, preferiblemente el ID corporativo, e inicie sesión en la aplicación.
- Abra la aplicación Pay by Bank e ingrese su PIN de inicio de sesión.
Prueba de la integración de la aplicación Pay by Bank desde el mismo dispositivo móvil
Puede probar la integración de la aplicación Pay by Bank cuando tanto Bank3App como la aplicación estén en el mismo dispositivo móvil.
Siga estos pasos para probar la integración de la aplicación Pay by Bank desde el mismo dispositivo móvil.
- Toque la dirección URL zapp://paymentRequestId en el explorador móvil o dentro de la aplicación móvil.
- Siga las instrucciones para iniciar sesión en Bank3App con su PIN o TouchID.
- Seleccione una cuenta ficticia para completar el pago.
Se le redirigirá a merchantredirecturl en un explorador.
Prueba de la integración de la aplicación Pay by Bank desde un dispositivo móvil distinto
Puede probar la integración de la aplicación Pay by Bank aunque Bank3App y la aplicación estén en dispositivos móviles diferentes.
Sigua estos pasos para probar la integración de la aplicación Pay by Bank desde un dispositivo móvil distinto.
- En Bank3App, toque el logotipo de la aplicación Pay by Bank en esquina inferior derecha de la pantalla y escriba el código de seis caracteres devuelto en paymentRequestInputCode.
- Seleccione una cuenta bancaria ficticia y luego toque Confirm payment (Confirmar pago).
La página alojada del agregador de métodos de pago local redirige a la dirección URL definida en merchantredirecturl.