{
"id": "<string>",
"object": "subscription",
"customer": "<string>",
"store_id": "<string>",
"currency": "<string>",
"description": "<string>",
"status": "incomplete",
"items": [
{
"id": "<string>",
"price_data": {
"id": "<string>",
"currency": "<string>",
"product": "<string>",
"unit_amount": 123,
"recurring": {
"interval": "day",
"interval_count": 123
}
},
"quantity": 2,
"metadata": {}
}
],
"payment_method_id": "<string>",
"billing_cycle_anchor": 123,
"current_period_start": 123,
"current_period_end": 123,
"canceled_at": 123,
"cancel_at": 123,
"latest_invoice": "<string>",
"latest_invoice_object": {
"id": "<string>",
"object": "invoice",
"subscription_id": "<string>",
"customer": "<string>",
"amount_due": 123,
"amount_paid": 123,
"amount_remaining": 123,
"currency": "<string>",
"status": "open",
"payment_status": "pending",
"billing_reason": "<string>",
"period_start": 123,
"period_end": 123,
"created": 123,
"frequency": "<string>",
"recurring_interval": "day",
"recurring_interval_count": 123,
"payment_id": "<string>",
"paid_at": 123,
"due_date": 123
},
"customer_object": {
"id": "<string>",
"object": "customer",
"merchant_id": "<string>",
"external_customer_id": "<string>",
"email": "jsmith@example.com",
"name": "<string>",
"phone": "<string>",
"default_payment_method": "<string>",
"description": "<string>",
"created": 123
},
"payment_method_object": {
"id": "<string>",
"object": "payment_method",
"customer": "<string>",
"merchant_id": "<string>",
"type": "<string>",
"currency": "<string>",
"chain_type": 123,
"status": "active",
"mandate_id": "<string>",
"metadata": {},
"created": 123
},
"checkout_url": "<string>",
"metadata": {},
"created": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}查询订阅
根据订阅 ID 获取订阅详情,可通过 expand 展开关联对象。
{
"id": "<string>",
"object": "subscription",
"customer": "<string>",
"store_id": "<string>",
"currency": "<string>",
"description": "<string>",
"status": "incomplete",
"items": [
{
"id": "<string>",
"price_data": {
"id": "<string>",
"currency": "<string>",
"product": "<string>",
"unit_amount": 123,
"recurring": {
"interval": "day",
"interval_count": 123
}
},
"quantity": 2,
"metadata": {}
}
],
"payment_method_id": "<string>",
"billing_cycle_anchor": 123,
"current_period_start": 123,
"current_period_end": 123,
"canceled_at": 123,
"cancel_at": 123,
"latest_invoice": "<string>",
"latest_invoice_object": {
"id": "<string>",
"object": "invoice",
"subscription_id": "<string>",
"customer": "<string>",
"amount_due": 123,
"amount_paid": 123,
"amount_remaining": 123,
"currency": "<string>",
"status": "open",
"payment_status": "pending",
"billing_reason": "<string>",
"period_start": 123,
"period_end": 123,
"created": 123,
"frequency": "<string>",
"recurring_interval": "day",
"recurring_interval_count": 123,
"payment_id": "<string>",
"paid_at": 123,
"due_date": 123
},
"customer_object": {
"id": "<string>",
"object": "customer",
"merchant_id": "<string>",
"external_customer_id": "<string>",
"email": "jsmith@example.com",
"name": "<string>",
"phone": "<string>",
"default_payment_method": "<string>",
"description": "<string>",
"created": 123
},
"payment_method_object": {
"id": "<string>",
"object": "payment_method",
"customer": "<string>",
"merchant_id": "<string>",
"type": "<string>",
"currency": "<string>",
"chain_type": 123,
"status": "active",
"mandate_id": "<string>",
"metadata": {},
"created": 123
},
"checkout_url": "<string>",
"metadata": {},
"created": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"decline_code": "<string>",
"request_log_url": "<string>",
"charge": "<string>"
},
"request_id": "<string>",
"timestamp": 123
}授权
Bearer API Key,例如 Bearer sk_live_xxx。
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
请求头
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
16 - 64使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
路径参数
订阅 ID。
查询参数
展开关联对象。支持 latest_invoice、customer、payment_method;兼容逗号分隔、多值、expand[]、camelCase。
latest_invoice, customer, payment_method 响应
查询成功。
订阅对象。
订阅 ID。
"subscription"
外部客户 ID。
店铺 ID。
币种。
订阅描述。
订阅状态。
incomplete, trialing, active, past_due, canceled, incomplete_expired 订阅项列表。
Show child attributes
Show child attributes
默认支付方式 ID。
账期锚点,Unix 秒。
当前周期开始,Unix 秒。
当前周期结束,Unix 秒。
取消完成时间,Unix 秒。
计划取消时间,Unix 秒。
最近一张发票 ID。
expand=latest_invoice 时返回完整发票对象。
Show child attributes
Show child attributes
expand=customer 时返回完整客户对象。
Show child attributes
Show child attributes
expand=payment_method 时返回完整支付方式对象。
Show child attributes
Show child attributes
首次付款收银台 URL,仅创建时返回。
商户自定义元数据。
创建时间,Unix 秒。
此页面对您有帮助吗?
