介绍

通过下单接口生成订单，返回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	1. 指定支付数币，可以传输多个数币 2. 转账后，用户只能使用列出的数币进行支付 3. 必须包含在商户配置的数币表中 4. 适用于转账和交易所查看支持的网络
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"
}

响应代码

参考返回码说明