小额自动支付

开发者可通过打点平台授权小额支付机制,来发起自动小额支付。商家发起支付,无需用户授权,自动付款。适合高频小额场景下使用。

  1. 第一步:用户开通小额自动支付服务

  2. 第二步:发起小额支付

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

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

参数 类型 是否必须 说明
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_id int 商家应用账号
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",
    "paytxid": "PAYTXID"
  }
}
  • 返回参数说明
参数 类型 说明
order_sn string 打点钱包的订单号
paytxid string 支付 txid
  • 失败
{
  "code": 10039,
  "msg": "小额支付错误,当前订单号已经存在,错误码:10039",
  "data": []
}

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