> For the complete documentation index, see [llms.txt](https://docs.coindpay.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coindpay.xyz/landing/start/developers/global-config.md).

# 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

{% hint style="danger" icon="badge-dollar" %}
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.
{% endhint %}

> #### Rate Limits & Usage

This endpoint is rate-limited to **5** 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

```typescript
GET /payment/global
```

Example:

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

{% hint style="info" %}
API\_DOMAIN [Developers](/landing/start/developers.md#environment)
{% endhint %}

### 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](/landing/start/customers/fiat-currencies.md)

### Request

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

### Response

#### Success response

```json
{
  "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

<table><thead><tr><th width="148.83984375">Field</th><th width="173.271484375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>currency</code></td><td><code>string</code></td><td>Three-letter ISO 4217 currency code.</td></tr><tr><td><code>name</code></td><td><code>string</code></td><td>Full currency name.</td></tr><tr><td><code>symbol</code></td><td><code>string</code></td><td>Currency symbol.</td></tr><tr><td><code>icon</code></td><td><code>string</code></td><td>URL of the currency icon.</td></tr></tbody></table>

#### Limits

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

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

<table><thead><tr><th width="141.603515625">Field</th><th width="175.83984375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>min</code></td><td><code>number</code></td><td>Minimum supported transaction amount across available payment methods.</td></tr><tr><td><code>max</code></td><td><code>number</code></td><td>Maximum supported transaction amount across available payment methods.</td></tr></tbody></table>

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

<table><thead><tr><th width="140.830078125">Field</th><th width="192.27734375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>code</code></td><td><code>string</code></td><td>Unique payment method identifier used by the API and checkout parameters.</td></tr><tr><td><code>name</code></td><td><code>string</code></td><td>Human-readable payment method name.</td></tr><tr><td><code>min</code></td><td><code>number</code></td><td>Minimum transaction amount supported by this payment method.</td></tr><tr><td><code>max</code></td><td><code>number</code></td><td>Maximum transaction amount supported by this payment method.</td></tr></tbody></table>

#### Payment Method Codes

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

{% hint style="info" icon="cash-app" %}
For the complete list of global **Payment Method Codes**, please refer to [Payment methods](/landing/start/customers/payment-methods.md)
{% endhint %}

<table><thead><tr><th width="163.365234375">Code</th><th>Payment method</th></tr></thead><tbody><tr><td><code>card</code></td><td>Debit / Credit Card</td></tr><tr><td><code>apple</code></td><td>Apple Pay</td></tr><tr><td><code>google</code></td><td>Google Pay</td></tr><tr><td><code>paypal</code></td><td>PayPal</td></tr><tr><td><code>cashapp</code></td><td>Cash App Pay</td></tr><tr><td>. . .</td><td></td></tr><tr><td>More</td><td><a data-mention href="/landing/start/customers/payment-methods.md">Payment methods</a> All Supported Payment Methods</td></tr></tbody></table>

***

#### Error response

**404** - Not Found

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

***

### Notes

{% hint style="warning" icon="comment-smile" %}
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.
{% endhint %}