订阅申请
信用卡订阅
订阅申请
创建订阅订单
POST
订阅申请
Documentation Index
Fetch the complete documentation index at: https://doc.haipay.net/llms.txt
Use this file to discover all available pages before exploring further.
密钥私钥(生成签名)
相关主题
请求体
application/json
业务ID(后台获取,需要根据参数currency传递对应的业务ID)
商户订单号(必须保证唯一性,长度不超过48)
Maximum string length:
48交易金额(精确到小数点后两位;禁止添加标点符号,例如:",")
Pattern:
^\d+\.\d{2}$真实手机号(格式参考电话号码格式)
订阅标题
支付方式编码,与 paymentMethods 二选一
可用选项:
CREDIT_CARD, GOOGLE_PAY, APPLE_PAY 支付方式类型
可用选项:
SUBSCRIPTION 用户支付成功后跳转地址
异步通知地址
国家
币种,目前支持:USD
可用选项:
USD 用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。
Pattern:
^[A-Za-z0-9\-~!@#$%&*()_]+$循环周期类型 D(天),W(周),M(月),Y(年)
可用选项:
D, W, M, Y 循环周期间隔
必填范围:
x >= 1最大循环次数,无论循环周期是哪个,最长时间不能超过三年,到期订阅自动取消
必填范围:
x >= 1交易网站
定期扣款失败重试次数,默认为3
必填范围:
x >= 0签名
用户姓名,推荐使用真实姓名,格式:包含firstName和lastName,以空格分割的,示例:Donald John Trump
真实电子邮件
备注详情
用户取消支付URL,如果传递,用户可在支付页面点击返回到此页面
优惠期数(暂时只支持首期优惠与全期优惠,即couponPeriod只能等于1或者等于recurringMaxNumber)
每期优惠金额
Pattern:
^\d+\.\d{2}$支持的支付方式列表,英文逗号分隔,如 CREDIT_CARD,GOOGLE_PAY,APPLE_PAY,与 inBankCode 二选一,暂时仅支持前置组件组合模式使用
Last modified on May 22, 2026

