> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> This guide introduces the prerequisites, base configuration, service endpoints, app creation, key management, and supported payment networks and currencies for GatePay external APIs.

## Merchant Onboarding and App Configuration

### Base URL

| Component        | Value                             |
| ---------------- | --------------------------------- |
| Service Base URL | `https://openplatform.gateapi.io` |

All API paths in this documentation must be combined with the base URL to form the full request URL.

### Create and Configure an App

Follow these steps to set up your application in the GatePay Merchant Portal:

| Step | Action                                                                                      |
| ---- | ------------------------------------------------------------------------------------------- |
| 1    | Log in to the GatePay Merchant Portal and complete merchant registration and initial setup. |
| 2    | Fill in the required business information and submit your merchant application.             |
| 3    | Navigate to the app configuration page and create or configure a new application.           |
| 4    | Retrieve your `ClientId` from the application list.                                         |
| 5    | Configure the callback URL as needed to receive asynchronous notifications.                 |

### Configuration Credentials

After completing app configuration, you will receive the following credentials:

| Credential           | Description                                                                                                                                                                                                          |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ClientId`           | Unique identifier for your application. Used in all API requests via the `X-GatePay-Certificate-ClientId` header (see [Authentication and Security](/essentials/version/100/en/authenticationSecurity) for details). |
| Payment API Secret   | Server-side signing key for payment-related API requests and signature verification.                                                                                                                                 |
| Authorization Secret | Server-side signing key for authorization API requests and signature verification (used only by authorization APIs).                                                                                                 |
| Callback URL         | Endpoint configured to receive asynchronous payment notifications.                                                                                                                                                   |

### Generating and Managing Keys

| Key Type             | Purpose                                                                                                 |
| -------------------- | ------------------------------------------------------------------------------------------------------- |
| Payment API Secret   | Used for signature generation and verification in payment APIs. Keep this secret secure on your server. |
| Authorization Secret | Used exclusively for signature generation and verification in authorization APIs.                       |

**Important:** Any API that uses asynchronous notifications requires a valid callback URL to be configured; otherwise, notifications cannot be delivered. For details on how to verify incoming callbacks, see [Authentication and Security](/essentials/version/100/en/authenticationSecurity).

### Core Integration Credentials

| Credential           | Description                                                                       |
| -------------------- | --------------------------------------------------------------------------------- |
| `ClientId`           | Unique application identifier used to identify your requests.                     |
| Payment API Secret   | Server-side key for signing payment API requests.                                 |
| Authorization Secret | Server-side key for signing authorization API requests (authorization APIs only). |

For detailed instructions on using these credentials, refer to the [Authentication and Security](/essentials/version/100/en/authenticationSecurity) guide.

### SDK Support

GatePay provides an official SDK for Go:

| SDK            | Details                                                                                          |
| -------------- | ------------------------------------------------------------------------------------------------ |
| gatepay-sdk-go | Available for Go 1.21 and above. [View on GitHub](https://github.com/gatepay2025/gatepay-sdk-go) |

If an API does not yet have SDK support, integrate directly using the REST API endpoints described in this documentation.

## Supported Payment Networks and Currencies

### Blockchain Networks and Supported Cryptocurrencies

The following networks and tokens are supported for address-based payments:

| Blockchain Network       | Supported Currencies      |
| ------------------------ | ------------------------- |
| Ethereum / ERC20         | DAI, ETH, POL, USDC, USDT |
| Polygon                  | DAI, POL, USDC, USDT      |
| Arbitrum One / ERC20     | USDC, USDT                |
| BNB Smart Chain / BEP20  | USDT                      |
| Solana                   | SOL, USDC, USDT           |
| Tron / TRC20             | USDT                      |
| Bitcoin BRC20 / Ordinals | BTC                       |

### Supported Currencies for Other Payment Channels

The following cryptocurrencies and digital assets are supported across other payment methods:

BTC, USDT, USD, GT, ETH, EOS, DOGE, DOT, SHIB, LTC, ADA, BCH, FIL, ZEC, BNB, UNI, XRP, STEPG, SUPE, LION, FROG

## Next Steps

* For authentication details and request signing, see [Authentication and Security](/essentials/version/100/en/authenticationSecurity)
* For payment API integration, refer to your specific payment flow documentation
* For error handling and best practices, consult the error codes and troubleshooting guide


Built with [Mintlify](https://mintlify.com).