纯API接入

介绍

商户使用此接口可以在crypto payment直接下单,用户毋须使用ACH的收银台支付。

接口说明

请求方式: POST

请求路径: open/api/address/payment

请求参数

Body参数:

参数参与签名必填类型长度说明
appIdYYstring64商户的唯一标识符
signNYstring256签名
merchantOrderNoYYstring64客户交易ID,仅限数字
orderAmountYYstring64订单金额(单位为元)
payCurrencyYYstring64支付货币 (查看 支持法币)
userIdYYstring128用户的唯一标识符(邮箱 / 手机号码)
paymentTokensYNstring1281. 指定支付数币,可以传输多个数币 2. 转账后,用户只能使用列出的数币进行支付 3. 必须包含在商户配置的数币表中 4. 适用于转账和交易所
userIpNYstring32用戶 IP 地址
paymentNetworksNYstring32指定支付网络,逗号分隔
callbackURLNNstring512接收订单Webhook的地址
customParamNNstring512商户自定义参数
expiredTimeNNstring32超时时间(秒),不大於172800秒
orderModelNNstring32(ORDER/ RECHARGE),传参必须大写

支付方式

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

支持的法币(payCurrency)

法币正则范例
USD小数点后两位非零小数100.12
EUR小数点后两位非零小数100.12
HKD小数点后两位非零小数100.12
IDR整数位1000
THB整数位1000
VND整数位1000
Token Name(USDT)配置单位使用的token,小数点后8位非零1.12345678

请求示例

{
    "appId":"TEST000001",
    "sign":"TEST000001",
    "merchantOrderNo":"131222222222344345",
    "userId":"[email protected]",
    "orderAmount":"1",
    "payCurrency":"USDT",
    "paymentNetworks":"ETH",
    "paymentTokens":"USDT",
    "userIp":"106.37.115.196",
    "expiredTime":"7200",
    "callbackURL":"http://test.crypto.payment/open/api/callback",
}

响应参数说明

参数名类型详情
successboolean成功
errorboolean出错
codelong响应代码
msgstring响应消息
traceIdstring追踪 ID
modelobject响应详细信息

响应示例

{
    "code": "0",
    "msg": "success",
    "model": {
        "address": "0x0125a80d8d58b3ae6b5abb042fd720d0b76db122",
        "orderNo": "300217292428921960389"
    },
    "traceId": "67122709fa1d0aec01251f21909b4b9f",
    "error": false,
    "success": true
}