API reference · Schema
PaymentMethod
objectstringrequiredAlways `payment_method`: the type of this object
One of
payment_methodidstringrequiredUnique ID (`pmth_…`)
ID with prefix pmth_
org_idstringrequiredOrganization it belongs to
ID with prefix org_
driverstringrequired`stripe` for a card saved with the payment processor, `development` for a test card that takes no money
One of
stripedevelopmentbrandstring | nullrequiredCard brand, for example `visa`; null when unknown
last4string | nullrequiredLast four digits of the card; null when unknown
exp_monthinteger | nullrequiredExpiry month (1–12); null when unknown
exp_yearinteger | nullrequiredExpiry year (four digits); null when unknown
statusstringrequired`active` (can be charged) or `detached` (removed; never charged again)
One of
activedetachedcreated_atstring (date-time)requiredWhen it was created (ISO 8601, UTC)
Example
{
"object": "payment_method",
"id": "pmth_01jc5zq4m8k3v6x9t2w7r0b1e4",
"org_id": "org_01jc5zq4m8k3v6x9t2w7r0b1e4",
"driver": "stripe",
"brand": "string",
"last4": "string",
"exp_month": 1,
"exp_year": 1,
"status": "active",
"created_at": "2026-01-01T00:00:00.000Z"
}Used by
- Saved cards
GET /v1/orgs/{org_id}/billing/payment-methods - Remove a saved card (turns off auto-recharge if it used this card)
POST /v1/orgs/{org_id}/billing/payment-methods/{payment_method_id}/detach