Payment Intent representa una transacción de pago en la API de Fintoc, con los detalles del estado del pago, los montos y las cuentas involucradas.
{
"id": "pi_BO381oEATXonG6bj",
"object": "payment_intent",
"amount": 1000,
"created_at": "2021-10-15T15:23:11.474Z",
"currency": "CLP",
"customer_email": "felipe@example.com",
"error_reason": null,
"metadata": {},
"mode": "live",
"recipient_account": {
"holder_id": "183917137",
"number": "123456",
"type": "checking_account",
"institution_id": "cl_banco_de_chile"
},
"reference_id": "90123712",
"sender_account": {
"holder_id": "192769065",
"number": "123456",
"type": "checking_account",
"institution_id": "cl_banco_estado"
},
"status": "created",
"transaction_date": "2021-10-15T15:24:15.474Z",
"widget_token": "pi_BO381oEATXonG6bj_sec_a4xK32BanKWYn"
}
| Atributo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del Payment Intent. |
object | string | Identificador del tipo de objeto. Su valor para los Payment Intents siempre corresponderá a payment_intent. |
amount | integer | Monto a pagar, representado como un entero. Este valor siempre debe ser mayor que 0. |
business_profile | hash | Objeto opcional para identificar a múltiples comercios inscritos para precios basados en categoría. |
created_at | string | Fecha de creación del Payment Intent, en formato ISO 8601. |
currency | string | Código ISO de la moneda. Por ahora solo soporta CLP y MXN. |
customer_email | string | Email del cliente vinculado al Payment Intent para notificaciones de reembolsos. Requerido para el producto de reembolsos; retorna null si no se proporciona. |
error_reason | string | Código de error que explica la falla del Payment Intent, si está disponible. |
metadata | hash | Conjunto de pares clave-valor para almacenar información adicional estructurada. Retorna null si no se proporciona al crearlo. |
mode | string | Indica si el Payment Intent opera en modo live o test. |
recipient_account | object | Objeto que referencia la cuenta de destino. Omítelo al crear el pago cuando uses Fintoc Collects para mayor estabilidad. |
reference_id | string | Número de operación del banco de la cuenta de origen. Puede ser null para confirmaciones diferidas o pagos abandonados. |
sender_account | object | Objeto que referencia la cuenta de origen. Puede ser null si el usuario abandonó el pago antes de especificar un origen. |
status | string | Estado del pago. Puede ser created, in_progress, succeeded, failed, pending, requires_action, expired o rejected. |
transaction_date | string | Fecha de autorización del banco en formato ISO 8601. Puede ser null en las notificaciones de estado final. |
widget_token | string | Token temporal para configurar el widget. Se retorna solo al crear el Payment Intent; después siempre es null. |
Objetos Recipient Account y Sender Account
| Atributo | Tipo | Descripción |
|---|---|---|
holder_id | string | Identificador del titular de la cuenta (RUT en Chile; RFC o CURP en México). |
number | string | Número de cuenta sin guiones ni ceros a la izquierda. |
type | string | Tipo de cuenta: checking_account o sight_account. |
institution_id | string | Identificador de la institución de la cuenta. |
Objeto Business Profile
| Atributo | Tipo | Descripción |
|---|---|---|
category | string | Identificador de la categoría del sub-comercio (código de actividad del SII de 6 caracteres en Chile). |
name | string | Nombre del comercio inscrito. Se muestra como “Destinatario” en la pantalla de pago exitoso. |
tax_id | string | Identificador tributario del comercio inscrito (RUT en Chile). |