自动支付

用户同意授权自动支付之后,在一定限额内,不需要手动授权每一笔交易。适合高频小额场景下使用。

注:此功能有用到你的应用私钥 secret,必须从后端发起

第一步:用户开通自动支付服务

跳转到打点钱包开通自动支付服务

参数 类型 是否必须 说明
app_id string 商家的 app id
redirect_uri string 授权后重定向的回调链接地址
paymentEntrance
  • 用户点击 下一步

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

返回到商家的 {redirect_url}

  • 错误返回码说明如下:
返回码 说明
10003 支付错误,redirect_uri 不合法,错误码:10033

第二步:发起支付

注:这步要用到你的 app secret 所以必须是从后端发。

参数 类型 是否必须 说明
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"
}

注意:如果提示用户余额不够,请重新走第一步