Payment Methods

Get the default payment method for a customer

Returns the customer's default card for the authenticated provider. Sourced from stored payment-method records (no Stripe round-trip). Returns { kind: 'none' } when no card is on file.

get/v1/sdk/payment-method

Query parameters

customerRefstring required

Customer reference (e.g. customer_...).

Response

The customer's default card, or { kind: 'none' } when no card is on file.

Example response

{
  "brand": "visa",
  "expMonth": 12,
  "expYear": 2030,
  "last4": "4242"
}

Changes

Changed in 2 of the 27 revisions of this API.3

Jul 4, 2026a30b6aef464d2See the full diff
- ○
  the endpoint scheme security SecretKey was added to the API
  api-security-added
- ○
  the endpoint scheme security bearer was removed from the API
  api-security-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 26, 202660c2cd1caf831See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 192 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history