Sandbox Environment - Gate Pay DOCS

The sandbox is an environment isolated from production for API integration testing and flow validation. No real funds are transferred.

Sandbox data is test data only. Sandbox credentials and production credentials cannot be used interchangeably.

Environment URLs

Environment	Base URL	Description
Sandbox	`https://openplatform-sandbox.gateapi.io`	Testing and integration
Production	`https://openplatform.gateapi.io`	Production environment with real fund movements

Unless otherwise stated, API paths, signing rules, and response structures are the same as in production.

Quick Start

Step	Action
1. Register or sign in	Open the Sandbox Merchant Console and register or sign in with email verification.
2. Obtain credentials	Get your `ClientId` and Payment API Secret in the merchant console, then configure a callback URL. See Merchant Access.
3. Call APIs	Use the sandbox base URL to call the target APIs. Verify query APIs first, then create test orders or static payment QR codes. See Quickstart.
4. Simulate payment	Trigger a simulated payment from the order details page, checkout page, or static payment QR code list to verify status transitions.
5. Verify callbacks	Confirm that webhook signature verification, idempotency, and status synchronization work correctly.

Currently Supported APIs

Continuously expanding，API capabilities are released in phases. Refer to this list before integration testing.

Module	API capability	API path
Customer Management	Create customer	`/v1/pay/channelmanage/save`
	Query customer	`/v1/pay/channelmanage/list`
	Update customer	`/v1/pay/channelmanage/update`
	Delete customer	`/v1/pay/channelmanage/delete`
Static Address / Static Payment QR Code	Query supported networks and currencies	`/v1/pay/fixedaddress/chains`
	Create a static payment address	`/v1/pay/fixedaddress/save`
	Create a static payment address on an EVM network	`/merchant/open/v1/pay/fixedaddress/evm/save`
	Query static payment address list	`/v1/pay/fixedaddress/list`
	View static payment address details	`/v1/pay/fixedaddress/detail`
	Delete static payment address	`/v1/pay/fixedaddress/delete`
	Query static payment QR code bill list	`/v1/pay/fixedaddress/order/query`
Checkout	Create checkout order	`/v1/pay/checkout/order`
Checkout	Query checkout order details	`/v2/pay/order/query`
Address Payment	Query supported chain list	`/v1/pay/address/chains`
	Query supported currency list	`/v1/pay/address/currencies`
	Query currencies available for conversion by order currency	`/v1/pay/address/supportedconvertcurrencies`
	Create order	`/v1/pay/address/create`
	Query payment order details	`/v1/pay/address/query`
	Query on-chain transaction details	`/v1/pay/address/transactiondetail`
	Verify address payment callbacks	Subject to the current sandbox callback configuration

Simulation Capabilities

The sandbox does not provide real clearing or settlement. Payments and refunds are triggered through simulation entry points only to verify status transitions and callbacks.

Business	Simulation	Entry point
Collection	Payment	Order details page Checkout page (checkout orders only)
Static Payment QR Code	Payment	Static payment QR code list
Refund	Refund	Collection order details page

Webhooks

Notification payloads, signing methods, and retry rules are the same as in production. Trigger callbacks with simulated payments or refunds to validate signature verification and idempotent processing. See Notification.

Switch to Production

Change the base URL to https://openplatform.gateapi.io
Replace sandbox ClientId and API Secret with production credentials
Configure the production callback URL
Confirm that signing, signature verification, idempotency, and callback retry logic have passed testing
Complete a small real-order validation

​Environment URLs

​Quick Start

​Currently Supported APIs

​Simulation Capabilities

​Webhooks

​Switch to Production