取消订阅
使用此接口来取消订阅。取消订阅表示在当前订阅期结束后不再向用户提供服务。
1.请求地址(POST)
实时 API: https://api.futurepay.global/auto/unsubscriben
沙盒 API: https://api.futurepay-develop.com/auto/unsubscribe
2.请求头参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
Authorization | String | 是 | 认证 Token,用于身份验证,生成方式可参考该地址:https://doc.futurepay.global/docs/%E8%BA%AB%E4%BB%BD%E9%AA%8C%E8%AF%81#/ |
curTime | String | 是 | 当前时间,格式为 yyyy-MM-dd HH:mm:ss |
merchantId | String | 是 | 商户 ID |
appId | String | 是 | 应用 ID |
User-Agent | String | 是 | 发送请求的客户端信息 |
Content-Type | String | 是 | 请求数据类型,默认为 application/json |
{
"Authorization": "b8dfd126f5a787279dfe58b1f8889f096f1f7d473da7935c60fb245a58b8c25b",
"curTime": "2025-03-13 14:15:03",
"merchantId": "1864516583179857920",
"appId": "1864516583200808960",
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.127 Safari/537.36",
"Content-Type": "application/json"
}
3. 请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
productsId | Long | 是 | 产品计划 ID(可在平台中获取) |
consumerId | String | 是 | 消费者 ID |
referenceId | String | 是 | 参考 ID,用于唯一标识 |
paymentMethod | Object | 是 | 支付方式 |
paymentMethod.type | String | 是 | 支付类型(请参考_支持订阅扣款支付方式列表_) |
{
"productsId": 1899744808189210624,
"consumerId": "USER-10008",
"referenceId": "1b8a9331-79d0-4b66-974b-ef9c43213e30",
"paymentMethod": {
"type": "alipaycn"
}
}
4. 响应示例
参数 | 类型 | 描述 |
---|---|---|
code | String | 返回代码,"0" 表示请求成功 |
msg | String | 返回信息 |
serverTime | Long | 服务器时间戳 |
data | Object | 响应数据对象 |
data.merchantReference | String | 商户参考 ID |
data.pspReference | String | 支付平台参考 ID |
data.resultCode | String | 结果代码(如 PENDING、FAILED、SUCCEED) |
success | Boolean | 请求是否成功,true 表示成功 |
{
"code": "0",
"msg": "success",
"serverTime": 1741846578666,
"data": {
"merchantReference": "1864516583179857920",
"pspReference": "1864516583179857912",
"resultCode": "SUCCEED"
},
"success": true
}
5. 错误码说明
错误码 | 描述 |
---|---|
0 | 成功 |
400 | 请求参数错误 |
401 | 未授权访问 |
403 | 权限不足 |
500 | 服务器内部错误 |
Updated about 1 month ago