订阅支付流程

概述

Codrimpay 订阅支付支持按周期自动扣费，商户无需重复发起支付请求。

完整接入流程

步骤1：商家创建订阅计划
  POST /subscription/plan/create
  返回: planId

步骤2：展示订阅计划（可选）
  GET /subscription/plan/list
  在网站展示可选计划

步骤3：用户选择计划并订阅（首次扣费）
  POST /payment/{apiKey}/transaction
    paymentType = SUBSCRIPTION
    planId = 步骤1 获得的 planId
    userId = 商家侧用户ID
    cardInfo = 信用卡信息（首次必填）
  返回: subscriptionId, subscriptionCode

步骤4：系统自动续费
  → 定时任务按周期自动扣费
  → 通过 notifyUrl 回调通知商家
  → 失败时自动重试（最多3次，全失败后状态变为 FAILED）

步骤5：订阅管理
  查询订阅：GET /subscription/user/list
  暂停订阅：POST /subscription/pause
  恢复订阅：POST /subscription/resume
  取消订阅：POST /subscription/cancel
  扣费记录：GET /subscription/billing/list
  订阅详情：GET /subscription/detail

注意事项

1. 订阅支付首次必须提供完整的卡信息（cardInfo），系统会安全保存用于后续续费
2. payAmount 会被订阅计划的 price 覆盖，实际扣费金额以计划价格为准
3. 若计划设置了 trialDays > 0，试用期内首次可能为 0 元
4. 续费结果通过 Webhook 回调通知，需正确处理 SUBSCRIPTION 类型回调

订阅状态说明

状态	说明
ACTIVE	活跃，正常续费中
PAUSED	已暂停，不再自动续费
CANCELLED	已取消
FAILED	续费失败（重试3次后）
EXPIRED	已到期

相关接口

• 创建订阅计划
• 查询计划列表
• 查询用户订阅
• 订阅操作（暂停/恢复/取消）
• 查询扣费记录
• 查询订阅详情