> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# El objeto Payment Intent

El objeto `PaymentIntent` representa un único pago de tu cliente a tu cuenta. El campo `payment_type` identifica el método de pago, como `bank_transfer`, `card`, `installment` o `cash`. El objeto aparece cuando creas un pago y en los eventos webhook de pagos. También aparece como el `payment_resource` de una `CheckoutSession` después de que tu cliente paga, y el campo `status` registra el pago hasta que finaliza.

La siguiente tabla describe los atributos de `PaymentIntent`:

| Atributo               | Tipo              | Descripción                                                                                                                                                                                                                                                                                                                                          |
| :--------------------- | :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                   | `string`          | Identificador único del Payment Intent.                                                                                                                                                                                                                                                                                                              |
| `object`               | `string`          | Tipo de objeto. Siempre es `payment_intent`.                                                                                                                                                                                                                                                                                                         |
| `amount`               | `integer`         | Monto a pagar en la unidad mínima de `currency`. Debe ser mayor que `0`. `CLP` no tiene unidad menor, por lo que `5000` representa `$5000 CLP`; para `MXN`, `5000` representa `$50.00 MXN`.                                                                                                                                                          |
| `business_profile`     | `object` o `null` | Negocio que recibe el pago cuando cobras en nombre de un subcomercio. Es `null` cuando no se proporciona. Consulta [el objeto Business Profile](#el-objeto-business-profile-dentro-del-objeto-payment-intent) más abajo.                                                                                                                             |
| `created_at`           | `string`          | Fecha y hora ISO 8601 en UTC de creación del Payment Intent.                                                                                                                                                                                                                                                                                         |
| `currency`             | `string`          | Código de moneda ISO 4217 de tres letras, en mayúsculas. Uno de `CLP` o `MXN`.                                                                                                                                                                                                                                                                       |
| `customer`             | `object` o `null` | [`Customer`](/es/api/payments-api/customers/customer-object) asociado al Payment Intent. Es `null` cuando no hay un cliente asociado.                                                                                                                                                                                                                |
| `customer_email`       | `string` o `null` | Correo electrónico de tu cliente, usado para las notificaciones de reembolso. Es `null` cuando no se proporciona. Fintoc no envía correos electrónicos de reembolso sin `customer_email`.                                                                                                                                                            |
| `error_reason`         | `string` o `null` | Código de error que explica por qué falló el Payment Intent. Es `null` cuando el pago no ha fallado. Consulta [Payment Intent Error Reason](/es/api/payments-api/payment-intents/payment-intent-error-reason) para ver la lista de motivos de error.                                                                                                 |
| `expires_at`           | `string` o `null` | Fecha y hora ISO 8601 en UTC de expiración del Payment Intent. Es `null` cuando el Payment Intent no expira.                                                                                                                                                                                                                                         |
| `metadata`             | `object`          | Conjunto de pares [clave-valor](/es/api/fintoc-api/metadata) que puedes adjuntar al Payment Intent. Usa estos pares para almacenar información estructurada adicional.                                                                                                                                                                               |
| `mode`                 | `string`          | Entorno que produjo el objeto. `live` usa datos reales de instituciones y `test` usa datos ficticios para probar la integración.                                                                                                                                                                                                                     |
| `next_action`          | `object` o `null` | Acción que tu cliente debe completar para que el pago continúe, como confirmarlo en una aplicación bancaria. La clave `type` identifica la acción. Es `null` cuando no hay acciones pendientes.                                                                                                                                                      |
| `payment_method`       | `string` o `null` | Identificador único del método de pago guardado que pagó el Payment Intent. Es `null` cuando ningún método de pago guardado pagó el Payment Intent.                                                                                                                                                                                                  |
| `payment_type`         | `string`          | Método de pago que produjo este Payment Intent. Uno de `bank_transfer`, `cash`, `card`, `installment` o `pac` (cargo bancario automático recurrente). También puede ser un identificador de redirección externa específico del proveedor, como `banco_estado`.                                                                                       |
| `payment_type_options` | `object`          | Opciones adicionales específicas de `payment_type`. Es un objeto vacío cuando `payment_type` no tiene opciones adicionales.                                                                                                                                                                                                                          |
| `recipient_account`    | `object` o `null` | Cuenta que recibe el pago. Es `null` cuando `payment_type` no es `bank_transfer`. Consulta [los objetos Recipient Account y Sender Account](#los-objetos-recipient-account-y-sender-account-dentro-del-objeto-payment-intent) más abajo.                                                                                                             |
| `reference_id`         | `string` o `null` | Número de operación del banco de la cuenta de origen. Es `null` mientras el banco confirma el pago o cuando tu cliente abandona el pago antes de recibir un número de operación.                                                                                                                                                                     |
| `sender_account`       | `object` o `null` | Cuenta que envía el pago, o `null` cuando `payment_type` no es `bank_transfer`. También es `null` cuando tu cliente abandona el pago antes de elegir una cuenta de origen. Consulta [los objetos Recipient Account y Sender Account](#los-objetos-recipient-account-y-sender-account-dentro-del-objeto-payment-intent) más abajo.                    |
| `status`               | `string`          | Estado del pago. Los valores posibles son `created` (no iniciado), `in_progress` (en proceso), `succeeded` (completado) y `failed` (no completado). También puede ser `pending` (en espera de confirmación), `requires_action` (en espera de la acción indicada en `next_action`), `expired` (expiró antes de completarse) o `rejected` (rechazado). |
| `subscription`         | `string` o `null` | Identificador único de la suscripción que generó este Payment Intent. Es `null` cuando el pago no forma parte de una suscripción.                                                                                                                                                                                                                    |
| `transaction_date`     | `string` o `null` | Fecha y hora ISO 8601 en UTC en que el banco autorizó la transacción. Es `null` cuando tu cliente abandona el pago antes de transferir.                                                                                                                                                                                                              |
| `widget_token`         | `string` o `null` | Token temporal para configurar el widget. La API devuelve este token solo cuando creas el Payment Intent; después, el valor es `null`.                                                                                                                                                                                                               |

El siguiente ejemplo muestra un objeto `PaymentIntent`:

```json Payment Intent Object theme={null}
{
  "id": "pi_BO381oEATXonG6bj",
  "object": "payment_intent",
  "amount": 1000,
  "business_profile": {
    "category": "009613",
    "name": "Test Business 1",
    "tax_id": "000000000"
  },
  "created_at": "2021-10-15T15:23:11.474Z",
  "currency": "CLP",
  "customer": null,
  "customer_email": "customer@example.com",
  "error_reason": null,
  "expires_at": null,
  "metadata": {},
  "mode": "live",
  "next_action": null,
  "payment_method": null,
  "payment_type": "bank_transfer",
  "payment_type_options": {},
  "recipient_account": {
    "holder_id": "000000001",
    "institution_id": "cl_banco_de_chile",
    "number": "000000",
    "type": "checking_account"
  },
  "reference_id": "90123712",
  "sender_account": {
    "holder_id": "000000002",
    "institution_id": "cl_banco_estado",
    "number": "000000",
    "type": "checking_account"
  },
  "status": "created",
  "subscription": null,
  "transaction_date": "2021-10-15T15:24:15.474Z",
  "widget_token": "pi_BO381oEATXonG6bj_sec_a4xK32BanKWYn"
}
```

## Los objetos Recipient Account y Sender Account (dentro del objeto Payment Intent)

Estos objetos describen las cuentas bancarias de cada lado de una transferencia. El campo `recipient_account` contiene la cuenta que recibe los fondos. El campo `sender_account` contiene la cuenta de tu cliente. Estos campos solo se aplican cuando `payment_type` es `bank_transfer`; en los demás casos, ambos campos son `null`.

La siguiente tabla describe ambos objetos de cuenta:

| Atributo         | Tipo     | Descripción                                                                                                                                                                                                                                            |
| :--------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `holder_id`      | `string` | Identificador tributario del titular de la cuenta. En Chile, este valor es un identificador tributario chileno (RUT). En México, es un identificador tributario mexicano (RFC) o una Clave Única de Registro de Población (CURP).                      |
| `institution_id` | `string` | `id` de la institución de la cuenta. Consulta [Países e instituciones para iniciar pagos](/es/guides/payments/overview-payment-initiation/payment-initiation-countries-and-institutions) para ver las instituciones disponibles y sus valores de `id`. |
| `number`         | `string` | Número de cuenta. No incluye guiones ni ceros como prefijo.                                                                                                                                                                                            |
| `type`           | `string` | Clasificación de la cuenta bancaria. Uno de `checking_account` o `sight_account`.                                                                                                                                                                      |

## El objeto Business Profile (dentro del objeto Payment Intent)

El campo `business_profile` describe el negocio que recibe el pago cuando cobras en nombre de un subcomercio.

La siguiente tabla describe los atributos de `business_profile`:

| Atributo   | Tipo     | Descripción                                                                                                                                                                                       |
| :--------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `category` | `string` | Identificador de categoría del subcomercio. En Chile, este valor es un [código de actividad económica](https://www.sii.cl/ayudas/ayudas_por_servicios/1956-codigos-1959.html) de seis caracteres. |
| `name`     | `string` | Nombre del comercio inscrito. Fintoc muestra este valor como "Destinatario" en la pantalla de pago exitoso cuando proporcionas un nombre.                                                         |
| `tax_id`   | `string` | Identificador tributario del comercio inscrito. En Chile, es un RUT. En México, es un RFC o una CURP.                                                                                             |
