订阅创建

1.请求地址（POST）

实时 API: https://api.futurepay.global/auto/subscription

沙盒 API: https://api.futurepay-develop.com/auto/subscription

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（可在平台中获取）
productDetail	String	是	产品详情（用于扣款告知消费者扣款详情）
consumerId	String	是	消费者 ID
origin	String	是	请求来源网站
referenceId	String	是	参考 ID，用于唯一标识
customerName	String	是	客户姓名
customerPhone	String	是	客户手机号
countryCode	String	是	国家代码（如 CN）
customerEmail	String	是	客户邮箱
paymentMethod	Object	是	支付方式
paymentMethod.type	String	是	支付类型（请参考_支持订阅扣款支付方式列表_）
notifyUrl	String	是	订阅结果通知回调地址
returnUrl	String	是	用户授权后跳转地址
browserInfo	Object	是	浏览器信息
browserInfo.osType	String	是	操作系统类型（如 IOS, ANDROID,OTHER）
browserInfo.terminalType	String	是	终端类型（如 APP, WAP,WEB,MINI_APP）

{
  "productsId": 1899744808189210624,
  "productDetail": "Premium Subscription Plan",
  "consumerId": "USER-10008",
  "origin": "https://merchant-website.com",
  "referenceId": "1b8a9331-79d0-4b66-974b-ef9c43213e30",
  "customerName": "John Doe",
  "customerPhone": "+8613800000000",
  "countryCode": "CN",
  "customerEmail": "[email protected]",
  "paymentMethod": {
    "type": "alipaycn"
  },
  "notifyUrl": "https://merchant-website.com/notify",
  "returnUrl": "https://merchant-website.com/return",
  "browserInfo": {
    "osType": "OTHER",
    "terminalType": "WEB"
  }
}

4. 响应示例

参数	类型	描述
code	String	返回代码，"0" 表示请求成功
msg	String	返回信息
serverTime	Long	服务器时间戳
data	Object	响应数据对象
data.action	Object	支付跳转相关信息
data.action.url	String	用户跳转授权的 URL
data.action.applinkUrl	String	用户跳转授权的 URL用于外部浏览器跳转APP授权
data.action.schemeUrl	String	用户跳转授权的 URL用于APP内跳转链接
data.action.method	String	请求方法（如 GET）
data.action.type	String	跳转类型（如 redirect）
data.merchantReference	String	商户参考 ID
data.pspReference	String	支付平台参考 ID
data.resultCode	String	结果代码（如 PENDING、FAILED）
success	Boolean	请求是否成功，true 表示成功

{
  "code": "0",
  "msg": "success",
  "serverTime": 1741846578666,
  "data": {
    "action": {
      "url": "https://g.alipayplus.com/page/aplus-linker/acwallet/qrcode.html?url=alipayconnect%3A%2F%2Fplatformapi%2Facwallet%2FsignContract&scopes=AGREEMENT_PAY%2CUSER_LOGIN_ID&bizContent=%7B%22acquirerId%22%3A%22Z02TE2404000000A%22%2C%22authClientDisplayName%22%3A%22seelife%22%2C%22authClientId%22%3A%221864516583179857920%22%2C%22authClientName%22%3A%22seelife%22%2C%22authRedirectUrl%22%3A%22https%3A%2F%2Fg.alipayplus.com%2Fpage%2Fac-auth-payment%2Fresult%2Fmobile%2Findex.html%3FloadMode%3D2%26callbackType%3DCommon%26terminalType%3DWEB%26referenceAgreementId%3D1900068379297972224%26authRequestId%3D2025031319091305000150000715707%26pspId%3D102208800000000000A%26clientId%3DT_305Y392YSG5VPU02102%22%2C%22authState%22%3A%221900068379297972224%22%2C%22customerBelongsTo%22%3A%22ALIPAY_CN%22%2C%22osType%22%3A%22OTHER%22%2C%22pspId%22%3A%22102208800000000000A%22%2C%22referenceAgreementId%22%3A%221900068379297972224%22%2C%22referenceMerchantId%22%3A%221864516583179857920%22%2C%22scopes%22%3A%5B%22AGREEMENT_PAY%22%2C%22USER_LOGIN_ID%22%5D%2C%22terminalType%22%3A%22WEB%22%7D&source=AlipayConnect&needCallback=false",
      "method": "Get",
      "type": "redirect"
    },
    "merchantReference": "1864516583179857920",
     "pspReference": "1864516583179857922",
    "resultCode": "PENDING"
  },
  "success": true
}

5. 错误码说明

错误码	描述
0	成功
400	请求参数错误
401	未授权访问
403	权限不足
500	服务器内部错误

6. 备注

notifyUrl 用于接收支付状态更新的通知。
returnUrl 用户完成支付后返回的页面。
响应中的 action.url 需要引导用户跳转完成支付。

7.支持订阅扣款支付方式列表

支付方式	枚举值	描述
AlipayCN	alipaycn	支持支付宝中国
TrueMoney Wallet	tmn	支持 TrueMoney 钱包支付
AlipayHK	alipayhk	支持支付宝香港
Touch ‘n Go eWallet	tng	支持马来西亚 Touch ‘n Go 电子钱包
GCash	gcash	支持菲律宾 GCash 支付
Dana	dana	支持印尼 Dana 钱包支付
Kakao Pay	kakaopay	支持韩国 Kakao Pay 电子钱包支付
Rabbit LINE Pay	rabbitlinepay	支持泰国 Rabbit LINE Pay 支付
Boost	boost	支持马来西亚 Boost 支付
NAVER Pay	naverpay	支持韩国 NAVER Pay 支付
Mpay	mpay	支持中国澳门 MPay 支付
KPLUS	kplus	支持泰国 KPLUS 支付
Nigeria Cards	nigeriacards	支持尼日利亚本地卡订阅支付

如果有任何问题，请联系 FuturePay 支持团队。