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.

{
  "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": "9530516286",
    "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`.
`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`.
`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 `card` 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 con Cuenta (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 \| 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:

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