Common
Balance
Payment
OTC
Convert
Payout
Gift Card
Subscription
curl --request POST \
--url https://openplatform.gateapi.io/payment/open/institution/v1/pay/convert \
--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 '
{
"clientReqId": "181147",
"sellCurrency": "GT",
"buyCurrency": "USDT",
"buyAmount": "1",
"sellAmount": "0.04464002",
"quoteId": "PAY-2a5743d8"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"order_id": "327196066546229248",
"userId": 10002,
"sellCurrency": "GT",
"buyCurrency": "USDT",
"sellAmount": "0.04464002",
"buyAmount": "1",
"status": 1,
"rate": 22.40142365527614,
"quoteId": "PAY-2a5743d8",
"createTime": 1739971221273
}
}Create Convert Order
Initiate convert.
curl --request POST \
--url https://openplatform.gateapi.io/payment/open/institution/v1/pay/convert \
--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 '
{
"clientReqId": "181147",
"sellCurrency": "GT",
"buyCurrency": "USDT",
"buyAmount": "1",
"sellAmount": "0.04464002",
"quoteId": "PAY-2a5743d8"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"order_id": "327196066546229248",
"userId": 10002,
"sellCurrency": "GT",
"buyCurrency": "USDT",
"sellAmount": "0.04464002",
"buyAmount": "1",
"status": 1,
"rate": 22.40142365527614,
"quoteId": "PAY-2a5743d8",
"createTime": 1739971221273
}
}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/convert endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.
Notes
- Authentication uses the standard GatePay signed headers.
- This page documents the standard merchant endpoint.
- For shared signing rules, see /api-reference/version/100/en/common/securityAndSignature.
Headers
Merchant client ID assigned when registering the application
"mZ96D37oKk-HrWJc"
Request signature for verification
"8504fe097f7297f8952c76e628ce59dbc93d1df64c95f26c73140ef365d4aa1471826ada0534315461682ec35c131d7e133c51d2ab0822fe7366650a111887ba"
UTC timestamp in milliseconds
"1740019013818"
Random string, recommended length within 32 characters
"9722139164"
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
Client request ID (randomly generated by the user to ensure idempotency)
Quote ID (must match the one returned by the preview interface)
Purchase amount (must match the one returned by the preview interface)
Purchase currency (must match the one returned by the preview interface)
Sell amount (must match the one returned by the preview interface)
Sell currency (must match the one returned by the preview interface)