跳转到主要内容

​
商户入驻与应用配置

​
基础地址

项目值
Service Base URLhttps://openplatform.gateapi.io
本文档中的所有 API 路径都需要与基础地址拼接后，形成完整请求 URL。

​
创建并配置应用

请按以下步骤在 GatePay 商户门户中完成应用配置：
步骤操作
1登录 GatePay 商户门户，完成商户注册和初始化配置。
2填写所需的业务信息并提交商户申请。
3进入应用配置页面，创建或配置新的应用。
4Retrieve your ClientId from the 应用 list.
5按需配置回调地址，用于接收异步通知。

​
Configuration Credentials

After completing app configuration, you will receive the following credentials:
Credential说明
ClientIdUnique identifier for your 应用. Used in all API requests via the X-GatePay-Certificate-ClientId header (see 认证与安全 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).
回调 URL接口 configured to receive 异步 payment 通知s.

​
Generating and Managing Keys

Key 类型Purpose
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 异步 通知s requires a valid 回调 URL to be configured; otherwise, 通知s cannot be delivered. For details on how to verify incoming 回调s, see 认证与安全.

​
Core Integration Credentials

Credential说明
ClientIdUnique 应用 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 认证与安全 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 币种

​
Blockchain Networks and Supported Cryptocurrencies

The following networks and tokens are supported for address-based payments:
Blockchain NetworkSupported 币种
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

​
支持的币种 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 步骤

  • For authentication details and request signing, see 认证与安全
  • For payment API integration, refer to your specific payment flow documentation
  • For error handling and best practices, consult the error codes and troubleshooting guide