千汇团第三方储值卡对接文档

本文档是千汇团接入第三方储值卡支付商户功能接口说明。

1. 获取千汇团服务器IP地址

如果第三方储值卡基于安全等考虑,需要获知千汇团服务器的IP地址列表,以便进行相关限制,可以通过联系商户获得千汇团服务器IP地址列表或者IP网段信息。

2. 查询账户余额

  • 请求地址

存储在后台的查询账户余额的地址:例如https:/mp.qianhuituan.cn/api/deposit

  • 请求参数

请求方式:GET

请求参数 字段 类型 是否必填 默认值 说明
app_id string 调用支付应用的 app_id,管理员发放,每个应用唯一
token string 请求验证 token,生成方式见:token 说明
timestamp string 当前时间戳 time(),服务器时间精度要求误差10分钟以内
phone string 手机号码
  • 请求参数实例
app_id:ljsdfI3SFoi34
token:149e58ae3313491c5798b9f1651acc65
timestamp:1562472983
phone:18751966004
  • 请求成功返回:
{
    "code": 0,
    "message": "success",
    "data": {
        "deposit_info": {
            "deposit": "755.000",
            "freeze": "0.000"
        },
        "deposit": "755.000"
    }
}

3. 余额消费(Pay)

  • 请求地址

存储在后台的余额消费的地址:例如https:/mp.qianhuituan.cn/api/deposit

  • 请求参数

请求方式:POST

请求参数 字段 类型 是否必填 默认值 说明
app_id string 调用支付应用的 app_id,管理员发放,每个应用唯一
token string 请求验证 token,生成方式见:token 说明
timestamp string 当前时间戳 time(),服务器时间精度要求误差10分钟以内
phone string 手机号码
password string 用户储值卡支付密码
fee Int 支付金额
tid string 千汇团订单编号
  • 请求参数实例
app_id:ljsdfI3SFoi34
token:3a57d99206bf8921219addd96871bf70
timestamp:1562472158
phone:18751966004
password:admin123
fee:1
tid:4564424234234234
  • 请求成功返回:
{
    "code": 0,
    "message": "success",
    "data": {
        "result": true
    }
}

4. 余额退款(Refund)

  • 请求地址

存储在后台的余额退款的地址:例如https:/mp.qianhuituan.cn/api/deposit/refund

  • 请求参数

请求方式:POST

请求参数 字段 类型 是否必填 默认值 说明
app_id string 调用支付应用的 app_id,管理员发放,每个应用唯一
token string 请求验证 token,生成方式见:token 说明
timestamp string 当前时间戳 time(),服务器时间精度要求误差10分钟以内
phone string 手机号码
fee int 支付金额
tid string 千汇团订单编号,退款时需要传入该订单号。
  • 请求参数实例
app_id:ljsdfI3SFoi34
token:3a57d99206bf8921219addd96871bf70
timestamp:1562472158
phone:18751966004
fee:1
tid:4564424234234234
  • 请求成功返回:
{
    "code": 0,
    "message": "success",
    "data": {
        "result": true
    }
}

results matching ""

    No results matching ""