--- title: "List Payment Methods" method: GET path: "/customers/{id}/payment-methods" tags: ["Customers"] --- # List Payment Methods `GET /customers/{id}/payment-methods` ## Request - Base URL: `https://api.monei.com/v1` - URL: `https://api.monei.com/v1/customers/{id}/payment-methods` - Auth: API key in header `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) Lists the payment methods a customer has saved. Card and account numbers are never returned. Each entry carries only the display details — brand, last four digits, expiry — along with an `id` you can pass as `paymentToken` on a payment. Expired payment methods are left out. **`sequence`**: `sequence: true` marks a payment method saved for merchant-initiated charges, such as subscription renewals. These are the candidates a declined renewal fails over to. `sequence: false` marks one the buyer chose at checkout, which you can charge again with `paymentToken` or set as the customer's `defaultTokenId`. ## Response `200` The payment methods the customer has saved - CustomerPaymentMethod[] - `id` string, required: Identifier of the saved payment method. Pass it as `paymentToken` on a payment, as `defaultTokenId` when updating the customer, or to delete the payment method. - `type` string, required: How the payment method is stored. One of `STICKY` or `ENCRYPTED_STICKY`. - `paymentMethod` PaymentPaymentMethod: Details about the payment method at the time of the transaction. - `method` 'alipay' | 'card' | 'bizum' | 'paypal' | 'mbway' | 'multibanco' | 'iDeal' | 'bancontact' | 'sofort' | 'trustly' | 'sepa' | 'klarna' | 'giropay' | 'eps' | 'blik': Payment method type. - `card` PaymentPaymentMethodCard: Details about the card used as payment method at the time of the transaction. - `country` string: Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). - `brand` 'visa' | 'mastercard' | 'diners' | 'amex' | 'jcb' | 'unionpay' | 'discover' | 'unknown': Card brand. - `type` 'debit' | 'credit': Card type `debit` or `credit`. - `threeDSecure` boolean: Whether this transaction used 3D Secure authentication. - `threeDSecureVersion` string: The protocol version of the 3DS challenge. - `threeDSecureFlow` 'CHALLENGE' | 'FRICTIONLESS' | 'FRICTIONLESS_CHALLENGE' | 'DIRECT': The flow used for 3DS authentication. - `expiration` integer: Time at which the card will expire. Measured in seconds since the Unix epoch. - `last4` string: The last four digits of the card. - `fingerprint` string: Unique identifier for the card number. Used to detect duplicate payment methods across customers. Not present for tokenized cards. - `tokenizationMethod` 'applePay' | 'googlePay' | 'clickToPay': The digital wallet used to tokenize the card. - `cardholderName` string: The name of the cardholder. - `cardholderEmail` string: The email of the cardholder. - `bizum` PaymentPaymentMethodBizum: Details about the Bizum account used as payment method at the time of the transaction. - `phoneNumber` string: Phone number in E.164 format used to pay with `bizum`. - `paypal` PaymentPaymentMethodPaypal: Details from Paypal order used as payment method at the time of the transaction. - `orderId` string: The Paypal's order ID. - `payerId` string: The Paypal's payer ID. - `email` string: The Paypal's payer email. - `name` string: The Paypal's payer name. - `mbway` PaymentPaymentMethodMbway: Details from MBWay order used as payment method at the time of the transaction. - `phoneNumber` string: Phone number in E.164 format used to pay with `mbway`. - `trustly` PaymentPaymentMethodTrustly: Details from Trustly order used as payment method at the time of the transaction. - `customerId` string: The Trustly's customer ID. - `sepa` PaymentPaymentMethodSepa: Details from SEPA order used as payment method at the time of the transaction. - `accountholderAddress` string: The address of the account holder. - `accountholderEmail` string: The email of the account holder. - `accountholderName` string: The name of the account holder. - `countryCode` string: The country code of the account holder. - `bankAddress` string: The address of the bank. - `bankCode` string: The code of the bank. - `bankName` string: The name of the bank. - `bic` string: The BIC of the bank. - `last4` string: The last 4 digits of the IBAN. - `fingerprint` string: Unique identifier for the IBAN. Used to detect duplicate payment methods across customers. - `klarna` PaymentPaymentMethodKlarna: Details from Klarna order used as payment method at the time of the transaction. - `billingCategory` 'PAY_LATER' | 'PAY_NOW' | 'SLICE_IT' | 'SLICE_IT_BY_CARD' | 'PAY_IN_PARTS' - `authPaymentMethod` 'invoice' | 'fixed_amount' | 'pix' | 'base_account' | 'deferred_interest' | 'direct_debit' | 'direct_bank_transfer' | 'b2b_invoice' | 'card' | 'slice_it_by_card' - `expireAt` integer: Time at which the payment method expires, in seconds since the Unix epoch. For a card this is one month after the card's own expiry. Absent when the payment method does not expire. - `createdAt` string, date-time: Time at which the resource was created. - `sequence` boolean, required: Whether this payment method was saved for merchant-initiated charges, such as subscription renewals, rather than being one the buyer chooses at checkout. ## Other responses - `400`: The request is incorrect or could not be processed - `401`: Unauthorized error. Please check your auth credentials - `404`: The specified resource was not found - `422`: The request was well-formed but could not be processed due to semantic errors - `500`: Unexpected server error - `503`: The service is temporarily unavailable ## Changes - **2026-10-02** `2d67a2ee1e00`: 1 info - endpoint added [Operation history](https://skmtc.dev/monei/apis/monei-api-v1/changes/customers/:id/payment-methods/get.md) --- [API](https://skmtc.dev/monei/apis/monei-api-v1.md) - [All operations](https://skmtc.dev/monei/apis/monei-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/monei/apis/monei-api-v1/revisions/50bc7df2aa43?raw)