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, como Apple Pay o Google Pay, 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`, `google_pay` o `null` para tarjetas ingresadas manualmente.

Una tarjeta inscrita a través de un wallet devuelve el nombre del wallet en wallet, por ejemplo apple_pay o google_pay, 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 la cuenta y las condiciones del mandato de domiciliación mexicana. Fintoc lo devuelve en mx_direct_debit cuando type es mx_direct_debit. Sigue Acepta pagos por domiciliación en México para inscribir por API o Checkout Session y probar la integración.

Atributo	Tipo	Descripción
`account_holder_id`	`string`	Registro Federal de Contribuyentes (RFC) del titular, el identificador fiscal mexicano.
`account_number_last4`	`string`	Últimos cuatro dígitos de la cuenta bancaria o tarjeta de débito inscrita.
`account_type`	`string`	`clabe` para una Clave Bancaria Estandarizada (CLABE) de 18 dígitos o `debit_card` para un número de tarjeta de débito.
`consent_source`	`string`	Camino de inscripción. `api` cuando entregas los documentos de consentimiento o `checkout` cuando tu cliente autoriza en una Checkout Session. Fintoc asigna este valor.
`institution`	`object`	Banco de la cuenta inscrita. Contiene `id`, `country` como código ISO 3166-1 alpha-2 en minúsculas y `name`.
`interval`	`string`	Período de autorización: `week`, `month` o `year`.
`max_amount`	`integer`	Límite autorizado por período del mandato, en centavos de MXN. `35000` equivale a $350.00 MXN.
`status`	`string`	`pending` (esperando aprobación), `active` (se puede cobrar), `rejected` (aprobación rechazada), `expired` (venció el plazo de aprobación) o `canceled` (autorización terminada). Solo `active` permite cargos.

MX Direct Debit Payment Method

{
  "id": "pm_000000001",
  "object": "payment_method",
  "created_at": "2026-10-08T12:00:00Z",
  "customer": "cus_000000001",
  "mode": "test",
  "mx_direct_debit": {
    "account_holder_id": "AAAA010101AAA",
    "account_number_last4": "0015",
    "account_type": "clabe",
    "consent_source": "api",
    "institution": {
      "id": "mx_banco_bbva",
      "country": "mx",
      "name": "Banco BBVA"
    },
    "interval": "month",
    "max_amount": 35000,
    "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