Payment method object

Payment Methods represent your customers' payment instruments. You can use them to collect payments on demand or add them to subscriptions to automate recurring payments.

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"
}
AttributeTypeDescription
idstringUnique identifier for the Payment Method.
objectstringType of the object. Always payment_method.
created_atstringISO 8601 datetime in UTC when the payment method was created.
customerstringCustomer ID associated with this payment method.
modestringOne of live or test.
pacobjectPresent only when type is pac. Contains details specific to a PAC payment method.
typestringType of the payment method. Always pac. The object includes an additional field named after this value (pac) 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.

AttributeTypeDescription
account_holder_idstringAccount owner's tax ID. In Chile, a Chilean tax ID (RUT).
account_numberstringAccount number. Does not include hyphens or prefixed zeros.
account_typestringAccount type. One of checking_account or sight_account.
institutionobjectFinancial institution associated with the PAC. See The Institution object below.
statusstringPAC 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.

AttributeTypeDescription
idstringAccount's institution id. You can learn more about institutions and their ids here.
countrystringTwo-letter ISO 3166-1 alpha-2 country code of the institution, in lowercase. For example, cl for Chile.
namestringName of the financial institution.