Common
Balance
Institution
Payment
OTC
Convert
Payout
Gift Card
Subscription
curl --request POST \
--url https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/create \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"merchantTradeNo": "93840202212210025",
"env": {
"terminalType": "MINIAPP"
},
"goods": {
"goodsName": "USDT_PAY_BTC_TEST",
"goodsDetail": "yc"
},
"orderExpireTime": 1673410179000,
"merchantUserId": 1336974,
"chain": "BSC",
"fullCurrType": "BTC_BSC"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"prepayId": "47656656276819968",
"terminalType": "MINIAPP",
"expireTime": 1673410179000,
"chain": {
"chain_type": "BSC",
"fullCurrType": "USDT_BSC",
"address": "0x1699dB45Dc502A0395038265fCBC4Fa05d6afFBD"
}
}
}Create Address Payment Order
Create an order. When the order currency and payment currency are consistent, create a direct address payment order; if the order currency and payment currency are inconsistent, create a convert address payment order.
curl --request POST \
--url https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/create \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"merchantTradeNo": "93840202212210025",
"env": {
"terminalType": "MINIAPP"
},
"goods": {
"goodsName": "USDT_PAY_BTC_TEST",
"goodsDetail": "yc"
},
"orderExpireTime": 1673410179000,
"merchantUserId": 1336974,
"chain": "BSC",
"fullCurrType": "BTC_BSC"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"prepayId": "47656656276819968",
"terminalType": "MINIAPP",
"expireTime": 1673410179000,
"chain": {
"chain_type": "BSC",
"fullCurrType": "USDT_BSC",
"address": "0x1699dB45Dc502A0395038265fCBC4Fa05d6afFBD"
}
}
}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 page documents thePOST /payment/open/institution/v1/pay/address/create endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.
Create an order. When the order currency and payment currency are consistent, create a direct address payment order; if the order currency and payment currency are inconsistent, create a convert address payment order.
Notes
- Authentication uses the standard GatePay signed headers.
- This page documents the institution-path variant of the same API.
- Institution requests must include
X-GatePay-On-Behalf-Ofto indicate the delegated account context; for institution merchant APIs, this is typically the target sub-account ID. - For shared signing rules, see /api-reference/version/100/en/common/securityAndSignature.
Headers
Merchant client ID, obtained from GatePay platform
HMAC-SHA256 signature for request validation
Timestamp in milliseconds, must not differ from server time by more than 5 minutes
Random nonce for replay attack prevention
Required delegated-subject header. Provide the initiating account ID for this request. For institution merchant APIs, this is typically the target sub-account ID; for institution charge and transfer APIs, it can be either an institution account ID or a sub-account ID.
Body
Request for creating a payment order.
Merchant transaction ID in the merchant's system.
Transaction source, optional values: APP, WEB, WAP, MINIAPP, OTHERS.
Show child attributes
Show child attributes
Goods.
Show child attributes
Show child attributes
Merchant-specified expiration time of the order, in milliseconds.
Unique consumer ID from the merchant’s platform.
Selected chain name.
Currency field that includes the chain name and corresponds to the specific currency on the specific chain.
Crypto order currency.
Crypto order amount.
Tolerance Amount：If the remaining unpaid amount is less than or equal to the configured tolerance amount, the order will be automatically marked as Paid, with no further payment required.
Fiat order currency in uppercase form, such as EUR, GBP, USD, CNY, JPY, AUD, CAD, CHF.
Fiat order amount, with a maximum precision of 2 digits.
Surcharge, a fee borne by the consumer.
User-selected payment currency, not required for non-flash payment orders.
Callback URL for payment completion.
Callback URL for payment cancellation.
Client Name.