Retrieve one saved payment method.

GET

/customers/{id}/payment_methods/{payment_method_id}

• Production

Authorizations

• secret_key

Parameters

Path Parameters

id

required

string

Customer ID

payment_method_id

required

string

Payment method ID

Responses

200

Payment method found

A saved card as returned.

The sealed token has no field here, and cannot acquire one by accident: this type is built from [SavedPaymentMethod], which does not carry the token either. The repository’s reads select a display projection and leave the ciphertext in the database, so a token would have to be fetched deliberately to reach this point at all.

object

brand

Empty until the processor supplies them — a network token response carries only the expiry today.

string | null

created

required

integer format: int64

customer_id

required

Identifier for a customer (cus_…).

string

exp_month

integer | null format: int64

exp_year

integer | null format: int64

id

required

Identifier for a stored payment method (pm_…). Declared here rather than alongside the payment method itself because Customer refers to one as its default, and the vault’s method type does not exist yet.

string

last4

string | null

livemode

required

boolean

type

required

card in v1.

string

updated

required

integer format: int64

404

No such customer or payment method

object

error

required

object

code

required

string

message

required

string

param

string | null

retryable

When present and true, the caller may retry the same request.

boolean | null

type

required

string