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"
}| Attribute | Type | Description |
|---|---|---|
id | string | Unique identifier for the Payment Method. |
object | string | Type of the object. Always 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. 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.
| 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 ids 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. |