创建订阅

POST

/pay-api/v1/billing/subscriptions

请求参数

Authorization

Header 参数

Body 参数application/json

示例

{
    "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": 9.99
    },
    "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": "",
    "metadata": "test"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/pay-api/v1/billing/subscriptions' \
--header 'Idempotent-Key: {{$string.uuid}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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": 9.99
    },
    "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": "",
    "metadata": "test"
}'

返回响应

🟢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-06-16 07:26:34

代付异步通知

检索订阅