latestOpenAPI 3.1.02026-08-183894205.8 MB

f67a043e3190

Payment methods

List payment methods

Returns a paginated list of payment methods for a member or company, or for the authenticated user when neither is given, with optional filtering by creation date. A payment method is a stored representation of how a customer intends to pay, such as a card, bank account, or digital wallet.

Required permissions:

  • member:payment_methods:read
get/payment_methods

Query parameters

afterstring

Returns the elements in the list that come after the specified cursor.

beforestring

Returns the elements in the list that come before the specified cursor.

firstinteger

Returns the first n elements from the list.

Example:42
lastinteger

Returns the last n elements from the list.

Example:42
member_idstring

The unique identifier of the member to list payment methods for. Omit this and company_id to list your own saved payment methods.

Example:mber_xxxxxxxxxxxxx
company_idstring

The unique identifier of the company. Provide either this or member_id, not both. Omit both to address your own saved payment methods.

Example:biz_xxxxxxxxxxxxxx
direction'asc' | 'desc'

The direction of the sort.

created_beforestring date-time

Only return payment methods created before this timestamp.

Example:2023-12-01T05:00:00.401Z
created_afterstring date-time

Only return payment methods created after this timestamp.

Example:2023-12-01T05:00:00.401Z
future_usage'off_session' | 'on_session'

How a payment method will be charged after the buyer leaves — the same vocabulary as a confirmation token's setup_future_usage.

payment_method_typesPaymentMethodTypes[]

Only return payment methods of these types. Pass the eligible type values from the payment method types catalogue so the list holds nothing the purchase cannot take. An empty list returns no payment methods.

card_brandsCardBrands[]

Only return cards on these networks, such as the networks the seller accepts. Payment methods that are not cards are unaffected.

card_funding_typesCardFundingTypes[]

Only return cards funded this way. A card whose funding could not be determined is excluded, and payment methods that are not cards are unaffected.

has_payer_documentboolean

Filter cards by whether they carry the payer identity document their payment provider requires. Payment methods that are not cards are unaffected.

expiredboolean

Filter by expiry. Only a card can expire, so false keeps every payment method that is not past its expiration month and true returns expired cards alone.

brokenboolean

Filter by whether the stored credential has permanently stopped charging, such as a vault entry its provider closed.

Response

A successful response

Example response

{
  "data": [
    {
      "created_at": "2023-12-01T05:00:00.401Z",
      "id": "payt_xxxxxxxxxxxxx"
    }
  ]
}