自动支付
用户同意授权自动支付之后,在一定限额内,不需要手动授权每一笔交易。适合高频小额场景下使用。
注:此功能有用到你的应用私钥 secret,必须从后端发起
第一步:用户开通自动支付服务
跳转到打点钱包开通自动支付服务
-
地址: https://www.ddpurse.com/openapi/set_pay_config?app_id={app_id} &redirect_uri={redirect_uri}
-
方式:
GET
-
参数:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
app_id | string | 是 | 商家的 app id |
redirect_uri | string | 是 | 授权后重定向的回调链接地址 |

-
用户点击 下一步
1. 用户自行选择单笔支付限额和累计支付支付限额,默认 0.1BSV 2. 用户开通服务成功,页面将跳转至 <font color=orange>{redirect_uri}</font>

- 用户点击 拒绝
返回到商家的 {redirect_url}
- 错误返回码说明如下:
返回码 | 说明 |
---|---|
10003 | 支付错误,redirect_uri 不合法,错误码:10033 |
第二步:发起支付
注:这步要用到你的 app secret 所以必须是从后端发。
-
方式:
POST
-
Body 参数(JSON):
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
app_id | string | 是 | 商家应用账号 |
secret | string | 是 | 商家应用密钥 |
merchant_order_sn | string | 是 | 商家订单号,建议使用 uuid |
pre_amount | int | 是 | 用户需要支付的金额,单位 satoshi |
user_open_id | string | 是 | 用户的唯一标识 |
item_name | string | 是 | 商品名称 |
opreturn | string | 否 | 用户自定义脚本的 rawhex |
receive_address | string | 否 | 收款地址 |
注意: {receive_address} 为 JSON 字符串,如下:
"[
{
"address": "1MS3HE9M3oEqW81KXp8iK9nBMTGXekdxAP",
"amount": 622
}
]"
- 成功
错误码
code
为 0 时表示成功
{
"code": 0,
"msg": "",
"data": {
"order_sn": "ORDER_SN",
"pay_txid": "PAY_TXID"
}
}
- 返回参数说明
参数 | 类型 | 说明 |
---|---|---|
order_sn | string | 打点钱包的订单号 |
pay_txid | string | 支付 txid |
- 失败
订单已经存在
{
"code": 10039,
"msg": "支付错误,当前订单号已经存在,错误码:10039",
"data": []
}```
余额不足
```json
{
"code": -101001,
"next_do": "todo",
"show_kind": 1,
"data": "balance=0,amount=700,fee=113,0 < 813"
}
注意:如果提示用户余额不够,请重新走第一步