Objeto Payment method

El objeto Payment Method

El objeto PaymentMethod representa el instrumento de pago almacenado de un customer, que puedes cobrar bajo demanda o asociar a una subscription para pagos recurrentes. Aparece cuando creas un payment method o cuando se completa una CheckoutSession con un flujo setup.

{
  "id": "pm_4324qwkalsds",
  "object": "payment_method",
  "created_at": "2025-07-01T10:00:00.000Z",
  "customer": "cus_456789abcdef",
  "mode": "live",
  "pac": {
    "account_holder_id": "111111111",
    "account_number": "0000000000",
    "account_type": "checking_account",
    "institution": {
      "id": "cl_banco_santander",
      "country": "cl",
      "name": "Banco Santander"
    },
    "status": "active"
  },
  "type": "pac"
}

Objeto base

Atributo	Tipo	Descripción
`id`	`string`	Identificador único del Payment Method.
`object`	`string`	El tipo del objeto, siempre `payment_method`.
`bank_transfer`	`object`	Solo presente cuando `type` es `bank_transfer`. Contiene detalles específicos de un payment method de transferencia bancaria.
`card`	`object`	Solo presente cuando `type` es `card`. Contiene detalles específicos de un payment method de tarjeta.
`created_at`	`string`	Marca de tiempo de creación en formato ISO 8601.
`customer`	`string`	ID del Customer asociado a este payment method.
`mode`	`string`	`live` o `test`
`mx_direct_debit`	`object` o `null`	Solo presente cuando `type` es `mx_direct_debit`. Contiene los términos del mandato de domiciliación bancaria en México. `null` cuando el mandato que respalda el payment method ya no está disponible.
`pac`	`object`	Solo presente cuando `type` es `pac`. Contiene detalles específicos de un payment method de tipo pac.
`type`	`string`	Tipo del payment method. Uno de `bank_transfer`, `card`, `mx_direct_debit` o `pac`. El objeto incluye un campo adicional con un nombre que coincide con este valor (por ejemplo, `card`) con detalles específicos del tipo.

Objeto Pac

Atributo	Tipo	Descripción
`account_holder_id`	`string`	Identificador del titular de la cuenta. En Chile, corresponde a un RUT.
`account_number`	`string`	Número de cuenta. No incluye guiones ni ceros al inicio
`account_type`	`string`	Tipo de cuenta. Uno de `checking_account` o `sight_account`.
`institution`	`object`	Institución financiera asociada al PAC
`status`	`string`	Indica si el pac está disponible para ser cobrado (`active`), esperando confirmación (`pending`) o ya no está disponible (`canceled`).

El objeto Card

El objeto Card contiene los detalles de una tarjeta almacenada. Fintoc lo devuelve en el campo card cuando el type del PaymentMethod es card.

Atributo	Tipo	Descripción
`active`	`boolean`	Indica si la tarjeta se puede cobrar actualmente. Fintoc desactiva automáticamente las tarjetas vencidas.
`brand`	`string`	Marca de la tarjeta. Por ejemplo, `visa` o `mastercard`.
`country`	`string`	Nombre para mostrar del país emisor, en inglés.
`expiration`	`object`	Fecha de vencimiento de la tarjeta con cadenas `month` y `year`. `month` usa dos dígitos y `year` usa cuatro. Ambos valores son `null` para tarjetas inscritas a través de un wallet, porque los wallets no exponen las fechas de vencimiento.
`kind`	`string`	Tipo de tarjeta. Uno de `credit` o `debit`.
`last_four_digits`	`string`	Últimos cuatro dígitos del número de la tarjeta.
`wallet`	`string` o `null`	Wallet usado para inscribir la tarjeta. Uno de `apple_pay` o `null` para tarjetas ingresadas manualmente.

Una tarjeta inscrita a través de un wallet como Apple Pay devuelve apple_pay en wallet y valores null en expiration.month y expiration.year:

