---
title: "List Payment Methods"
method: GET
path: "/v1/beneficiaries/paymentmethods"
tags: ["Beneficiaries"]
---

# List Payment Methods

`GET /v1/beneficiaries/paymentmethods`

This endpoint returns a list of payment methods.

## Query parameters

- `currency` string, required
- `country` string, required

## Response `200`

OK - Successfully retrieved a list of payment methods.

- object
  - `data` PaymentMethodResponse[]
    - union — The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.
      - object
        - `type` 'card', required
        - `card` object, required
          - `card_name` string, required — Card holder name. Maximum length is 128.
          - `card_number` string, required — Masked card number. First 6 digits (BIN) and last 4 digits are visible.
          - `network` 'visa' | 'mastercard' | 'unionpay', required — The card network. Examples include `visa`, `mastercard`, `unionpay`.
          - `brand` string — The card brand.
          - `bin` string — Bank Identification Number. The first 6–8 digits of the card number identifying the issuing institution.
          - `last4` string — The last four digits of the card number.
          - `card_type` 'credit' | 'debit' | 'prepaid' — The card funding type.
          - `expiry_month` string — Two-digit expiry month of the card.
          - `expiry_year` string — Four-digit expiry year of the card.
          - `billing` CardBilling — Billing information of the customer.
            - `first_name` string, required — First name of the customer. Maximum length is 128.
            - `last_name` string, required — Last name of the customer. Maximum length is 128.
            - `email` string, email, required — Email address of the customer.
            - `phone_number` string — Phone number of the customer.
            - `address` Address, required
              - …
          - `auto_capture` boolean — Specifies whether the funds should be requested automatically after the payment is authorized. Default to `true`. Set it to `false` if you want to capture the funds sometimes later.
          - `authorization_type` 'authorization' | 'pre_authorization', required — The authorization type for the card payment. Options are `authorization` (default) and `pre_authorization`. Use `pre_authorization` to hold funds for more than 7 days, available only for Visa and Mastercard. `auto_capture` must be `false` for pre-authorization.
      - object
        - `type` 'applepay', required
        - `applepay` object, required — Apple Pay payment information returned in the response.
          - `flow` 'redirect' | 'mobile_web' | 'mobile_app' | 'contactless' — The checkout flow used for this payment.
          - `os_type` 'ios' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
          - `network` 'visa' | 'mastercard' | 'amex' | 'discover' | 'jcb'
          - `card_type` 'debit' | 'credit' — The type of card used (e.g., credit, debit).
          - `token_type` 'decrypted' | 'encrypted'
          - `auth_method` 'cryptogram_3ds' | 'pan_only'
      - object
        - `type` 'googlepay', required
        - `googlepay` object, required — Google Pay payment information returned in the response.
          - `flow` 'redirect' | 'mobile_web' | 'mobile_app' | 'contactless' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
          - `network` 'visa' | 'mastercard' | 'amex' | 'discover' | 'jcb'
          - `card_type` 'debit' | 'credit' — The type of card used (e.g., credit, debit).
          - `token_type` 'decrypted' | 'encrypted'
          - `auth_method` 'cryptogram_3ds' | 'pan_only'
      - object
        - `type` 'alipaycn', required
        - `alipaycn` object, required — AlipayCN payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'alipayhk', required
        - `alipayhk` object, required — AlipayHK payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'unionpay', required
        - `unionpay` object, required — UnionPay payment information returned in the response.
          - `flow` 'qrcode' | 'securepay' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'wechatpay', required
        - `wechatpay` object, required — WeChat Pay payment information returned in the response.
          - `flow` 'qrcode' | 'mini_program' | 'mobile_app' | 'mobile_web' | 'official_account' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'grabpay', required
        - `grabpay` object, required — GrabPay payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
          - `shopper_name` string — The name of the shopper.
      - object
        - `type` 'crypto', required
        - `crypto` object, required — Cryptocurrency payment information returned in the response.
          - `flow` 'redirect' | 'qrcode' — The checkout flow used for this payment.
          - `network` 'ETH' | 'TRON'
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'paynow', required
        - `paynow` object, required — PayNow payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'truemoney', required
        - `truemoney` object, required — Truemoney payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'tng', required
        - `tng` object, required — Touch'n Go payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'gcash', required
        - `gcash` object, required — GCash payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'dana', required
        - `dana` object, required — Dana payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'kakaopay', required
        - `kakaopay` object, required — KakaoPay payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'toss', required
        - `toss` object, required — Toss Pay payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.
      - object
        - `type` 'naverpay', required
        - `naverpay` object, required — Naver Pay payment information returned in the response.
          - `flow` 'qrcode' — The checkout flow used for this payment.
          - `os_type` 'ios' | 'android' — The operating system type of the customer device.
          - `is_present` boolean — Whether this is an in-person (offline) payment.

---

[API](https://skmtc.dev/uqpay/apis/authentication-api.md) · [All operations](https://skmtc.dev/uqpay/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uqpay/authentication-api/revisions/cef532a10777/schema)