Skip to main content

创建内部钱包支付订单

#简要描述: 内部钱包扫码人民币充值业务接口,用户通过扫描二维码来完成充值 CNY 到他们的钱包账户

创建支付订单

请求参数
参数名称类型必填参数含义参数说明
keystring商户 key平台分配商户 key
localOrderIdstring商户平台订单号商户生成唯一订单号
localUserIdstring平台分配商户商户号
amountnumber收款金额订单金额(支持小数点后 6 位)
notifyUrlstring回调地址用户下发成功后,由 API 回调商户的地址 | (必填;如不接回调;请填写英文 none)
timestampLong时间戳(秒)获取当前时间毫秒数,除以 1000 转换为秒
successRedirectUrlstring地址成功后自动跳转地址
currencystring订单币种订单币种(CNY、USDT、TRX、USD)
signstring签名详情见签名算法
请求 json 样例
{
"key": "PZuzmBAeA8KzeglX",
"localOrderId": "1762",
"localUserId": "75",
"successRedirectUrl": "www.baidu.com",
"timestamp": 1730987293,
"notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify",
"amount": 1,
"currency": "CNY",
"successRedirectUrl": "www.baidu.com",
"sign": "c73d8b0c89024aad3d9937f64bb9b95c"
}

支付返回 json 格式

返回 data 示例
{
"code": 0,
"success": true,
"message": "string",
"data": {
"orderId": "2023102400684344447",
"localUserId": "302199873005",
"localOrderId": "2023102400684344447",
"orderType": "PAYMENT",
"orderBizType": "PAYMENT_WALLET_SCAN",
"paymentUrl": "http://api.wallet.dx.com/scan-pay-front/SAjuzkzzbkfjWewEmCMrTnHdvox1FcgUBcdJ9dSoULwa8Y22hQcQr4szdLkc"
}
}

返回的 paymentUrl 弹出支付页面,如下图:

img

data 参数说明
参数名称类型必填参数含义**备注
orderIdstring订单 ID
localUserIdstring商户号
localOrderIdstring商户本地订单号
orderTypeenum订单类型PAYMENT:支付订单 WITHDRA:提款订单
orderBizTypeenum订单业务orderBizType 类型说明如下
paymentUrlstring地址支付地址
publicKeystring秘钥公共访问密钥

orderBizType 类型说明:

1、PAYMENT_WALLET_SCAN 点付钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至点付钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付

回调返回 json 数据

默认所有回调参数参与验签,回调参数详情请看回调

回调 data
{
"amount": 11,
"bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
"currency": "CNY",
"key": "h3cS7dBltRU4W1wD",
"localOrderId": "2820",
"merchantActualAmount": 8.86,
"merchantCurrency": "CNY",
"merchantId": 303122065665,
"merchantPaidAmount": 10.98,
"merchantUserId": "97",
"notifyTime": 1731572168370,
"orderCreateTime": 1731572133082,
"orderId": "273124814912907",
"sign": "699806308a9e055114c378671b0d2a15",
"status": "SUCCESS",
"type": "PAYMENT",
"userAmount": 1.55,
"userCurrency": "USDT"
}