- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos con Multibanco
Multibanco
Multibanco es un método de pago que se utiliza en Portugal. Multibanco permite a los consumidores pagar diversos bienes o servicios que incluyen comercio electrónico, licencias e impuestos, ya sea mediante transferencia bancaria o mediante la tarjeta Multibanco en un cajero automático.
Multibanco es un método de pago mediante explorador compatible en el Mastercard Gateway. Esta página describe los detalles de la integración específicos de Multibanco. Se recomienda leer las pautas de integración para pagos mediante explorador antes de crear la integración de Multibanco.
Los pagos mediante explorador de Multibanco solo se admiten para transacciones en la moneda EUR.
Prerrequisitos
Para ofrecer Multibanco como un método de pago mediante Mastercard Gateway:
- usted debe estar registrado con su proveedor de servicios de pago mediante explorador;
- su perfil de negocio en el motor de pagos 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 Multibanco
La integración de Hosted Checkout le permite recopilar detalles de pago del pagador a través de una interacción que el motor de pagos hospeda y muestra.
Desde la API versión 65 en adelante, Multibanco 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 Multibanco en su propia página de pago.
Realice una solicitud Initiate Browser Payment donde sourceOfFunds.type = MULTIBANCO y browserPayment.operation = PAY (Multibanco no admite la operación Authorize). Para los campos estándar, consulte Pagos mediante explorador a través de la integración de Direct Payment.
Los siguientes campos se devuelven en la respuesta Initiate Browser Payment/Retrieve Transaction/Retrieve Order después de iniciar un pago con Multibanco.
sourceOfFunds.provided.multibanco.entityId: su identificador de negocio en Multibanco.sourceOfFunds.provided.multibanco.paymentReference: identificador para el pago con Multibanco.
Debe proporcionar estos campos a su pagador para completar el pago.
Idioma preferido
Para configurar el idioma que prefiere que Multibanco 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 Multibanco lo admite.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"MULTIBANCO"
}
}
Cómo interpretar el resultado de la transacción
La tabla siguiente muestra los códigos de respuesta de transacción para los posibles escenarios que puede encontrar después de iniciar un pago con Multibanco.
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=SUCCESSsourceOfFunds.provided.multibanco.terminalLocationsourceOfFunds.provided.multibanco.terminalId |
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 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 tratará de asegurarse de que la transacción no se puede realizar o revertirá la transacción. |
Prueba de su integración
El Mastercard Gateway proporciona un emulador de pagos mediante explorador que le permite probar su integración con Multibanco.