post
https://devapi.forpayservices.cl/white/label/installments
Create Installments
Qué hace
Crea cuotas/cargos asociados a un mandato, para mandatos DYNAMIC.
Cuándo usarlo
Usalo cuando el comercio crea cuotas despues de haber creado el mandato o necesita cargar nuevos cobros bajo un compromiso existente.
Endpoint
POST /installments
Autenticación
Requiere x-api-key y Authorization: Bearer <JWT>, salvo endpoints publicos de autenticacion o contratos de webhook receptor del cliente.
Campos principales
| Campo | Uso |
|---|---|
customer.userId o customer.internalUserId | Cliente propietario del mandato. |
product.id o product.internalId | Mandato/deuda padre de las cuotas. |
installmentsNumber | Cantidad de cuotas enviadas. |
installments[].id | ID externo unico de cada cuota. |
installments[].amount | Monto de la cuota. |
installments[].installmentDueDate | Fecha de vencimiento YYYY-MM-DD. |
installments[].currencyId | Moneda de la cuota. |
Variantes soportadas
- Creacion usando IDs externos del comercio.
- Creacion usando IDs internos Forpay.
Reglas de negocio
- Cada cuota debe tener un identificador externo unico por comercio/mandato.
- Los montos y moneda deben ser consistentes con el mandato.
- No crees cuotas duplicadas para el mismo cobro.
- En
customeryproduct, informa exactamente uno de los identificadores admitidos por cada objeto. - Las monedas públicas disponibles son
UFyPESOS.
Respuesta exitosa
Retorna confirmacion de creacion y datos de las cuotas aceptadas.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Callback