# 1、法币兑换加密

请求方式

POST

URL：

/api/v1/exchange/express/trade/buy

Content-Type：

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

请求头参数（Header）

Param	Type	Description	Sample
access_key	String	商户后台获取的访问密钥	pFqV75X3
timestamp	int64	Unix 毫秒时间戳（13 位）	1679724896223
nonce	String	UUID V4 随机字符串	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	String	通过签名算法计算的签名	kAXyh+eerqrefyaF8dyFB0M4FVo=

上述参数全部作为 HTTP Header 传入

# INR

请求体数据示例：

{
	"externalOrderId": "20250513184347329830",
	"chainType": "BSC",
	"tokenType": "USDT",
	"addressTo": "0xa8666442fA7583F783a169CC9F3333333360295E8",
	"tokenAmount": "1",
	"currencyType": "INR",
	"payType": "BANK",
	"remark": "test",
	"notifyUrl": ""
}

参数说明：

1、跳过首屏模式

参数名	类型	是否必填	描述
tokenAmount	String	是	代币金额
externalOrderId	String	是	商户订单号
chainType	String	是	链类型 BSC
tokenType	String	是	代币类型 USDT
addressTo	String	是	地址
currencyType	String	是	货币类型 INR
payType	string	是	支付类型：BANK
notifyUrl	String	否	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
reviewQuote	String	否	是否跳过报价页面：1=是，0=否（默认：0）

2、标准询价模式

参数名	类型	是否必填	描述
tokenAmount	String	否	代币金额
externalOrderId	String	否	商户订单号
chainType	String	是	链类型 BSC
tokenType	String	是	代币类型 USDT
addressTo	String	否	地址
currencyType	String	是	货币类型 INR
payType	string	是	支付类型：BANK
notifyUrl	String	否	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
reviewQuote	String	否	是否跳过报价页面：1=是，0=否（默认：0）

响应类型：

Header: { 'Content-Type': 'application/json;charset=utf-8'}

创建收款响应说明：

正常响应数据示例（HTTP 200）

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": {
		"chainType": "BSC",
		"currencyAmount": "83.2309",
		"tokenAmount": "1",
		"currencyType": "INR",
		"tokenType": "USDT",
		"externalOrderId": "20250513184347329830",
		"orderId": "OEXCHEXCH202505131043481747133028307-U0000000401298824",
		"tradeType": "BUY",
		"exchangePrice": "83.2309",
		"orderFee": "0.0118",
		"bankAccountNumber": null,
		"bankAccountType": null,
		"bankCode": null,
		"bankName": null,
		"cashierUrl": "http://fiat/OEXCHEXCH202505131043481747133028307-U0000000401298824"
	}
}

响应参数说明

参数名	类型	描述
chainType	String	主链
currencyAmount	String	法币金额
tokenAmount	String	代币金额
currencyType	String	法币类型
tokenType	String	代币类型
externalOrderId	String	商户订单号
orderId	String	订单号
tradeType	String	交易类型
bankAccountNumber	String	渠道银行账户号码（根据实际情况使用）
exchangePrice	String	汇率
orderFee	String	手续费
bankAccountType	String	渠道银行账户类型（根据实际情况使用）
bankCode	String	渠道银行代码（根据实际情况使用）
bankName	String	渠道银行名（根据实际情况使用）
cashierUrl	String	兑换收银台链接
payParam	String	支付参数

# BRL

请求体数据示例：

{
	"externalOrderId": "20250513192309317184",
	"chainType": "BSC",
	"tokenType": "USDT",
	"addressTo": "0xa8666442fA7583F783a169CC9F5449333333395E8",
	"tokenAmount": "10.214234221423422312",
	"currencyType": "BRL",
	"payType": "PIX",
	"remark": "test",
	"notifyUrl": ""
}

参数说明：

1、跳过首屏模式

参数名	类型	是否必填	描述
tokenAmount	String	是	代币金额
externalOrderId	String	是	商户订单号
chainType	String	是	链类型 BSC
tokenType	String	是	代币类型 USDT
addressTo	String	是	地址
currencyType	String	是	货币类型 BRL
payType	string	是	支付类型：PIX
notifyUrl	String	否	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
reviewQuote	String	否	是否跳过报价页面：1=是，0=否（默认：0）

