put
https://devapi.forpayservices.cl/white/label/installments/status/change
Update Installments
Qué hace
Actualiza estado de cuotas, por ejemplo marcarlas como pagadas o anuladas, usando IDs externos o internos segun el ejemplo.
Cuándo usarlo
Usalo cuando un evento externo o conciliacion confirma que una cuota cambio de estado y Forpay debe reflejarlo.
Endpoint
PUT /installments/status/change
Autenticación
Requiere x-api-key y Authorization: Bearer <JWT>, salvo endpoints publicos de autenticacion o contratos de webhook receptor del cliente.
Campos principales para probar en OpenAPI
| Campo | Uso |
|---|---|
product.id o product.internalId | Mandato/deuda padre. |
installments.ids o installments.internalIds | Cuotas a actualizar. |
action | Accion/estado objetivo segun el contrato, por ejemplo pago o anulacion. |
payment | Datos del pago cuando se marca como pagada. |
Variantes soportadas
- Marcar cuotas como pagadas usando IDs externos.
- Marcar cuotas como pagadas usando IDs internos.
- Marcar cuotas como anuladas/canceladas usando IDs externos.
- Marcar cuotas como anuladas/canceladas usando IDs internos.
Reglas de negocio
- La cuota debe pertenecer al mandato y comercio autenticado.
- Para pagos, informa fecha, monto, moneda y autorizacion cuando el contrato lo requiera.
- No marques como pagada una cuota sin evidencia de pago/conciliacion.
Respuesta exitosa
Retorna confirmacion del cambio de estado. Valida el resultado con GET /receivables si necesitas conciliacion.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…