创建一个新的订阅。创建后订阅通常进入 incomplete 状态,需用户在返回的 checkout_url 完成首次授权付款后才进入 active(或 trialing)。请求头中的 Idempotency-Key 为必填幂等键。
Documentation Index
Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt
Use this file to discover all available pages before exploring further.
Bearer API Key,例如 Bearer sk_live_xxx。
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
商户生成的幂等键,最长 128 字符。相同键重试会返回首次创建的订阅对象。
128Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
16 - 64使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
订阅项列表,当前仅支持 1 个元素。
1 element外部客户 ID(商户侧客户标识)。
客户邮箱。
客户手机号。
客户姓名。
255订阅币种。当前仅支持 USD,可省略并由 price_data.currency 决定。
USD, usd 订阅描述。
500用户完成首次付款后的跳转 URL,最长 512 字符。
512用户取消首次付款后的跳转 URL,最长 512 字符。
512试用期结束时间,Unix 秒。与 billing_cycle_anchor 互斥。
账期锚点时间,Unix 秒。与 trial_end 互斥;非试用场景必须为未来时间或当前/过去时间代表立即扣首期。
计划取消时间,Unix 秒。必须为未来时间,且与 iterations 互斥。
运行 N 个周期后自动取消。必须大于 0,且与 cancel_at 互斥。
x >= 1商户自定义元数据。
订阅创建成功;重复使用相同 Idempotency-Key 时返回首次创建的订阅对象。
订阅对象。
订阅 ID。
"subscription"
外部客户 ID。
店铺 ID。
币种。
订阅描述。
订阅状态。
incomplete, trialing, active, past_due, canceled, incomplete_expired 订阅项列表。
默认支付方式 ID。
账期锚点,Unix 秒。
当前周期开始,Unix 秒。
当前周期结束,Unix 秒。
取消完成时间,Unix 秒。
计划取消时间,Unix 秒。
最近一张发票 ID。
expand=latest_invoice 时返回完整发票对象。
expand=customer 时返回完整客户对象。
expand=payment_method 时返回完整支付方式对象。
首次付款收银台 URL,仅创建时返回。
商户自定义元数据。
创建时间,Unix 秒。