Card Payment Method

{
  "id": "pm_4324qwkalsds",
  "object": "payment_method",
  "card": {
    "active": true,
    "brand": "visa",
    "country": "Chile",
    "expiration": {
      "month": null,
      "year": null
    },
    "kind": "credit",
    "last_four_digits": "4242",
    "wallet": "apple_pay"
  },
  "created_at": "2025-07-01T10:00:00.000Z",
  "customer": "cus_456789abcdef",
  "mode": "live",
  "type": "card"
}

El objeto Bank Transfer

El objeto Bank Transfer contiene los detalles de una cuenta bancaria inscrita para pagos por transferencia. Fintoc devuelve el objeto Bank Transfer en el campo bank_transfer cuando el type del PaymentMethod es bank_transfer.

Atributo	Tipo	Descripción
`account_holder_id`	`string`	Identificador tributario del titular de la cuenta. En Chile, un identificador tributario chileno (RUT).
`account_number`	`string`	Número de cuenta. No incluye guiones ni ceros a la izquierda.
`account_type`	`string`	Tipo de cuenta. Uno de `checking_account` o `sight_account`.
`institution_id`	`string`	Identificador de la institución financiera asociada a la transferencia bancaria.
`institution_name`	`string`	Nombre de la institución financiera asociada a la transferencia bancaria.
`mfa_type`	`string` o `null`	Tipo de autenticación multifactor asociada a la cuenta. `null` cuando la cuenta no tiene autenticación multifactor.
`status`	`string`	Estado del payment method. Uno de `active` (disponible para cobrar), `pending` (esperando confirmación) o `canceled` (ya no disponible).

El objeto MX Direct Debit

El objeto MX Direct Debit contiene los términos del mandato de domiciliación bancaria en México que autoriza a Fintoc a cobrar la cuenta del customer. Fintoc devuelve este objeto en mx_direct_debit cuando el type del PaymentMethod es mx_direct_debit. Para crear uno, revisa Crear un payment method.

Atributo	Tipo	Descripción
`account_type`	`string`	Tipo de cuenta que cobra el mandato. Uno de `clabe` para un número de cuenta bancaria mexicana estandarizado de 18 dígitos (CLABE), o `debit_card`.
`institution_id`	`string`	Identificador de la institución financiera donde está la cuenta que se cobra.
`interval`	`string`	Cada cuánto el mandato autoriza un cobro. Uno de `week`, `month` o `year`.
`last_four_digits`	`string`	Últimos cuatro dígitos de la cuenta que se cobra.
`max_amount_cents`	`integer`	Monto máximo que el mandato autoriza por cobro, en la unidad mínima de `max_amount_currency`. Por ejemplo, `500000` corresponde a `$5.000,00 MXN`.
`max_amount_currency`	`string`	Código de moneda ISO 4217 de tres letras del monto máximo, en mayúsculas. Siempre `MXN`.
`status`	`string`	Estado del mandato. Uno de `pending` (esperando la confirmación del banco), `active` (acepta cobros), `rejected` (el banco rechazó el mandato) o `canceled` (ya no acepta cobros). Solo puedes cobrar un payment method cuyo mandato está `active`.

MX Direct Debit Payment Method

{
  "id": "pm_1zXcVbNmAsDfGhJk",
  "object": "payment_method",
  "created_at": "2026-01-10T11:05:00.000Z",
  "customer": "cus_456789abcdef",
  "mode": "live",
  "mx_direct_debit": {
    "account_type": "clabe",
    "institution_id": "mx_banco_santander",
    "interval": "month",
    "last_four_digits": "0000",
    "max_amount_cents": 100000,
    "max_amount_currency": "MXN",
    "status": "pending"
  },
  "type": "mx_direct_debit"
}

​El objeto Payment Method

​Objeto base

​Objeto Pac

​El objeto Card

​El objeto Bank Transfer

​El objeto MX Direct Debit