Creation Dynamic Mandate

Qué hace

Crea un mandato/deuda de tipo DYNAMIC. Este producto permite crear cuotas iniciales o cargar cuotas posteriormente mediante POST /installments.

Cuándo usarlo

Usalo cuando el comercio administra compromisos flexibles, cuotas bajo demanda o planes donde las cuotas se crean desde la integracion.

Endpoint

POST /mandate

Autenticación

Requiere x-api-key y Authorization: Bearer <JWT>, salvo endpoints publicos de autenticacion o contratos de webhook receptor del cliente.

Headers requeridos

• country, commerce, channel: contexto comercial autorizado.
• requestDateTime: fecha/hora ISO 8601.
• correlationId: UUID unico para trazabilidad.
• processId y salesExecutiveId: contexto funcional/comercial cuando aplique.

Campos principales para probar en OpenAPI

Variantes soportadas

• Cliente por customer.userId externo.
• Cliente por customer.internalUserId interno Forpay.
• Creacion con bloque signature cuando se requiere iniciar firma junto con el mandato.

Reglas de negocio

• Para este endpoint documentado como Dynamic, usa mandate.type=DYNAMIC.
• mandate.id debe ser unico por comercio.
• needPayNow normalmente debe ser false salvo flujos acordados de cobro inmediato.
• Si incluyes installments, cada cuota debe tener ID externo unico.

Respuesta exitosa

Retorna una respuesta de creacion con IDs internos/externos del cliente y mandato. Guarda estos IDs para busqueda, actualizacion, cancelacion y conciliacion.

Ejemplo recomendado

Usa el ejemplo JSON precargado en OpenAPI como base. Cambia customer, mandate.id, fechas, montos, paymentMethods y URLs antes de ejecutar.