创建订阅(待发布）
POST
/pay-api/v1/billing/subscriptions
请求参数
Authorization
Header 参数
Body 参数application/json
示例
{
"clientIp": "47.125.221.223",
"customerToken": "cus_axKGyKVQxqNIR09",
"planToken": "plan_test_202607021600001",
"plan": {
"product": {
"name": "T-Shirt",
"sku": "test_sku",
"description": "Cotton XL",
"quantity": "1",
"price": "9.99",
"url": "https://test.com/test_260a61ca16a8"
},
"name": "plan 1",
"intervalUnit": "month",
"intervalCount": 1,
"currency": "USD",
"amount": 1.01
},
"customer": {
"firstname": "Thiago",
"lastname": "Gabriel",
"email": "thiago@example.com",
"phone": "12345678901",
"country": "US",
"state": "CA",
"city": "San Francisco",
"address": "310 Park Street",
"zipcode": "94107",
"shipping": {
"firstname": "Thiago",
"lastname": "Gabriel",
"email": "thiago@example.com",
"phone": "12345678901",
"country": "BR",
"state": "SP",
"city": "Sao Paulo",
"address": "Rua 9 de Setembro",
"zipcode": "04849333"
}
},
"description": "subscription test",
"metadata": "test",
"website": "https://test.com",
"paymentMethod": "CASHAPP",
"paymentMethodTypes": ["CASHAPP"]
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/pay-api/v1/billing/subscriptions' \
--header 'Idempotent-Key: {{$string.uuid}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"clientIp": "47.125.221.223",
"customerToken": "cus_axKGyKVQxqNIR09",
"planToken": "plan_test_202607021600001",
"plan": {
"product": {
"name": "T-Shirt",
"sku": "test_sku",
"description": "Cotton XL",
"quantity": "1",
"price": "9.99",
"url": "https://test.com/test_260a61ca16a8"
},
"name": "plan 1",
"intervalUnit": "month",
"intervalCount": 1,
"currency": "USD",
"amount": 1.01
},
"customer": {
"firstname": "Thiago",
"lastname": "Gabriel",
"email": "thiago@example.com",
"phone": "12345678901",
"country": "US",
"state": "CA",
"city": "San Francisco",
"address": "310 Park Street",
"zipcode": "94107",
"shipping": {
"firstname": "Thiago",
"lastname": "Gabriel",
"email": "thiago@example.com",
"phone": "12345678901",
"country": "BR",
"state": "SP",
"city": "Sao Paulo",
"address": "Rua 9 de Setembro",
"zipcode": "04849333"
}
},
"description": "subscription test",
"metadata": "test",
"website": "https://test.com",
"paymentMethod": "CASHAPP",
"paymentMethodTypes": ["CASHAPP"]
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"code": 0,
"data": {
"merNo": "2500000000",
"subToken": "sub_202508021903265863917",
"plan": {
"planToken": "plan_202508021903266087685",
"productToken": "prod_202508021903265947002",
"name": "plan 1",
"intervalUnit": "month",
"intervalCount": 1,
"currency": "USD",
"amount": 9.99,
"metadata": null,
"remark": null
},
"description": "",
"status": 0,
"code": "requires_action",
"message": "Please redirect to 'redirectUrl'",
"redirectUrl": "http://localhost:5173/checkout/pay_202508021903266348356",
"paymentMethod": null,
"firstTradeNo": "pay_202508021903266348356",
"startTime": null,
"cancelTime": null,
"expireTime": null,
"createTime": 1754132606723,
"metadata": "test",
"remark": null
},
"msg": "",
"livemode": false
}🔴500失败
修改于 2026-07-02 09:48:33