Skip to main content
GET
/
account
/
payment_methods
List payment methods for a Merchant
curl --request GET \
  --url https://sandbox.hyperswitch.io/account/payment_methods \
  --header 'api-key: <api-key>'
{
  "redirect_url": "https://www.google.com",
  "currency": "AED",
  "payment_methods": [
    {
      "payment_method": "card",
      "payment_method_types": [
        {
          "payment_method_type": "ach",
          "payment_experience": [
            {
              "payment_experience_type": "redirect_to_url",
              "eligible_connectors": [
                "stripe",
                "adyen"
              ]
            }
          ],
          "card_networks": [
            {
              "card_network": "Visa",
              "surcharge_details": {
                "surcharge": {
                  "type": "fixed",
                  "value": 123
                },
                "tax_on_surcharge": {
                  "percentage": 123
                },
                "display_surcharge_amount": 123,
                "display_tax_on_surcharge_amount": 123,
                "display_total_surcharge_amount": 123
              },
              "eligible_connectors": [
                "stripe",
                "adyen"
              ]
            }
          ],
          "bank_names": [
            {
              "bank_name": [
                "american_express"
              ],
              "eligible_connectors": [
                "<string>"
              ]
            }
          ],
          "bank_debits": {
            "eligible_connectors": [
              "<string>"
            ]
          },
          "bank_transfers": {
            "eligible_connectors": [
              "stripe",
              "adyen"
            ]
          },
          "required_fields": {},
          "surcharge_details": {
            "surcharge": {
              "type": "fixed",
              "value": 123
            },
            "tax_on_surcharge": {
              "percentage": 123
            },
            "display_surcharge_amount": 123,
            "display_tax_on_surcharge_amount": 123,
            "display_total_surcharge_amount": 123
          },
          "pm_auth_connector": "<string>"
        }
      ]
    }
  ],
  "mandate_payment": {
    "single_use": {
      "amount": 6540,
      "currency": "AED",
      "start_date": "2022-09-10T00:00:00Z",
      "end_date": "2023-09-10T23:59:59Z",
      "metadata": {}
    }
  },
  "merchant_name": "<string>",
  "show_surcharge_breakup_screen": true,
  "payment_type": "normal",
  "request_external_three_ds_authentication": true,
  "collect_shipping_details_from_wallets": true,
  "collect_billing_details_from_wallets": true,
  "is_tax_calculation_enabled": true
}

Authorizations

​
api-key
string
header
required

Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.

Query Parameters

​
client_secret
string | null

This is a token which expires after 15 minutes, used from the client to authenticate and create sessions from the SDK

​
accepted_countries
enum<string>[] | null

The two-letter ISO currency code

​
accepted_currencies
enum<string>[] | null

The three-letter ISO currency code

​
amount
integer | null

The amount accepted for processing by the particular payment method.

​
recurring_enabled
boolean | null

Indicates whether the payment method is eligible for recurring payments

​
installment_payment_enabled
boolean | null

Indicates whether the payment method is eligible for installment payments

​
limit
integer | null

Indicates the limit of last used payment methods

​
card_networks
enum<string>[] | null

Indicates whether the payment method is eligible for card netwotks

Response

Payment Methods retrieved

​
currency
enum<string>
required

The three-letter ISO 4217 currency code (e.g., "USD", "EUR") for the payment amount. This field is mandatory for creating a payment.

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLF,
CLP,
CNY,
COP,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLE,
SLL,
SOS,
SRD,
SSP,
STD,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VES,
VND,
VUV,
WST,
XAF,
XCD,
XOF,
XPF,
YER,
ZAR,
ZMW,
ZWL
​
payment_methods
object[]
required

Information about the payment method

​
mandate_payment
object
required
  • Option 1
  • Option 2
​
show_surcharge_breakup_screen
boolean
required

flag to indicate if surcharge and tax breakup screen should be shown or not

​
request_external_three_ds_authentication
boolean
required

flag to indicate whether to perform external 3ds authentication

Example:

true

​
is_tax_calculation_enabled
boolean
required

flag that indicates whether to calculate tax on the order amount

​
redirect_url
string | null

Redirect URL of the merchant

Example:

"https://www.google.com"

​
merchant_name
string | null
​
payment_type
enum<string>

The type of the payment that differentiates between normal and various types of mandate payments. Use 'setup_mandate' in case of zero auth flow.

Available options:
normal,
new_mandate,
setup_mandate,
recurring_mandate
​
collect_shipping_details_from_wallets
boolean | null

flag that indicates whether to collect shipping details from wallets or from the customer

​
collect_billing_details_from_wallets
boolean | null

flag that indicates whether to collect billing details from wallets or from the customer

⌘I