Global Config

The Global Payment Configuration API returns the currently available payment methods and transaction limits for a specified fiat currency.

Use this endpoint before initializing a payment or checkout flow to determine:

• Which payment methods are currently available

• The minimum and maximum transaction amount supported for the currency

• The minimum and maximum amount supported by each payment method

The returned configuration is dynamically resolved from CoindPay's payment infrastructure and may change as our acquiring and payment processing capabilities expand. The min, max, and available payment methods for each currency are not fixed.

Merchant developers are therefore recommended to use the values returned by this API as the source of truth when dynamically adjusting product pricing and available payment methods in custom checkout flows.

Rate Limits & Usage

This endpoint is rate-limited to 10 requests per minute.

For standard merchant integrations, calling this endpoint is generally not required. CoindPay Checkout provides real-time availability and limit information directly within the checkout flow.

For Payment Service Providers (PSPs) or platforms that implement their own routing and distribution logic across multiple currencies and payment methods, this API can be used as a reference for dynamically configuring supported currencies, transaction limits, and payment methods.

---

API

GET /payment/global

Example:

GET {API_DOMAIN}/payment/global?currency=EUR

API_DOMAIN Environment

Query Params

Name	Type	Required	Example	Description
currency	string*	Yes	USD	Three-letter ISO 4217 fiat currency code.

* Required

For the complete list of supported fiat currencies, please refer to Fiat currencies

Request

curl "https://api.coindpay.xyz/payment/global?currency=USD"

Response

Success response

{
  "ok": true,
  "data": {
    "currency": "USD",
    "name": "United States Dollar",
    "symbol": "$",
    "icon": "https://flagcdn.com/us.svg",
    "limits": {
      "min": 1,
      "max": 50000
    },
    "methods": [
      {
        "code": "card",
        "name": "Card",
        "min": 10,
        "max": 16819.68
      },
      {
        "code": "apple",
        "name": "Apple Pay",
        "min": 23.24,
        "max": 16819.68
      },
      {
        "code": "google",
        "name": "Google Pay",
        "min": 10,
        "max": 16819.68
      },
      {
        "code": "cashapp",
        "name": "Cash App Pay",
        "min": 1,
        "max": 50000
      },
      ...
    ]
  }
}

---

Full Config Fields

Currency

Field	Type	Description
currency	string	Three-letter ISO 4217 currency code.
name	string	Full currency name.
symbol	string	Currency symbol.
icon	string	URL of the currency icon.

Limits

limits represents the overall transaction range available for the specified fiat currency.

"limits": {  "min": 1,  "max": 50000 }

Field	Type	Description
min	number	Minimum supported transaction amount across available payment methods.
max	number	Maximum supported transaction amount across available payment methods.

These limits are currency-level limits, not necessarily applicable to every payment method.

For example, the currency may support:

USD: 1 – 50,000

while an individual payment method may support only:

Card: 10 – 17,428.56

When using a specific payment method, always use the limits returned for that method.

---

Methods

The methods array contains the payment methods currently available for the specified currency.

Payment Method Fields

Field	Type	Description
code	string	Unique payment method identifier used by the API and checkout parameters.
name	string	Human-readable payment method name.
min	number	Minimum transaction amount supported by this payment method.
max	number	Maximum transaction amount supported by this payment method.

Payment Method Codes

Payment method availability depends on the selected currency and current provider configuration.

For the complete list of global Payment Method Codes, please refer to Payment methods

Code	Payment method
card	Debit / Credit Card
apple	Apple Pay
google	Google Pay
paypal	PayPal
cashapp	Cash App Pay
. . .
More	Payment methods All Supported Payment Methods

---

Error response

404 - Not Found

{
  "ok": false,
  "message": "Failed to fetch currency data ˙◠˙"
}

---

Notes

If you use this API, cache the returned configuration and avoid frequent requests. It does not need to be fetched for every transaction or checkout session.