Card Deposit Interface

Brief description:Deposit (recharge)

Please note:

  1. The currency and network used for the transfer must match the order; otherwise, it may fail.
  2. If the order amount is less than the payment amount, the payment will be made according to the order amount, and the transaction fee will be calculated based on the order fee. If the order amount is greater than the payment amount, the recharge will be made according to the payment amount, and transaction fee still based on the order fee.
  3. Supported networks and currencies are TRX-USDT, BSC-USDT, ETH-USDT, SOL-USDT, TRX-USDC, BSC-USDC, ETH-USDC.

Environmental Information

Test environment domain name: https://sbx-card-api.alchemypay.org

Production environment domain name: https://card-api.alchemypay.org

Request URL:

/open/merchant/api/cardDeposit

Request Method:

  • post
  • Content-Type: application/json

Request Parameters:

ParameterSignRequiredTypeLengthDescription
appIdYesYesString32Merchant app ID
cardIdYesYesString32Card ID
orderNoYesYesString64Custom client transaction serial ID
amountYesYesLong32Crypto order amount (integer part)
cryptoCurrencyYesYesString12Crypto currency code
networkYesYesString32Network
signNoYesString512Signature

Request Example:

{
"appId": "qmamnbodyqzbdr0w",
"orderNo": "test00001",
"amount": "15",
"cardId": "c_48c7125626a84d3a82e1",
"cryptoCurrency": "USDT",
"network": "ETH",
"sign": ""
}

Response Parameters

ParameterTypeDescription
successBooleanSuccess flag
errorBooleanError flag
msgStringProcessing message
codeIntegerReturn code
+modelObjectReturned data object data
└ tradeNoStringTransaction number
└ addressStringTransfer address
└ expiredTimeStringOrder timeout time (seconds)

Response Example:

{
"success": true,
"error":false,
"msg": "Success",
"code": 0,
"model": {
"tradeNo": "123133213131313131",
"address":"0xa6d057a1e3d807c31233b2e5892efc5672a24b61"
},
"traceId": 1646648711017
}

Note:

For more error codes, please refer to the error code description on the homepage.