π³Get Payment Methods
Need help with your integration? Click here to chat with our custom GPT for instant answers.
All payment methods & their supported countries can be retrieved with a GET request. Methods are grouped by area, using supported countries codes.
URL: https://widget.swapped.com/api/v1/merchant/get_payment_methods Additionally, you can also append your public key to filter down the endpoint to only display your available methods. https://widget.swapped.com/api/v1/merchant/get_payment_methods?apiKey=YOUR_API_KEY
Response:
{
"id": 63,
"name": "Skrill",
"fee": 3,
"slug": "skrill",
"default": null,
"currency": [
"EUR",
"DKK",
"GBP",
"USD"
],
"base_fee": {
"base_fee": 0.6
},
"disabled": false,
"min_fee": 0,
"min_amount": 7,
"max_amount": 25000,
},
Response Definition:
id
: The payment method id.name
: The name of the payment method.fee
: The fee in percentage.slug
: The payment method slug.currency
: The currencies the payment method supports.base_fee
: The base fee for the payment method.disabled
: Whether the method is disabled or not.min_fee
: The minimum fee for the payment method in EUR.min_amount
: The minimum amount in EUR that this payment supports.max_amount
: The maximum amount in EUR that this payment supports.
Why Are Some Bank Transfers Listed Separately?
The widget auto-selects the correct Bank Transfer method based on the country, some are listed separately because fees and flows vary by region. Local banking systems, currencies, and operational costs differ which directly affects pricing and handling.
Listing them individually ensures clarity on what users can expect per country.
Payment Methods with "Extra" Variants
Some payment methods include an "extra" variant in the ID (e.g. google-pay-extra
, skrill-extra
). These are functionally the same as their base methods but differ in the following ways:
Country Availability: The "Extra" variants are available in different countries than the base methods.
Fees: They may have different transaction fees.
Internal Mapping: There's no need for merchants to handle these distinctions manually. You can pass the base ID (e.g.
google-pay
,skrill
,neteller
) and our system will automatically select the correct variant based on the userβs context.
Widget Usage You can use the same payment widget for all countries. The method (base or extra) will be auto-selected accordingly.
Last updated