介绍

通过下单接口生成订单，返回web url，用户前端打开支付

接口说明

请求方式: POST

请求路径：open/api/payment/V2

注意事项：必须保留响应中的orderNo，它是用于订单查询的唯一标识符。

参数

请求参数

参数名	签名	必传	类型	长度	备注
appId	Y	Y	string	64	商户的唯一标识符
sign	N	Y	string	256	签名
merchantOrderNo	Y	Y	string	64	客户交易ID，仅限数字
orderAmount	Y	Y	string	64	订单金额（单位为元）
payCurrency	Y	Y	string	64	支付货币
userId	Y	Y	string	128	用户的唯一标识符（邮箱 / 手机号码）
paymentTokens	Y	N	string	128	指定支付数币，可以传输多个数币转账后，用户只能使用列出的数币进行支付必须包含在商户配置的数币表中适用于转账和交易所查看支持的网络
redirectURL	N	N	string	512	成功购买后的重定向地址
callbackURL	N	N	string	512	接收订单Webhook的地址
customParam	N	N	string	512	商户自定义参数
expiredTime	N	N	string	32	超时时间（秒），不大於172800秒
payType	N	N	string	32	支付方式
paymentNetworks	N	N	string	32	指定支付网络，逗号分隔，查看支持的网络
orderModel	N	N	string	32	（ORDER/ RECHARGE），传参必须大写。订单模式说明

支付方式

支付方式	支付方式编码/payType
二维码收单	WALLET
币安支付	BINANCE_PAY

支持的法币（payCurrency）:

法币	正则	范例
USD	小数点后两位非零小数	100.12
EUR	小数点后两位非零小数	100.12
HKD	小数点后两位非零小数	100.12
IDR	整数位	1000
THB	整数位	1000
VND	整数位	1000

请求示例：

{
    "appId": "TEST000001",
    "callbackURL": "https://90fc-111-10-154.ngrok-free.app/v1/xxxxx",
    "expiredTime": "60",
    "merchantOrderNo": "17236123450000",
    "orderAmount": "100",
    "orderModel": "ORDER",
    "payCurrency": "USD",
    "paymentTokens": "ETH",
    "redirectURL": "https://50xxxxx832.vicp.fun/platform/xxxxx",
    "sign": "07572BA8F945685E6BB57FC21FDE74E7217A015E00FD56176F3A500465817B33FAC086DA7887AC266BA8518960F0FE208DE1A8E105978B185A8D136DD0F6",
    "userId": "[email protected]"
}

响应参数说明

参数名	类型	详情
success	boolean	是否成功
error	boolean	是否出错
code	long	响应代码
msg	string	响应消息
traceId	string	追踪 ID
model	object	响应详细信息
checkout address	string	收銀台网址

响应示例

{
    "code": "0",
    "model": {
        "orderNo": "300217236173748123456",
        "webUrl": "https://crypto-payment.alchemypay.org?orderNum=30012345678923456"
    },
    "msg": "success",
    "traceId": "66bc505e9f97eafb6ca69d123471cb"
}

响应代码

参考返回码说明