接口概述

概述

本 API 接口用于处理客户端的请求,要求客户端提供 app_id 和 app_secret 进行身份验证,并通过签名机制确保请求的完整性和安全性。签名的生成规则是对请求参数按照键名排序后,拼接 app_secret 再进行 md5 加密。

接收参数

从平台跳转到商户的链接地址,并携带参数。

  1. ht_task_id:平台任务ID
  2. ht_min_price:最小支付金额
  3. ht_max_price:最大支付金额
  4. ht_goods_id:平台商品ID
  5. ht_payment:支付方式

示例:

商户链接跳转地址 + task_id=1&min_price=3.00&max_price=5.00&goods_id=1&payment=wxpay

接口信息

1. 接口地址

接口地址:https://m.huitui.fun/api/v1

2. 请求方式

GET

3. 数据格式

请求参数以 key=value 的形式通过 URL 传递,响应数据为 JSON 格式。

4. 签名规则

  1. 移除请求参数中的 sign 参数。
  2. 对剩余的参数按照键名进行 ksort 排序
  3. 将排序后的参数拼接为字符串,并加上 app_secret
  4. 对拼接后的字符串进行 md5 加密,转小写,得到签名结果。

PHP示例:

strtolower(md5(app_id=xx&pay_price=xx&payment=xx&task_id=xx&time=xxapp_secret))

请求参数

参数名 类型 是否必选 描述
app_id string 应用的唯一标识符
task_id string 任务ID
pay_price number 实际支付金额
payment string

wxpay:微信支付

alipay:支付宝支付

time string 当前时间(时间戳)
sign string 请求数据的签名,用于验证请求的完整性和安全性

2. 示例

https://m.huitui.fun/api/v1?app_id=123456&task_id=123456&pay_price=100&payment=wxpay&sign=123

响应参数

参数名 类型 描述
code int 1成功,0失败
msg string 返回信息
data object

参数名 描述
jump_url 跳转回源地址

响应json

                            {
                                "code": 0,
                                "msg": "success"
                                "data": {
                                    "jump_url" => ""
                                }
                            }
                        

SDK下载

PHP SDK下载