Multibanco es un método de pago alternativo exclusivo de Portugal que ofrecemos a través de SIBS, el cual permite realizar pagos en un cajero automático o a través de la aplicación móvil del banco en la que el usuario indica la referencia que ha obtenido durante el proceso de pago.

Existen dos formas de integrarlo: mediante redirección o pago push.

Integración mediante redirección

Para integrarlo mediante redirección, el usuario deberá estar presente en el momento del pago, el cual deberá procesarse a través de un navegador. En primer lugar debemos generar una orden de pago.

Como identificador de servicio, debe indicarse el service_uuid del servicio de SIBS que tengas activado en tu Backend de Paylands → Administrar → Servicios de pago → Listado.

Una vez generada la orden, se debe redirigir al usuario a la pantalla de pago indicando el token de la orden y en la query, el nombre del APM:

Construimos la URL de redirección reemplazando el token por el valor devuelto en la llamada anterior.

https://api.paylands.com/v1/sandbox/payment/process/{token}?apm=MULTIBANCO

Una vez el usuario sea redirigido a esta pantalla, podrá visualizar la referencia que deberá introducir a través de la aplicación móvil de su banco o físicamente a través de un cajero automático. Cuando complete el pago, será redirigido de vuelta a la URL OK o KO, dependiendo del resultado del pago.

Integración mediante pago push

Si el comercio prefiere hacer llegar la referencia al usuario por otro canal distinto al navegador, es posible integrar el método de pago push, el cual devolverá la referencia al servidor para que ésta pueda ser enviada al usuario.

Para ello, en primer lugar debemos generar una orden de pago.

A continuación, se debe lanzar la petición del pago push indicando el UUID de la orden. La respuesta contendrá la referencia del pago y fecha límite para pagar. Estos campos se incluyen dentro de la transacción del pago, en el campo payment_data. A continuación se incluye un ejemplo:

"payment_data": {
    "entity": "81921",
    "reference": "800133222",
    "deadline": "2024-04-28"
}

Una vez se complete el pago, el comercio recibirá la notificación del pago a la URL indicada en el campo url_post al generar la orden de pago.

Pruebas

Para más información sobre cómo probar este método de pago en cada uno de sus proveedores, visitar la documentación de SIBS.

Campos personalizados

Por defecto no se envía una fecha de expiración. Si se quiere personalizar este valor, basta con añadir la siguiente información cuando se genera la orden de pago indicando con la fecha deseada en formato Y-m-d:

"extra_data": {
    "payment": {
        "deadline": "2024-05-20"
    }
}