Payment Methods

Get the default payment method for a customer

Changed on

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

Request

Query parameters

customerRefstring required

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

Response

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

OR

Example response

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

Changes

    • info

      added the required property / to the response with the status

    • info

      the endpoint scheme security SecretKey was added to the API

    • info

      the endpoint scheme security bearer was removed from the API