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 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` 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 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 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 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 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:

Payment Intent Object

{
  "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 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 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.

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

El objeto Payment Intent

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

El objeto Business Profile (dentro del objeto Payment Intent)

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

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

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

El objeto Business Profile (dentro del objeto Payment Intent)