API 文档

# 2、加密兑换法币

请求方式

  • POST

URL：

/api/v1/exchange/express/trade/sell

请求头 Header

Content-Type: application/json; charset=utf-8

请求头参数说明

参数名 类型 描述 示例值
access_key String 商户后台获取的访问密钥 pFqV75X3
timestamp int64 13 位毫秒时间戳 1679724896223
nonce String UUID V4 随机字符串 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign String 计算生成的签名值 kAXyh+eerqrefyaF8dyFB0M4FVo=

所有参数需放入 Header 中发送，签名生成请参考数据签名规范。

请求示例 BRL：

{
	"externalOrderId": "20250513192316237779",
	"chainType": "BSC",
	"tokenType": "USDT",
	"tokenAmount": "10.214234221423422312",
	"currencyType": "BRL",
	"payType": "PIX",
	"userInfoType": "CNPJ",
	"userInfoNo": "05598146333",
	"userInfoName": "Jaime de",
	"accountType": "EMAIL",
	"accountNo": "[email protected]",
	"remark": "yuri test",
	"notifyUrl": "https://test/testNotifySuccess"
}

请求参数说明

参数名 类型 是否必填 描述
externalOrderId String 是 商户订单号
chainType String 是 链类型 BSC
tokenType String 是 代币类型 USDT
tokenAmount String 是 代币数量
currencyType String 是 法币类型 BRL
payType String 是 支付类型 PIX
userInfoType String 否 用户信息类型 CPF CNPJ
userInfoNo String 否 用户信息编号
userInfoName String 否 用户名称
accountType String 否 账户类型 CPF CNPJ PHONE EMAIL EVP
accountNo String 否 账户号
remark String 否 交易备注
notifyUrl String 否 异步通知回调地址（建议公网地址）

响应示例

响应 Header 类型

Content-Type: application/json; charset=utf-8

响应数据（成功）

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": {
		"chainType": "BSC",
		"currencyAmount": "57.31",
		"tokenAmount": "10.214234221423422312",
		"currencyType": "BRL",
		"tokenType": "USDT",
		"externalOrderId": "20250513192316237779",
		"orderId": "OEXCHEXCH202505131123171747135397709-U0000000401298841",
		"tradeType": "SELL",
		"addressTo": "0x369b87cbd5851b00c297fdcc461a68d0811ae5ae",
		"exchangePrice": "5.611",
		"orderFee": "1.15",
		"cashierUrl": "http://crypto/OEXCHEXCH202505131123171747135397709-U0000000401298841"
	}
}

响应字段说明

Param Type Desc
chainType String 主链
currencyAmount String 法币金额
tokenAmount String 代币金额
currencyType String 法币类型
tokenType String 代币类型
externalOrderId String 商户订单号
orderId String 订单号
tradeType String 交易类型
addressTo String 地址
exchangePrice String 汇率
orderFee String 手续费
cashierUrl String 兑换收银台链接

请求示例 INR：

{
	"externalOrderId": "20250513184349208965",
	"chainType": "BSC",
	"tokenType": "USDT",
	"tokenAmount": "1",
	"currencyType": "INR",
	"payType": "BANK",
	"userInfoNo": "UTIB0001617",
	"userInfoName": "joy",
	"accountName": "BandhanBank",
	"accountNo": "000000",
	"remark": "test",
	"notifyUrl": "https://test/testNotifySuccess"
}

请求参数说明

参数名 类型 是否必填 描述
externalOrderId String 是 商户订单号
chainType String 是 链类型 BSC
tokenType String 是 代币类型 USDT
tokenAmount String 是 代币数量
currencyType String 是 法币类型 INR
payType String 是 支付类型 BANK
userInfoNo String 否 用户信息编号
userInfoName String 否 用户名称
accountName String 否 账户名称
accountNo String 否 账户号
remark String 否 交易备注
notifyUrl String 否 异步通知回调地址（建议公网地址）

响应示例

响应 Header 类型

Content-Type: application/json; charset=utf-8

响应数据（成功）

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": {
		"chainType": "BSC",
		"currencyAmount": "93.61",
		"tokenAmount": "1",
		"currencyType": "INR",
		"tokenType": "USDT",
		"externalOrderId": "20250513184349208965",
		"orderId": "OEXCHEXCH202505131043501747133030606-U0000000401298826",
		"tradeType": "SELL",
		"addressTo": "0x6871d4c9146d9d8d17ce540340989838064e783d",
		"exchangePrice": "93.6169",
		"orderFee": "1.16",
		"cashierUrl": "http://crypto/OEXCHEXCH202505131043501747133030606-U0000000401298826"
	}
}

响应字段说明

Param Type Desc
chainType String 主链
currencyAmount String 法币金额
tokenAmount String 代币金额
currencyType String 法币类型
tokenType String 代币类型
externalOrderId String 商户订单号
orderId String 订单号
tradeType String 交易类型
addressTo String 地址
exchangePrice String 汇率
orderFee String 手续费
cashierUrl String 兑换收银台链接

← 3、报价 →