Skip to main content

​
Merchant Onboarding and App Configuration

​
Base URL

ComponentValue
Service Base URLhttps://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:
StepAction
1Log in to the GatePay Merchant Portal and complete merchant registration and initial setup.
2Fill in the required business information and submit your merchant application.
3Navigate to the app configuration page and create or configure a new application.
4Retrieve your ClientId from the application list.
5Configure the callback URL as needed to receive asynchronous notifications.

​
Configuration Credentials

After completing app configuration, you will receive the following credentials:
CredentialDescription
ClientIdUnique identifier for your application. Used in all API requests via the X-GatePay-Certificate-ClientId header (see Authentication and Security for details).
Payment API SecretServer-side signing key for payment-related API requests and signature verification.
Authorization SecretServer-side signing key for authorization API requests and signature verification (used only by authorization APIs).
Callback URLEndpoint configured to receive asynchronous payment notifications.

​
Generating and Managing Keys

Key TypePurpose
Payment API SecretUsed for signature generation and verification in payment APIs. Keep this secret secure on your server.
Authorization SecretUsed 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.

​
Core Integration Credentials

CredentialDescription
ClientIdUnique application identifier used to identify your requests.
Payment API SecretServer-side key for signing payment API requests.
Authorization SecretServer-side key for signing authorization API requests (authorization APIs only).
For detailed instructions on using these credentials, refer to the Authentication and Security guide.

​
SDK Support

GatePay provides an official SDK for Go:
SDKDetails
gatepay-sdk-goAvailable for Go 1.21 and above. View on GitHub
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 NetworkSupported Currencies
Ethereum / ERC20DAI, ETH, POL, USDC, USDT
PolygonDAI, POL, USDC, USDT
Arbitrum One / ERC20USDC, USDT
BNB Smart Chain / BEP20USDT
SolanaSOL, USDC, USDT
Tron / TRC20USDT
Bitcoin BRC20 / OrdinalsBTC

​
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
  • For payment API integration, refer to your specific payment flow documentation
  • For error handling and best practices, consult the error codes and troubleshooting guide