Además de los pagos exitosos, Forpay notifica al paymentWebhook cuando un cobro queda en estado intermedio (en proceso, en validación, reversado, etc.).
Pago en proceso de cobro
Cuando la transacción fue enviada al banco o al procesador de pagos pero aún no se confirma el resultado, installment.state.id = 9.
{
"installment": {
"state": {
"id": 9,
"name": "EN PROCESO DE COBRO"
},
"description": "En confirmacion banco."
}
}Importante: Si recibes un estado
EN PROCESO DE COBRO, espera la notificación posterior de confirmación con estadoPAGADA(id: 2) oRECHAZADA(id: -99). No marques la cuota como pagada hasta recibir la confirmación final.
Tabla de estados de cuota
installment.state.id | Nombre | Descripción |
|---|---|---|
| 1 | PENDIENTE | Cuota generada, a la espera de su fecha de cobro |
| 2 | PAGADA | Cobro realizado con éxito. Incluye payment con authorizationCode |
| 6 | ANULADA | La cuota fue invalidada |
| 9 | EN PROCESO DE COBRO | Transacción enviada al procesador, sin confirmación aún |
| 10 | REPACTADA | La deuda fue movida a un nuevo compromiso |
| 11 | FINALIZADA | Proceso de cobro concluido |
| 12 | REVERSADA | El pago fue devuelto al cliente |
| 15 | EN VALIDACIÓN | Esperando confirmación externa de éxito |
| -99 | RECHAZADA | Cobro fallido. No se incluye el objeto payment |
Nota HMAC para pagos no exitosos
Para cualquier estado que no sea id: 2 (PAGADA), los campos del objeto payment no se concatenan al calcular la firma HMAC. Ver Verificación HMAC.

