Skip to main content
GET
Get Payment Methods

Overview

Returns a list of all available payment methods configured for your business, filtered by country and currency restrictions.
This endpoint returns only active payment methods that match the specified filters.

Authentication

This endpoint requires API key authentication. See Authentication for details.

Query Parameters

string
Comma-separated list of ISO 3166-1 alpha-2 country codes to filter payment methods by availability.Example: US,GB,FRMaximum: 200 countriesWith a single country, the fees are those a customer from that country pays: some card processors add a cross-border fee for cards from outside their region. Pass the country your customer selected to show them the price they will pay on the payment page. With several countries or none, the base rates are returned, without any cross-border fee.
integer
Amount of the payment in cents (USD). When set, fees returns the exact fees for that amount instead of the rates: { "amount": 447 }, in cents, the same figure as on the payment page.Example: 10000 ($100.00)
string
Comma-separated list of three-letter ISO currency codes to filter payment methods.Example: USD,EUR,GBPMaximum: 200 currencies
boolean
Set to true to get payment methods for business customers with adjusted fees.Default: false

Response

Returns an object where each key is a payment method ID and the value contains the payment method details.
object

Example Request

Example Response

Error Responses

Returned when the API key is missing or invalid.How to resolve: Ensure you are sending a valid API key in the Authorization: Bearer header. Both Public and Secret API keys are accepted.

Understanding the Response

Global vs Regional Payment Methods

  • Global methods have null or empty arrays for countries and currencies
  • Regional methods specify which countries and currencies they support

Fee Structure

The percentage applies to the total the customer pays, fees included, not to the amount alone:
Example: For a $100 payment with static_fees: 30 and percent_fees: 290:
Add-on fees passed on to the customer (fraud screening, for example) come on top. To display the exact price, pass amount: fees.amount is the figure the payment page will charge.

Company vs Individual Fees

When is_company=true, some payment methods may have adjusted fee structures for business customers.

Use Cases

Display Payment Options

Show available payment methods to your customers before they start checkout

Dynamic Pricing

Calculate and display fees for each payment method

Geographic Filtering

Show only payment methods available in customer’s country

Currency Support

Filter methods based on your transaction currency

Filtering Logic

  • If no countries parameter is provided, all payment methods are returned
  • If countries are specified, only methods available in those countries are returned
  • Methods with null countries are always included (global availability)
  • If no currencies parameter is provided, all payment methods are returned
  • If currencies are specified, only methods supporting those currencies are returned
  • Methods with null currencies are always included (all currencies supported)
  • Only payment methods that are active in your business configuration are returned
  • Methods must also have an active provider configuration

Best Practices

Cache Responsibly: Payment methods and fees can change. Cache the response for a short period (recommended: 5-15 minutes) and refresh regularly. Fees depend on countries and amount: include both in your cache key.
Show Relevant Methods: Always filter by the customer’s country and your transaction currency to show only relevant payment options.
Show the Price the Customer Will Pay: Pass the customer’s country alone in countries and the payment amount. The fees.amount you get is the one the payment page charges.

Next Steps

Create Session

Create a payment session with a specific payment method

Configure Methods

Enable or configure payment methods in your dashboard