介绍

该接口用于创建订单。

❗️该接口只能在服务端被调用

接口说明

请求方式：POST

请求路径：/open/api/v4/merchant/trade/create

请求参数

Header参数：

参数名	必选	类型	说明
access-token	Y	string	免登录 accessToken 值，可以从免登录获取 token 接口获取
appId	Y	string	应用的唯一标识
timestamp	Y	string	当前 UTC 13 位时间戳, 5 分钟内有效
sign	Y	string	签名，签名方式可参考这里

Body参数：

参数名	必选	类型	说明
side	Y	string	传入BUY
merchantOrderNo	Y	String	接入商家自定义订单号，商家保证唯一。
amount	Y	String	法币购买金额，单位元；需要根据法币精度控制位数，精度为0表示整数，精度为2表示保留两位小数。精度参见：基础数据-法币币种及支付方式
fiatCurrency	Y	string	法币名称，USD/EUR等
cryptoCurrency	Y	string	数字货币名称，举例：USDT
depositType	Y	int	固定传2
address	Y	string	用户接收数字货币的地址
network	Y	string	crypto接收网络：eg：ETH/BSC/BTC等
payWayCode	Y	string	支付方式代码：具体值可以参照基础数据-法币支付方式
redirectUrl	N	string	买币成功后页面跳转地址
callbackUrl	N	string	买币成功后回调地址
memo	N	string	注意：BNB网络memo参数必传。
failRedirectUrl	N	string	买币fail后页面跳转地址，如果不传入，则支付失败也会跳转至redirectUrl
merchantName	N	string	商户名称，如果传入，会在支付结果页面展示商户名称

请求参数示例：

{
    "side": "BUY",
    "cryptoCurrency": "USDT",
    "address": "TRqyVJbztwVhxJqHKZD6D8LxYk5cubfmvu",
    "network": "TRX",
    "fiatCurrency": "USD",
    "amount": "100",
    "depositType": 2,
    "payWayCode": "10001",
    "alpha2": "US",
    "redirectUrl": "http://payment.jyoumoney.com/alchemy/payResultPage/DZ02207121427022754",
    "callbackUrl": "http://payment.jyoumoney.com/alchemyRamp/pay/callback?tradeNo=DZ02207091800356504"
}

响应参数

参数名	类型	说明
success	boolean	请求是否成功
returnCode	string	响应状态码。查看状态码列表
returnMsg	string	响应状态码说明
extend	string	预留字段
data	object
└─orderNo	string	订单号
└─payUrl	string	支付链接。用户可以通过该链接跳转到支付页面进行支付。
traceId	string	请求追踪和调试的唯一标识符。发生异常时，提供此字段帮助排查问题。

返回参数示例：

{
	"success": true,
	"returnCode": "0000",
	"returnMsg": "SUCCESS",
	"extend": "",
	"data": {
		"orderNo": "1365991772645670912",
		"payUrl": "https://ramptest.alchemypay.org/#/paymentMethod?token=ACH6358132607%40ACH%40LocUuBefJ31tsddfeFpZYw%3D%3D%40PAY%40gnO%2FRpNs1LnnVOyVmTNV4g%3D%3D%40IO%40sXBn%2BxFUqSUy%2FERXZCJOtnxeX8RJWuUrnl88soRP%2FeMQvZ3WzsHHBSOaEaJCaB8Hn9gKGJ1OQqURmnvJekYk2A%3D%3D&email=gnO%2FRpNs1LnnVOyVmTNV4g%3D%3D&orderNo=1365991772645670912&id=LocUuBefJ31tsddfeFpZYw%3D%3D&cardFlag=true"
	},
	"traceId": "680e00f9e3020d69a990c9e7c23693ec"
}