Esta página concentra todos los identificadores (IDs) utilizados en los webhooks y la API de Forpay para clasificar medios de pago, estados de cuotas y estados de compromisos.
1. Métodos de Pago (paymentMethod.id)
paymentMethod.id)Identifica el medio de pago que el cliente utiliza en su compromiso o al realizar un pago. La columna Notificación asociada indica qué página de webhook corresponde a cada método.
| ID | Método de Pago | Procesador / Contexto | Notificación asociada |
|---|---|---|---|
| 1 | Cheque | — | — |
| 2 | Depósito Bancario | — | — |
| 3 | Tarjeta de Crédito | Transbank Oneclick / Getnet | Activación PAT (Tarjetas) · Pago Tarjeta |
| 4 | Tarjeta de Débito | Transbank Oneclick / Getnet | Activación PAT (Tarjetas) · Pago Tarjeta |
| 5 | Débito Directo (PAC) | Fintoc | Activación PAC (Débito Directo) · Pago Débito Directo |
| 6 | Cuenta Bancaria (EPAC / ForPAC) | PAC bancario con documento firmado | Activación PAC (Clave Única) · Pago EPAC |
| 7 | Transferencia | — | — |
| 11 | Tarjeta de Prepago | Transbank Oneclick / Getnet | Activación PAT (Tarjetas) · Pago Tarjeta |
| 12 | TEF (Transferencia Electrónica) | ETPay / EFT | Pago TEF |
| 14 | EPAC Directo | Débito sin firma de documento | Activación PAC (Credenciales Bancarias) · Pago EPAC |
| 15 | PAT Tradicional | Transdata | — |
| 17 | Efectivo | — | — |
2. Estados de Cuotas (installment.state.id)
installment.state.id)Indica la situación actual de una cuota específica dentro del ciclo de cobro.
| ID | Estado | Descripción |
|---|---|---|
| 1 | PENDIENTE | Cuota generada, a la espera de su fecha de cobro |
| 2 | PAGADA | Cobro realizado con éxito. Genera authorizationCode |
| 6 | ANULADA | La cuota fue invalidada antes de ser procesada |
| 9 | EN PROCESO DE COBRO | La transacción fue enviada al procesador de pagos |
| 10 | REPACTADA | La deuda fue movida a un nuevo compromiso o estructura |
| 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 por el procesador de pagos |
Nota: Solo cuando el estado es
2(PAGADA) se incluye el objetopaymentcompleto en el webhook. Para todos los demás estados, el objetopaymentestá ausente y los campos de pago no se consideran en la firma HMAC.
3. Estados de Compromisos (product.state.id)
product.state.id)Indica la situación global del mandato o suscripción del cliente.
| ID | Estado | Descripción |
|---|---|---|
| 1 | ACTIVA | El compromiso está vigente y procesando cobros |
| 2 | PAGADA | Todas las cuotas del compromiso han sido completadas |
| 3 | ELIMINADA | El compromiso fue borrado del sistema |
| 4 | REPACTADA | Las condiciones originales fueron modificadas |
| 5 | POSTERGADA | El calendario de cobros está pausado temporalmente |
| 6 | ANULADA | El compromiso fue cancelado definitivamente |
| 7 | PENDIENTE DE ANULACIÓN | Solicitud de baja en proceso |
| 8 | INACTIVA | El compromiso no está operando |
| 9 | RECHAZADA | La activación no fue aceptada (ej. mandato fallido) |
| 10 | FINALIZADA | Término natural del ciclo del producto |
| 11 | EN CONFIRMACIÓN BANCO | Esperando validación del mandato por parte de la institución bancaria |
Nota: El webhook de activación se envía cuando el mandato pasa al estado
1(ACTIVA). El estado11puede recibirse en activaciones EPAC/Fintoc mientras el banco confirma el mandato PAC.
4. Tipos de Cuenta (paymentMethod.account.type.id)
paymentMethod.account.type.id)Identifica el tipo de cuenta bancaria del cliente.
| ID | Tipo de Cuenta |
|---|---|
| 1 | Cuenta Corriente |
| 2 | Cuenta Vista |
| 3 | Cuenta de Ahorro |
5. Monedas (currency.id)
currency.id)Identifica la moneda en la que se denominan los montos de cuotas y pagos.
| ID | Moneda | Símbolo |
|---|---|---|
| 1 | Peso Chileno | CLP / $ |
| 2 | Unidad de Fomento | UF |
| 3 | Dólar Estadounidense | USD / US$ |
| 4 | Unidad Tributaria Mensual | UTM |
| 5 | Euro | EUR / € |
Nota para monedas no-CLP: Cuando
currency.id ≠ 1, el monto de la cuota está expresado en esa divisa. El campopayment.convertinforma la conversión utilizada al momento del cobro efectivo, incluyendo el valor de la divisa en pesos y la fecha de conversión aplicada.