Diccionarios de Referencia

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)

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)

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 objeto payment completo en el webhook. Para todos los demás estados, el objeto payment está ausente y los campos de pago no se consideran en la firma HMAC.

---

3. Estados de Compromisos (product.state.id)

Indica la situación global del mandato o suscripción del cliente.

ID	Estado	Descripción
1	ACTIVA / AUTOMATIZADA	El compromiso está activado con un medio de pago automático.
2	PAGADA	Todas las cuotas del compromiso han sido completadas, aplica en suscripciones y planes de pago.
3	ELIMINADA	El compromiso fue borrado del sistema.
4	REPACTADA	Las condiciones originales fueron modificadas, aplica solo para planes de pago no modificados por API.
5	POSTERGADA	El compormiso de pago está pausado temporalmente.
6	ANULADA	El compromiso fue anulado definitivamente.
7	PENDIENTE DE ANULACIÓN	Solicitud de baja en solicitada por el cliente.
8	INACTIVA / NO AUTOMATIZADA	El compromiso ha sido creado pero no tiene un medio de pago automático.
9	RECHAZADA	El compromiso de pago fue rechazado por el cliente.
10	FINALIZADA	El compromiso fue finalizado anticipadamente.
11	EN CONFIRMACIÓN BANCO	Esperando validación del mandato PAC 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 estado 11 puede recibirse en activaciones EPAC/Fintoc mientras el banco confirma el mandato PAC.

---

4. Tipos de Cuenta (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)

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 campo payment.convert informa la conversión utilizada al momento del cobro efectivo, incluyendo el valor de la divisa en pesos y la fecha de conversión aplicada.