---
title: "Create subscription"
method: POST
path: "/subscription"
tags: ["Subscription"]
---

# Create subscription

`POST /subscription`

## Headers

- `Date` string
- `Authorization` string
- `Digest` string

## Request body

- GithubComInfiniMoneyInfiniServicesGoAppInfiniPaymentServiceApiSubscriptionV1CreateSubscriptionReq
  - `amount` string, string, required — 首次支付金额
  - `currency` string, string — 币种（USD, EUR, GBP, CAD, SGD, AUD）
  - `request_id` string, string, required — 请求唯一ID
  - `client_reference` string, string — 客户端引用
  - `expires_in` integer — 订单过期相对时间(Unix秒);不传则使用后台默认值
  - `merchant_alias` string, string — 商户别名
  - `success_url` string, string — 首次支付成功跳转
  - `failure_url` string, string — 首次支付失败跳转
  - `pay_methods` integer[] — 支付方式
  - `subscription` GithubComInfiniMoneyInfiniServicesGoAppInfiniPaymentServiceApiSubscriptionV1SubscriptionParams
    - `merchant_sub_id` string, string, required — 商户订阅ID
    - `plan_name` string, string, required — 订阅计划名称
    - `amount` string, string, required — 后续每期金额
    - `interval_unit` 'DAY' | 'MONTH', string, required — 周期单位
    - `interval_count` integer, required — 周期数量
    - `payer_email` string, string, required — 付款人邮箱
    - `invoice_lead_days` integer, required — 提前发送天数
    - `invoice_due_days` integer, required — 到期天数
    - `subscription_end_at` integer — 订阅终止时间 (unix timestamp, 0=永不终止)
    - `canceled_url` string, string — 取消跳转URL

## Response `200`

- GithubComInfiniMoneyInfiniServicesGoAppInfiniPaymentServiceApiSubscriptionV1CreateSubscriptionRes
  - `order_id` string, string — 首次订单ID
  - `request_id` string, string — 请求ID
  - `client_reference` string, string — 客户端引用
  - `checkout_url` string, string — 订阅确认页面 URL
  - `token` string, string — JWT Token
  - `subscription` GithubComInfiniMoneyInfiniServicesGoAppInfiniPaymentServiceApiSubscriptionV1SubscriptionResponse
    - `subscription_id` string, string — 系统订阅ID
    - `merchant_sub_id` string, string — 商户订阅ID
    - `status` string, string — 订阅状态 (pending)

---

[API](https://skmtc.net/infini/apis/infini-acquiring-api.md) · [All operations](https://skmtc.net/infini/apis/infini-acquiring-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infini/infini-acquiring-api/revisions/ef0638d19a3a/schema)