- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos con Bancontact
Bancontact
Bancontact es un método de pago por transferencia bancaria en línea en tiempo real con sede en Bélgica. Bancontact es un método de pago mediante explorador admitido en el Mastercard Gateway. Esta página describe los detalles de la integración específicos de Bancontact.
Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de Bancontact.
Los pagos mediante explorador de Bancontact solo se admiten para transacciones en la moneda EUR.
Prerrequisitos
Para ofrecer Bancontact como un método de pago mediante el Mastercard Gateway:
- usted debe estar registrado con su proveedor de servicios de pago mediante explorador;
- su perfil de negocio en el Mastercard Gateway se debe configurar usando los detalles de su cuenta con el proveedor de servicios de pago mediante explorador; y
- debe tener una cuenta bancaria, en una de las monedas soportadas, registrada en su cuenta de negocio en su proveedor de servicios de pago mediante explorador.
Integración de Bancontact
La integración de Hosted Checkout le permite recopilar detalles de pago del pagador a través de una interacción que se hospeda y se muestra en Mastercard Gateway.
Desde la API versión 65 en adelante, Bancontact está disponible automáticamente como método de pago una vez que your payment service provider lo habilita y configura para este método de pago.
Para conocer más detalles, consulte Pagos mediante explorador a través de la integración de Hosted Checkout.
La integración de Direct Payment le permite ofrecer el método de pago de Bancontact en su propia página de pago.
Además de los campos estándar que son necesarios en una solicitud de pago mediante explorador, proporcione los siguientes campos en la solicitud Initiate Browser Payment:
Campos comunes
sourceOfFunds.type=BANCONTACTbrowserPayment.operation=PAY (Bancontact does not support the Authorize operation)customer.email=Email address of a payersourceOfFunds.provided.bancontact.bankAccountHolder= el nombre del titular de la cuenta bancaria para la cuenta bancaria del pagador
Idioma preferido
Para configurar el idioma que prefiere que Bancontact utilice para las páginas que se muestran al pagador, complete el campo browserPayment.preferredLanguage en la solicitud de Initiate Browser Payment. Sin embargo, el idioma se usará solo si Bancontact lo admite.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"BANCONTACT",
"provided":{
"bancontact":{
"bankAccountHolder":"George Smith"
}
}
}
}
Cómo interpretar el resultado de la transacción
En esta tabla se especifican los códigos de respuesta de la transacción para los posibles escenarios que puede encontrarse después de iniciar un pago mediante Bancontact.
| 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/Retrieve Order | Qué significa esto... |
response.gatewayCode=APPROVEDresult=SUCCESS |
El pago se realizó correctamente. |
response.gatewayCode=PENDINGresult=PENDING |
Mastercard Gateway está esperando una notificación del adquirente sobre el resultado del pago. Pruebe RETRIEVE_TRANSACTION nuevamente más tarde o escuche las notificaciones de Mastercard Gateway. |
response.gatewayCode=CANCELLEDresult=FAILURE |
El pagador canceló la interacción para este pago. Ofrezca al pagador la opción de probar otro método de pago. |
response.gatewayCode=DECLINED o 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 Mastercard Gateway hará lo posible para asegurarse de que la transacción no se puede realizar o revertirá la transacción. |
Reembolsos
Puede reembolsar los pagos de Bancontact en un número de pagos o el total. Asegúrese de estar configurado para reembolsos en el Mastercard Gateway en su cuenta de negocio en su proveedor de servicios de pagos mediante explorador.
Prueba de su integración
El Mastercard Gateway proporciona un emulador de pagos mediante explorador que le permite probar su integración con Bancontact.