Para nuevas integraciones, crea los mandatos con el encabezado processId: HYBRID y utiliza el Magic Link que devuelve la operación para conducir al cliente al flujo correspondiente.
Creación y Magic Link
La solicitud de creación utiliza POST /mandate, relativo a la URL base del ambiente. Incluye los encabezados indicados en la ficha del producto. En una creación normal sin firma, la respuesta incluye el enlace en payload.activation.url.
Tu sistema puede presentar ese enlace al cliente para que abra el flujo de Forpay. La acción disponible depende del producto: los mandatos recurrentes permiten inscribir un medio de pago y el Botón de Pago conduce a un pago puntual. Consulta el flujo de integración y el ejemplo del producto que utilizas.
Correo al cliente
El envío de correo y la generación del enlace son pasos distintos. En el flujo predeterminado de HYBRID, Forpay intenta enviar el correo de alta cuando la configuración de notificaciones del comercio lo permite. Obtener una respuesta de creación exitosa o recibir un enlace no confirma que el correo haya sido entregado.
Coordina con Forpay qué comunicaciones están habilitadas para tu comercio. Tu integración debe conservar el enlace recibido y no depender exclusivamente del correo para mostrar al cliente cómo continuar.
Retorno y notificaciones
| Campo de la solicitud | Para qué se utiliza |
|---|---|
urls.callback | URL de retorno para la navegación del cliente. No sustituye una notificación de estado. |
urls.activationWebhook | Receptor de eventos de activación o anulación, según los eventos habilitados para el comercio. |
urls.paymentWebhook | Receptor de los eventos de pago o intento de cobro que correspondan al medio y estén habilitados para el comercio. |
Implementa los receptores siguiendo la guía de webhooks. Valida la firma de cada evento y utiliza las consultas de estado para conciliar la información de tu sistema.