2、标准询价模式

参数名	类型	是否必填	描述
tokenAmount	String	否	代币金额
externalOrderId	String	否	商户订单号
chainType	String	是	链类型 BSC
tokenType	String	是	代币类型 USDT
addressTo	String	否	地址
currencyType	String	是	货币类型 BRL
payType	string	是	支付类型：PIX
notifyUrl	String	否	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
reviewQuote	String	否	是否跳过报价页面：1=是，0=否（默认：0）

响应类型：

Header: { 'Content-Type': 'application/json;charset=utf-8'}

创建收款响应说明：

正常响应数据示例（HTTP 200）

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": {
		"chainType": "BSC",
		"currencyAmount": "60.72",
		"tokenAmount": "10.214234221423422312",
		"currencyType": "BRL",
		"tokenType": "USDT",
		"externalOrderId": "20250513192309317184",
		"orderId": "OEXCHEXCH202505131123101747135390221-U0000000401298839",
		"tradeType": "BUY",
		"exchangePrice": "5.944444",
		"orderFee": "0.204284684428468447",
		"bankAccountNumber": null,
		"bankAccountType": null,
		"bankCode": null,
		"bankName": null,
		"cashierUrl": "http://fiat/OEXCHEXCH202505131123101747135390221-U0000000401298839"
	}
}

响应参数说明

参数名	类型	描述
chainType	String	主链
currencyAmount	String	法币金额
tokenAmount	String	代币金额
currencyType	String	法币类型
tokenType	String	代币类型
externalOrderId	String	商户订单号
orderId	String	订单号
tradeType	String	交易类型
bankAccountNumber	String	渠道银行账户号码（根据实际情况使用）
exchangePrice	String	汇率
orderFee	String	手续费
bankAccountType	String	渠道银行账户类型（根据实际情况使用）
bankCode	String	渠道银行代码（根据实际情况使用）
bankName	String	渠道银行名（根据实际情况使用）
cashierUrl	String	兑换收银台链接
payParam	String	支付参数

# MXN

请求体数据示例：

{
	"externalOrderId": "20250513192309317184",
	"chainType": "BSC",
	"tokenType": "USDT",
	"addressTo": "0xa8666442fA7583F783a169CC9F5449333333395E8",
	"tokenAmount": "10.214234221423422312",
	"currencyType": "MXN",
	"payType": "BANK",
	"remark": "test",
	"notifyUrl": ""
}

参数说明：

1、跳过首屏模式

参数名	类型	是否必填	描述
tokenAmount	String	是	代币金额
externalOrderId	String	是	商户订单号
chainType	String	是	链类型 BSC
tokenType	String	是	代币类型 USDT
addressTo	String	是	地址
currencyType	String	是	货币类型 MXN
payType	string	是	支付类型： CASH、PAYCASHRECURRENT、QRIS
notifyUrl	String	否	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
reviewQuote	String	否	是否跳过报价页面：1=是，0=否（默认：0）

2、标准询价模式

参数名	类型	是否必填	描述
tokenAmount	String	否	代币金额
externalOrderId	String	否	商户订单号
chainType	String	是	链类型 BSC
tokenType	String	是	代币类型 USDT
addressTo	String	否	地址
currencyType	String	是	货币类型 MXN
payType	string	是	支付类型： CASH、PAYCASHRECURRENT、QRIS
notifyUrl	String	否	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
reviewQuote	String	否	是否跳过报价页面：1=是，0=否（默认：0）

响应类型：

Header: { 'Content-Type': 'application/json;charset=utf-8'}

创建收款响应说明：

正常响应数据示例（HTTP 200）

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": {
		"chainType": "BSC",
		"currencyAmount": "60.72",
		"tokenAmount": "10.214234221423422312",
		"currencyType": "MXN",
		"tokenType": "USDT",
		"externalOrderId": "20250513192309317184",
		"orderId": "OEXCHEXCH202505131123101747135390221-U0000000401298839",
		"tradeType": "BUY",
		"exchangePrice": "5.944444",
		"orderFee": "0.204284684428468447",
		"bankAccountNumber": null,
		"bankAccountType": null,
		"bankCode": null,
		"bankName": null,
		"cashierUrl": "http://fiat/OEXCHEXCH202505131123101747135390221-U0000000401298839"
	}
}

