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 } ] }