Skip to main content
GET
List Customer Payment Methods
Retrieve Finosu payment-method UUIDs for a customer using your company API key in X-API-Key. customerId is your external customer reference, not the Finosu customer UUID. Only non-deleted methods belonging to that live customer in the authenticated company are returned.

Response

The response includes bank accounts and other payment-method types, including inactive methods. accountType may be null. Vault tokens, full account and routing numbers, billing details, and gateway metadata are never returned. Method status and default status do not establish current ACH authorization or permission to charge. For Update ACH Authorization Revocation, choose the intended BANK_ACCOUNT entry and use its paymentMethodId with the same customerId. Last-four digits are not unique: if multiple methods could match the intended account and the intent is to revoke all bank authorizations for this customer, paginate all results and POST the revocation separately for each BANK_ACCOUNT ID only. Never revoke cards or another customer’s methods. Check each response; the operation is not atomic across IDs. Otherwise confirm the mapping rather than guessing. Do not select the first or default method merely because it is listed.

Pagination

limit defaults to 100 and accepts 1–100. offset defaults to 0 and must be nonnegative. Results are ordered by payment-method UUID. Increase offset by limit until a page contains fewer than limit entries. An existing customer with no methods, or an offset beyond the last method, returns 200 with []. Separate pages reflect current records, not a fixed snapshot.

Errors

  • 401 — missing, invalid, or inactive API key
  • 404 — unknown, deleted, or other-company customer
  • 422 — invalid pagination parameters

Authorizations

X-API-Key
string
header
required

Path Parameters

customerId
string
required

External customer reference ID

Query Parameters

limit
integer
default:100
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0

Response

Payment methods; an empty array means no methods on this page.

paymentMethodId
string<uuid>
required

Finosu payment-method UUID; use for ACH revocation of bank accounts.

paymentMethodType
enum<string>
required
Available options:
CREDIT_CARD,
DEBIT_CARD,
BANK_ACCOUNT,
CARD,
DIGITAL_WALLET
lastFour
string
required

Masked account/card suffix; not a unique account identifier.

accountType
string | null
required
status
enum<string>
required
Available options:
ACTIVE,
INACTIVE,
EXPIRED,
FAILED,
PENDING_VERIFICATION
isDefault
boolean
required