响应参数说明

参数名	类型	描述
chainType	String	主链
currencyAmount	String	法币金额
tokenAmount	String	代币金额
currencyType	String	法币类型
tokenType	String	代币类型
externalOrderId	String	商户订单号
orderId	String	订单号
tradeType	String	交易类型
bankAccountNumber	String	渠道银行账户号码（根据实际情况使用）
exchangePrice	String	汇率
orderFee	String	手续费
bankAccountType	String	渠道银行账户类型（根据实际情况使用）
bankCode	String	渠道银行代码（根据实际情况使用）
bankName	String	渠道银行名（根据实际情况使用）
cashierUrl	String	兑换收银台链接
payParam	String	支付参数

# VND

请求体数据示例：

{
	"externalOrderId": "YURITEST20250610093847710921",
	"chainType": "BSC",
	"tokenType": "USDT",
	"addressTo": "0xa8666442fA7583F783a169CC9F5449ec660295E8",
	"tokenAmount": "1.1098",
	"currencyType": "VND",
	"payType": "ZALO_PAY",
	"reviewQuote": "",
	"remark": "test",
	"notifyUrl": ""
}

参数说明：

1、跳过首屏模式

参数名	类型	是否必填	描述
tokenAmount	String	是	代币金额
externalOrderId	String	是	商户订单号
chainType	String	是	链类型 BSC
tokenType	String	是	代币类型 USDT
addressTo	String	是	地址
currencyType	String	是	货币类型 VND
payType	string	是	支付类型：BANK BANK_SCAN_CODE CARD_TO_CARD MOMO ZALO_PAY VIETTEL_MONEY
notifyUrl	String	否	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
reviewQuote	String	否	是否跳过报价页面：1=是，0=否（默认：0）

2、标准询价模式

参数名	类型	是否必填	描述
tokenAmount	String	否	代币金额
externalOrderId	String	否	商户订单号
chainType	String	是	链类型 BSC
tokenType	String	是	代币类型 USDT
addressTo	String	否	地址
currencyType	String	是	货币类型 VND
payType	string	是	支付类型：BANK BANK_SCAN_CODE CARD_TO_CARD MOMO ZALO_PAY VIETTEL_MONEY
notifyUrl	String	否	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
reviewQuote	String	否	是否跳过报价页面：1=是，0=否（默认：0）

响应类型：

Header: { 'Content-Type': 'application/json;charset=utf-8'}

创建收款响应说明：

正常响应数据示例（HTTP 200）

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": {
		"chainType": "BSC",
		"currencyAmount": "28854",
		"tokenAmount": "1.1098",
		"currencyType": "VND",
		"tokenType": "USDT",
		"externalOrderId": "YURITEST20250610093847710921",
		"orderId": "OEXCHEXCH202506100138491749519529967U0000000400000253",
		"tradeType": "BUY",
		"payParam": null,
		"exchangePrice": "25999",
		"orderFee": "0.022196",
		"bankAccountNumber": null,
		"bankAccountType": null,
		"bankCode": null,
		"bankName": null,
		"cashierUrl": "http://ramp-cashier.io/fiat/OEXCHEXCH202506100138491749519529967U0000000400000253"
	}
}

响应参数说明

参数名	类型	描述
chainType	String	主链
currencyAmount	String	法币金额
tokenAmount	String	代币金额
currencyType	String	法币类型
tokenType	String	代币类型
externalOrderId	String	商户订单号
orderId	String	订单号
tradeType	String	交易类型
bankAccountNumber	String	渠道银行账户号码（根据实际情况使用）
exchangePrice	String	汇率
orderFee	String	手续费
bankAccountType	String	渠道银行账户类型（根据实际情况使用）
bankCode	String	渠道银行代码（根据实际情况使用）
bankName	String	渠道银行名（根据实际情况使用）
cashierUrl	String	兑换收银台链接
payParam	String	支付参数

← 回调交易结果 2、加密兑换法币 →