Skip to main content

Documentation

List Payment Methods by Country

Retrieve a list of all payment methods available for a country.

You can filter the results by specifying the currency query parameter.

For general information about payment methods, use the Client Portal.

    • country

    • Two-letter ISO 3166-1 ALPHA-2 code for the country.

    • currency

    • Three-letter ISO 4217 code for the currency.

Code Samples
    • .NET

      • using System;
        
        namespace RapydApiRequestSample
        {
            class Program
            {
                static void Main(string[] args)
                {
                    try
                    {
        
                        string result = RapydApiRequestSample.Utilities.MakeRequest("GET", $"/v1/payment_methods/countries/IT?currency=EUR");
        
                        Console.WriteLine(result);
                    }
                    catch (Exception e)
                    {
                        Console.WriteLine("Error completing request: " + e.Message);
                    }
                }
            }
        }
    • JavaScript

      • const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;
        
        async function main() {
          try {
            const result = await makeRequest('GET', '/v1/payment_methods/countries/IT?currency=EUR');
        
            console.log(result);
          } catch (error) {
            console.error('Error completing request', error);
          }
        }
    • PHP

      • <?php
        $path = $_SERVER['DOCUMENT_ROOT'];
        $path .= "/<path-to-your-utility-file>/utilities.php";
        include($path);
        
        try {
            $object = make_request('get', '/v1/payment_methods/countries/IT?currency=EUR');
            var_dump($object);
        } catch(Exception $e) {
            echo "Error: $e";
        }
        ?>
    • Python

      • from pprint import pprint
        
        from utilities import make_request
        
        response = make_request(method='get',
                                path=f'/v1/payment_methods/countries/IT?currency=EUR')
        
        pprint(response)
  • /v1/payment_methods/countries/{country}

  • List Payment Methods by Country

  • curl -X get
    https://sandboxapi.rapyd.net/v1/payment_methods/countries/TH?currency=THB
    -H 'access_key: your-access-key-here'
    -H 'Content-Type: application/json'
    -H 'idempotency: your-idempotency-parameter-here'
    -H 'salt: your-random-string-here'
    -H 'signature: your-calculated-signature-here'
    -H 'timestamp: your-unix-timestamp-here'
    
  •               
        {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "59b1404f-03c6-45d1-95f3-c77c08b535d1"
        },
        "data": [
            {
                "type": "th_tescolotus_cash",
                "name": "Tesco Lotus",
                "category": "cash",
                "image": "https://iconslib.rapyd.net/checkout/th_tescolotus_cash.png",
                "country": "TH",
                "payment_flow_type": "cash",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [
                    {
                        "name": "customer",
                        "type": "customer",
                        "regex": "",
                        "description": "ID of a customer object, a string starting with ‘cus_‘. The customer object must contain the fields listed as required, and can contain additional fields listed here.If the customer object does not exist yet, use ‘Create Customer‘",
                        "is_required": true,
                        "is_updatable": false,
                        "required_fields": [
                            {
                                "name": "name",
                                "type": "string",
                                "regex": "^[0-9a-zA-Z.:|?*,!&_ -]{1,128}$",
                                "description": "Customer’s full name",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "email",
                                "type": "string",
                                "regex": "^(?=.{1,128}$)([0-9a-zA-Z_.-]+@[a-zA-Z.-]+?[.]{1}[a-zA-Z]{2,3})$",
                                "description": "Customer’s email",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "phone_number",
                                "type": "string",
                                "regex": "^[+][0-9]{1,15}$",
                                "description": "Customer’s phone number",
                                "is_required": true,
                                "is_updatable": false
                            }
                        ]
                    }
                ],
                "is_expirable": false,
                "is_online": false,
                "is_refundable": false,
                "minimum_expiration_seconds": 0,
                "maximum_expiration_seconds": 1209600,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            },
            {
                "type": "th_bbl_bank",
                "name": "Bangkok Bank",
                "category": "bank_redirect",
                "image": "https://iconslib.rapyd.net/checkout/th_bbl_bank.png",
                "country": "TH",
                "payment_flow_type": "redirect_url",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [
                    {
                        "name": "complete_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the complete_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "customer",
                        "type": "customer",
                        "regex": "",
                        "description": "ID of a customer object, a string starting with ‘cus_‘. The customer object must contain the fields listed as required, and can contain additional fields listed here.If the customer object does not exist yet, use ‘Create Customer‘",
                        "is_required": true,
                        "is_updatable": false,
                        "required_fields": [
                            {
                                "name": "name",
                                "type": "string",
                                "regex": "^[0-9a-zA-Z.:|?*,!&_ -]{1,128}$",
                                "description": "Customer’s full name",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "email",
                                "type": "string",
                                "regex": "^(?=.{1,128}$)([0-9a-zA-Z_.-]+@[a-zA-Z.-]+?[.]{1}[a-zA-Z]{2,3})$",
                                "description": "Customer’s email",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "phone_number",
                                "type": "string",
                                "regex": "^[+][0-9]{1,15}$",
                                "description": "Customer’s phone number",
                                "is_required": true,
                                "is_updatable": false
                            }
                        ]
                    }
                ],
                "is_expirable": false,
                "is_online": false,
                "is_refundable": false,
                "minimum_expiration_seconds": 0,
                "maximum_expiration_seconds": 1209600,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            },
            {
                "type": "th_bay_bank",
                "name": "Krungsri Bank",
                "category": "bank_redirect",
                "image": "https://iconslib.rapyd.net/checkout/th_bay_bank.png",
                "country": "TH",
                "payment_flow_type": "redirect_url",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [
                    {
                        "name": "complete_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the complete_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "customer",
                        "type": "customer",
                        "regex": "",
                        "description": "ID of a customer object, a string starting with ‘cus_‘. The customer object must contain the fields listed as required, and can contain additional fields listed here.If the customer object does not exist yet, use ‘Create Customer‘",
                        "is_required": true,
                        "is_updatable": false,
                        "required_fields": [
                            {
                                "name": "name",
                                "type": "string",
                                "regex": "^[0-9a-zA-Z.:|?*,!&_ -]{1,128}$",
                                "description": "Customer’s full name",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "email",
                                "type": "string",
                                "regex": "^(?=.{1,128}$)([0-9a-zA-Z_.-]+@[a-zA-Z.-]+?[.]{1}[a-zA-Z]{2,3})$",
                                "description": "Customer’s email",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "phone_number",
                                "type": "string",
                                "regex": "^[+][0-9]{1,15}$",
                                "description": "Customer’s phone number",
                                "is_required": true,
                                "is_updatable": false
                            }
                        ]
                    }
                ],
                "is_expirable": false,
                "is_online": false,
                "is_refundable": false,
                "minimum_expiration_seconds": 0,
                "maximum_expiration_seconds": 1209600,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            },
            {
                "type": "th_truemoney_ewallet",
                "name": "TrueMoney eWallet",
                "category": "ewallet",
                "image": "https://iconslib.rapyd.net/checkout/th_truemoney_ewallet.png",
                "country": "TH",
                "payment_flow_type": "ewallet",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [
                    {
                        "name": "complete_payment_url",
                        "type": "string",
                        "is_required": true,
                        "instructions": "URL to redirect user to upon successful payment",
                        "is_updatable": false
                    }
                ],
                "is_expirable": false,
                "is_online": false,
                "is_refundable": false,
                "minimum_expiration_seconds": 0,
                "maximum_expiration_seconds": 1209600,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            },
            {
                "type": "th_mastercard_card",
                "name": "Mastercard",
                "category": "card",
                "image": "https://iconslib.rapyd.net/checkout/th_mastercard_card.png",
                "country": "TH",
                "payment_flow_type": "card",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [
                    {
                        "name": "complete_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the complete_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "error_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the error_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    }
                ],
                "is_expirable": true,
                "is_online": true,
                "is_refundable": true,
                "minimum_expiration_seconds": 600,
                "maximum_expiration_seconds": 604800,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": true
            },
            {
                "type": "th_thaipromptpayqrcredit_bank",
                "name": "Visa QR Scan to Pay",
                "category": "bank_transfer",
                "image": "https://iconslib.rapyd.net/checkout/th_thaipromptpayqrcredit_bank.png",
                "country": "TH",
                "payment_flow_type": "bank_transfer",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": true,
                "payment_options": [
                    {
                        "name": "description",
                        "type": "string",
                        "regex": "",
                        "description": "the description field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    }
                ],
                "is_expirable": false,
                "is_online": true,
                "is_refundable": false,
                "minimum_expiration_seconds": 0,
                "maximum_expiration_seconds": 1209600,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            },
            {
                "type": "th_kasikorn_bank",
                "name": "Kasikorn Bank",
                "category": "bank_redirect",
                "image": "https://iconslib.rapyd.net/checkout/th_kasikorn_bank.png",
                "country": "TH",
                "payment_flow_type": "redirect_url",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [
                    {
                        "name": "complete_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the complete_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "customer",
                        "type": "customer",
                        "regex": "",
                        "description": "ID of a customer object, a string starting with ‘cus_‘. The customer object must contain the fields listed as required, and can contain additional fields listed here.If the customer object does not exist yet, use ‘Create Customer‘",
                        "is_required": true,
                        "is_updatable": false,
                        "required_fields": [
                            {
                                "name": "name",
                                "type": "string",
                                "regex": "^[0-9a-zA-Z.:|?*,!&_ -]{1,128}$",
                                "description": "Customer’s full name",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "email",
                                "type": "string",
                                "regex": "^(?=.{1,128}$)([0-9a-zA-Z_.-]+@[a-zA-Z.-]+?[.]{1}[a-zA-Z]{2,3})$",
                                "description": "Customer’s email",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "phone_number",
                                "type": "string",
                                "regex": "^[+][0-9]{1,15}$",
                                "description": "Customer’s phone number",
                                "is_required": true,
                                "is_updatable": false
                            }
                        ]
                    }
                ],
                "is_expirable": false,
                "is_online": false,
                "is_refundable": false,
                "minimum_expiration_seconds": 0,
                "maximum_expiration_seconds": 1209600,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            },
            {
                "type": "th_linepaygoogle_ewallet",
                "name": "Linepay Ewallet for Google",
                "category": "ewallet",
                "image": "https://iconslib.rapyd.net/checkout/th_linepaygoogle_ewallet.png",
                "country": "TH",
                "payment_flow_type": "ewallet",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [],
                "is_expirable": false,
                "is_online": false,
                "is_refundable": true,
                "minimum_expiration_seconds": 86400,
                "maximum_expiration_seconds": 43200,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": true,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            },
            {
                "type": "th_ktb_bank",
                "name": "Krung Thai Bank",
                "category": "bank_redirect",
                "image": "https://iconslib.rapyd.net/checkout/th_ktb_bank.png",
                "country": "TH",
                "payment_flow_type": "redirect_url",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [
                    {
                        "name": "complete_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the complete_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "customer",
                        "type": "customer",
                        "regex": "",
                        "description": "ID of a customer object, a string starting with ‘cus_‘. The customer object must contain the fields listed as required, and can contain additional fields listed here.If the customer object does not exist yet, use ‘Create Customer‘",
                        "is_required": true,
                        "is_updatable": false,
                        "required_fields": [
                            {
                                "name": "name",
                                "type": "string",
                                "regex": "^[0-9a-zA-Z.:|?*,!&_ -]{1,128}$",
                                "description": "Customer’s full name",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "email",
                                "type": "string",
                                "regex": "^(?=.{1,128}$)([0-9a-zA-Z_.-]+@[a-zA-Z.-]+?[.]{1}[a-zA-Z]{2,3})$",
                                "description": "Customer’s email",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "phone_number",
                                "type": "string",
                                "regex": "^[+][0-9]{1,15}$",
                                "description": "Customer’s phone number",
                                "is_required": true,
                                "is_updatable": false
                            }
                        ]
                    }
                ],
                "is_expirable": false,
                "is_online": false,
                "is_refundable": false,
                "minimum_expiration_seconds": 0,
                "maximum_expiration_seconds": 1209600,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            },
            {
                "type": "th_visa_card",
                "name": "Visa",
                "category": "card",
                "image": "https://iconslib.rapyd.net/checkout/th_visa_card.png",
                "country": "TH",
                "payment_flow_type": "card",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [
                    {
                        "name": "complete_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the complete_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "error_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the error_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    }
                ],
                "is_expirable": true,
                "is_online": true,
                "is_refundable": true,
                "minimum_expiration_seconds": 600,
                "maximum_expiration_seconds": 604800,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": true
            },
            {
                "type": "th_scb_bank",
                "name": "Siam Commercial Bank",
                "category": "bank_redirect",
                "image": "https://iconslib.rapyd.net/checkout/th_scb_bank.png",
                "country": "TH",
                "payment_flow_type": "redirect_url",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": false,
                "payment_options": [
                    {
                        "name": "complete_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the complete_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "customer",
                        "type": "customer",
                        "regex": "",
                        "description": "ID of a customer object, a string starting with ‘cus_‘. The customer object must contain the fields listed as required, and can contain additional fields listed here.If the customer object does not exist yet, use ‘Create Customer‘",
                        "is_required": true,
                        "is_updatable": false,
                        "required_fields": [
                            {
                                "name": "name",
                                "type": "string",
                                "regex": "^[0-9a-zA-Z.:|?*,!&_ -]{1,128}$",
                                "description": "Customer’s full name",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "email",
                                "type": "string",
                                "regex": "^(?=.{1,128}$)([0-9a-zA-Z_.-]+@[a-zA-Z.-]+?[.]{1}[a-zA-Z]{2,3})$",
                                "description": "Customer’s email",
                                "is_required": true,
                                "is_updatable": false
                            },
                            {
                                "name": "phone_number",
                                "type": "string",
                                "regex": "^[+][0-9]{1,15}$",
                                "description": "Customer’s phone number",
                                "is_required": true,
                                "is_updatable": false
                            }
                        ]
                    }
                ],
                "is_expirable": false,
                "is_online": false,
                "is_refundable": false,
                "minimum_expiration_seconds": 0,
                "maximum_expiration_seconds": 1209600,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            },
            {
                "type": "th_thaipromptpayqr_bank",
                "name": "PromptPay",
                "category": "bank_transfer",
                "image": "https://iconslib.rapyd.net/checkout/th_thaipromptpayqr_bank.png",
                "country": "TH",
                "payment_flow_type": "bank_transfer",
                "currencies": [
                    "THB"
                ],
                "status": 1,
                "is_cancelable": true,
                "payment_options": [
                    {
                        "name": "description",
                        "type": "string",
                        "regex": "",
                        "description": "the description field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    }
                ],
                "is_expirable": false,
                "is_online": true,
                "is_refundable": false,
                "minimum_expiration_seconds": 0,
                "maximum_expiration_seconds": 1209600,
                "virtual_payment_method_type": null,
                "is_virtual": false,
                "multiple_overage_allowed": false,
                "amount_range_per_currency": [
                    {
                        "currency": "THB",
                        "maximum_amount": null,
                        "minimum_amount": null
                    }
                ],
                "is_tokenizable": false,
                "supported_digital_wallet_providers": [],
                "is_restricted": false,
                "supports_subscription": false
            }
        ]
    }