Payment method object

The Payment Method object

The PaymentMethod object represents a customer’s stored payment instrument that you can charge on demand or attach to a subscription for recurring payments. It appears when you create a payment method or when a CheckoutSession with a setup flow completes.

Payment Method Object

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

Attribute	Type	Description
`id`	`string`	Unique identifier for the Payment Method.
`object`	`string`	Type of the object. Always `payment_method`.
`bank_transfer`	`object`	Present only when `type` is `bank_transfer`. Contains details specific to a bank transfer payment method.
`card`	`object`	Present only when `type` is `card`. Contains details specific to a card payment method.
`created_at`	`string`	ISO 8601 datetime in UTC when the payment method was created.
`customer`	`string`	Customer ID associated with this payment method.
`mode`	`string`	One of `live` or `test`.
`mx_direct_debit`	`object` or `null`	Present only when `type` is `mx_direct_debit`. Contains the terms of the Mexican direct debit mandate. `null` when the mandate backing the payment method is no longer available.
`pac`	`object`	Present only when `type` is `pac`. Contains details specific to a PAC payment method.
`type`	`string`	Type of the payment method. One of `bank_transfer`, `card`, `mx_direct_debit`, or `pac`. The object includes an additional field named after this value (for example, `card`) with type-specific details.

The PAC object

The PAC object holds the details of a Pago Automático de Cuentas (PAC), a recurring direct-debit authorization on the customer’s bank account, returned in the pac field when the Payment Method type is pac.

Attribute	Type	Description
`account_holder_id`	`string`	Account owner’s tax ID. In Chile, a Chilean tax ID (RUT).
`account_number`	`string`	Account number. Does not include hyphens or prefixed zeros.
`account_type`	`string`	Account type. One of `checking_account` or `sight_account`.
`institution`	`object`	Financial institution associated with the PAC. See The Institution object below.
`status`	`string`	PAC authorization status. One of `active` (available to charge), `pending` (awaiting confirmation), or `canceled` (no longer available).

The Institution object (within the PAC object)

The Institution object identifies the bank that holds the account authorized for the PAC, returned in the institution field of the PAC object.

Attribute	Type	Description
`id`	`string`	Account’s institution `id`. You can learn more about institutions and their `id`s here.
`country`	`string`	Two-letter ISO 3166-1 alpha-2 country code of the institution, in lowercase. For example, `cl` for Chile.
`name`	`string`	Name of the financial institution.

The Card object

The Card object holds the details of a stored card. Fintoc returns the Card object in the card field when the PaymentMethod type is card.

Attribute	Type	Description
`active`	`boolean`	Whether the card can currently be charged. Fintoc deactivates expired cards automatically.
`brand`	`string`	Card brand. For example, `visa` or `mastercard`.
`country`	`string`	Display name of the issuing country, in English.
`expiration`	`object`	Card expiration date with `month` and `year` strings. `month` uses two digits, and `year` uses four digits. Both values are `null` for cards enrolled through a wallet because wallets do not expose expiration dates.
`kind`	`string`	Card kind. One of `credit` or `debit`.
`last_four_digits`	`string`	Last four digits of the card number.
`wallet`	`string` or `null`	Wallet used to enroll the card. One of `apple_pay` or `null` for cards entered manually.

A card enrolled through a wallet such as Apple Pay returns apple_pay in wallet and null values for expiration.month and 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"
}

The Bank Transfer object

The Bank Transfer object holds the details of a bank account enrolled for bank transfer payments. Fintoc returns the Bank Transfer object in the bank_transfer field when the PaymentMethod type is bank_transfer.

Attribute	Type	Description
`account_holder_id`	`string`	Account owner’s tax ID. In Chile, a Chilean tax ID (RUT).
`account_number`	`string`	Account number. Does not include hyphens or prefixed zeros.
`account_type`	`string`	Account type. One of `checking_account` or `sight_account`.
`institution_id`	`string`	Identifier of the financial institution associated with the bank transfer.
`institution_name`	`string`	Name of the financial institution associated with the bank transfer.
`mfa_type`	`string` or `null`	Type of multi-factor authentication associated with the account. `null` when the account has no multi-factor authentication.
`status`	`string`	Status of the payment method. One of `active` (available to charge), `pending` (awaiting confirmation), or `canceled` (no longer available).

The MX Direct Debit object

The MX Direct Debit object holds the terms of the Mexican direct debit mandate (domiciliación bancaria) that authorizes Fintoc to charge the customer’s account. Fintoc returns this object in mx_direct_debit when the PaymentMethod type is mx_direct_debit. To create one, see Create a payment method.

Attribute	Type	Description
`account_type`	`string`	Kind of account the mandate debits. One of `clabe` for an 18-digit standardized Mexican bank account number (CLABE), or `debit_card`.
`institution_id`	`string`	Identifier of the financial institution that holds the debited account.
`interval`	`string`	How often the mandate authorizes a charge. One of `week`, `month`, or `year`.
`last_four_digits`	`string`	Last four digits of the debited account.
`max_amount_cents`	`integer`	Maximum amount the mandate authorizes per charge, in the smallest unit of `max_amount_currency`. For example, `500000` means `$5,000.00 MXN`.
`max_amount_currency`	`string`	Three-letter ISO 4217 currency code of the maximum amount, in uppercase. Always `MXN`.
`status`	`string`	Status of the mandate. One of `pending` (awaiting bank confirmation), `active` (accepts charges), `rejected` (the bank refused the mandate), or `canceled` (no longer accepts charges). You can only charge a payment method whose mandate is `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"
}

​The Payment Method object

​The PAC object

​The Institution object (within the PAC object)

​The Card object

​The Bank Transfer object

​The MX Direct Debit object