Introduction

Merchant call this api for query order status and order information.

Domains

Test Environment: https://openapi-test.alchemypay.org/open/api/v4/merchant/query/trade

Prod Environment: https://openapi.alchemypay.org/open/api/v4/merchant/query/trade

API Description

Request Method: GET

Content-Type: application/json

Request Parameters

Header Parameters:

Element	Mandatory	Data Type	Remarks
appid	Y	string	Partner unique ID; once a merchant has been on-boarded with Alchemy Pay, the merchant will be provided with the credentials with appId and appSecret
timestamp	Y	string	UTC time with 13 digits to represent time in milliseconds, the expiration period is 5 minutes.
sign	Y	string	Signature, you can refer to the signature here

Url Parameters:

Element	Mandatory	Data Type	Remarks
orderNo	N	string	AlchemyPay order No.
merchantOrderNo	N	string	Merchant defined order No.
side	Y	string	onramp=`BUY` offramp=`SELL`

Request Parameter Example:

https://openapi-test.alchemypay.org/merchant/query/trade?orderNo=1028577684629876736&side=BUY

Response Parameters

Order Status List：Order Status List

Response Parameter Example (Onramp FINISHED):

{
    "payTime": "2025-09-19 15:07:07",
    "txTime": "2025-09-19 15:09:06",
    "networkFee": "0",
    "rebateFiatAmount": "",
    "rawRampFee": "67.500000",
    "fiatInUSD": "52.52",
    "network": "TRX",
    "tokenAddress": "",
    "cryptoPrice": "57.97340000",
    "payType": "GCASH",
    "rampFee": "67",
    "appId": "Y0Bo*************4d9",
    "fiat": "PHP",
    "txHash": "13528*******************20",
    "rampFeeInUSD": "1.18",
    "side": "BUY",
    "amount": "3000.00000000",
    "orderNo": "1418493255*******368",
    "address": "33************402",
    "cryptoNetworkFee": "0",
    "networkFeeInUSD": "0",
    "cryptoAmountInUSDT": "51.3387",
    "rebateUsdAmount": "",
    "crypto": "USDT",
    "rampFeeUnit": "PHP",
    "cryptoQuantity": "50.58",
    "createTime": "2025-09-19 15:05:46",
    "alpha2": "PH",
    "status": "FINISHED" //PENDING, PAY_FAIL, PAY_SUCCESS, TRANSFER, CANCEL, FINISHED, RISK_CONTROL, REFUNDED
}

Response Parameter Example (Onramp CANCEL):

{
    "side": "BUY",
    "amount": "10000000.00000000",
    "orderNo": "1430024836573***808",
    "address": "4417****81",
    "payTime": null,
    "networkFee": "0",
    "rebateFiatAmount": "",
    "rawRampFee": "0.000000",
    "rebateUsdAmount": "",
    "crypto": "USDT",
    "network": "TRX",
    "rampFeeUnit": "IDR",
    "tokenAddress": "",
    "cryptoPrice": "0.00000000",
    "payType": "QRIS",
    "rampFee": "0.000000",
    "cryptoQuantity": "0",
    "createTime": "2025-10-21 10:48:09",
    "appId": "Y0Bokk4*******d9",
    "alpha2": "ID",
    "fiat": "IDR",
    "rampFeeInUSD": "0.00",
    "status": "CANCEL"
}

Response Parameter Example (Offramp payment success):

{
    "orderNo": "14299852026****4016",
    "address": "9YRd7dQ6hT********ZJxFCTMeJg9g3NiNCgr", // wallet address user need to transfer
    "payTime": "2025-10-21 08:12:21", // transfer fiat start time
    "completeTime": "2025-10-21 08:12:20", // block confirm time
    "merchantOrderNo": "20251021000847*******999611838464",
    "crypto": "USDT",
    "network": "SOL",
    "cryptoPrice": "1.0000000000", // fiat
    "cryptoAmount": "749.6250370000",
    "fiatAmount": "643.2326269410", //fiat amount contains ramp fee
    "appId": "jO8459********d",
    "fiat": "EUR",
    "txHash": "67Aoy5iRfd2Tpdto4i79uC7ztBxR8qrwN*********8wKcZS7MMjbrbiDN2FoLCSSVfBUL9hCU",
    "email": "A********[email protected]",
    "status": "4", // 1：order create success  2：user transfered token  3：start to pay fiat to user  4：payment success 5：payment fail 6：refund success 7：order expired
    "orderAddress": "https://ramp.alchemypay.org/#/sellOrder?sellOrderId=1429985********016", // order detail page
    "cryptoActualAmount": "748.9874010000",
    "rampFee": "19.8700000000", // fiat
    "receiptTime": "2025-10-21 08:16:05", //transfer fiat success time
    "paymentType": "10010",  //  10010 banktransfer
    "name": "Alfred *********",
    "account": "************7963",
    "fiatRate": "0.8588030000"
}

Response Parameter Example (Offramp order timeout):

{
    "orderNo": "142933363********",
    "address": "0x613929***********c674b823e0091aa55",
    "merchantOrderNo": "2*************73372451934208",
    "crypto": "USDT",
    "network": "ETH",
    "cryptoPrice": "1.0000000000",
    "cryptoAmount": "40.0000000000",
    "fiatAmount": "40.0000000000",
    "appId": "************Ed",
    "fiat": "USD",
    "email": "**********[email protected]",
    "status": "7",
    "orderAddress": "https://ramp.alchemypay.org/#/sellOrder?sellOrderId=14293336**********",
    "cryptoActualAmount": "0.0000000000",
    "rampFee": "0.0000000000",
    "paymentType": "10010",
    "name": "R****y G******",
    "account": "************3286",
    "fiatRate": "1.0000000000"
}