WooshPay OpenAPI
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Back to WooshPay Website
  1. subscription
  • API Introduction
  • Error Code
  • Payment Intents
    • Create a PaymentIntent
      POST
    • Update a PaymentIntent
      POST
    • Cancel a PaymentIntent
      POST
    • Capture a PaymentIntent
      POST
    • Confirm a PaymentIntent
      POST
    • Retrieve a PaymentIntent
      GET
    • List all PaymentIntents
      GET
    • Search PaymentIntents
      GET
  • Charges
    • Retrieve a charge
      GET
    • List all charges
      GET
  • Payment Methods
    • Create a PaymentMethod
      POST
    • Retrieve a PaymentMethod
      GET
    • Retrieve a Customer's PaymentMethod
      GET
    • Update a PaymentMethod
      POST
    • List PaymentMethods
      GET
    • List a Customer's PaymentMethods
      GET
    • Attach a PaymentMethod to a Customer
      POST
    • Detach a PaymentMethod from a Customer
      POST
  • Refunds
    • Create a refund
    • Retrieve a refund
  • Webhooks
    • Create a Webhook
    • List All Webhooks
    • Retrieve a Webhook
    • Delete a Webhook
    • Update a Webhook
  • Events
    • Types of events
    • Retrieve an event
  • Files
    • Files
    • Create a file
    • Retrieve a file
  • Disputes
    • Retrieve a dispute
    • Update a dispute
    • Close a dispute
    • List all disputes
  • Payouts
    • Beneficiary
      • Create a beneficiary
      • Retrieve a beneficiary
      • List all beneficiaries
      • Update a beneficiary
      • Delete a beneficiary
    • Payouts
      • Create a payout
      • Retrieve a Payout
      • Update a Payout
      • List All Payouts
  • Balance
    • Get balance
  • Products
    • Create a Product
    • Retrieve a product
    • Update a product
    • List all products
  • Prices
    • Create a price
    • Retrieve a price
    • Update a price
  • Payment Links
    • Create a payment link
    • Update a payment link
    • Retrieve payment link
    • List all payment links
    • Retrieve a payment link's line items
  • Checkout
    • 订阅计划升降级与按比例分摊
      • subscription
        • 创建订阅
          POST
        • confirm
          POST
        • 更新item
          POST
        • 支付invoice
          GET
    • Create a Session
      POST
    • Expire a Session
      POST
    • Retreive a Session
      GET
    • List All Checkout Sessions
      GET
    • Retrieve a Checkout Session's line items
      GET
    • Expire a Session Copy
      POST
  • Customers
    • Create a customer
    • Retrieve a customer
    • Update a customer
  • Invoices
    • Setup Intents
      • Create a SetupIntent
      • Retrieve a SetupIntent
      • Cancel a SetupIntent
      • List all SetupIntents
      • List all SetupAttempts
      • Update a SetupIntent
      • Confirm a SetupIntent
    • Create an invoice
    • Retrieve an invoice
    • Finalize an invoice
    • Send an invoice for manual payment
    • Delete a draft invoice
    • Void an invoice
    • List all invoices
    • Pay an invoice
  • Invoice Items
    • Create an invoice item
    • Retrieve an invoice item
  • Invoice Line Item
    • Bulk add invoice line items
  • Subscriptions
    • Create a subscription
    • Retrieve a subscription
    • Update a subscription
    • Cancel a subscription
    • List subscriptions
  • Subscription Items
    • Create a subscription item
    • Retrieve a subscription item
    • Delete a subscription item
  • Issuing
    • Authorizations
      • Retrieve an authorization
      • List all authorization
    • Cardholders
      • Create a cardholder
      • Update a cardholder
      • Retrieve a cardholder
      • List all cardholders
    • Cards
      • Create a card
      • Update a card
      • Retrieve a card
      • List all cards
      • Retrieve card remaining limits
    • Transactions
      • Update a transaction
      • Retrieve a transaction
      • List all transactions
  • Coupons
    • Create a Coupon
    • Retrieve a coupon
    • Delete a coupon
  • Promotion Code
    • Create a promotion code
    • Update a promotion code
  • Accounts
    • Retrieve account's paymentmethods
  • Fx Quote
    • Create an FX Quote
  1. subscription

更新item

Developing
POST
/v1/subscriptions/{subId}

Request

Authorization
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
Path Params
subId
string 
required
Header Params
Content-Type
string 
required
Example:
application/json
Authorization
string 
required
Example:
Basic c2tfdGVzdF9OVEU0TWpFME5UZzROVFk1TlRnMk1qYzROREV4T2pCNU5HTjBibUY1TUZaNlVHbGxSV3BVV25veVRWVkNRVEUzTWpNeE1EUTJNRGMwTURZOg==
Accept
string 
required
Default:
application/json
Body Params application/json
cancel_at_period_end
boolean 
required
line_items
array [object {4}] 
required
id
string 
optional
price_data
object 
optional
quantity
integer 
optional
deleted
boolean 
optional
proration_behavior
string 
required
Example
{
  "cancel_at_period_end": false,
  "line_items": [
    {
      "id": "si_1942466974063788032",
      "price_data": {
        "currency": "currency_9be108a6ee4e",
        "product": "product_cddfddb17876",
        "unit_amount": 0,
        "recurring": {
          "interval": "interval_565d0f3c498a",
          "interval_count": 0,
          "usage_type": "usage_type_1e35c1ec858f"
        },
        "active": false,
        "metadata": {},
        "nickname": "nickname_94ad62776055",
        "product_data": {
          "id": "id_37bf9721d87d",
          "name": "name_3c67055cd98e",
          "active": false,
          "description": "description_976184aca331",
          "metadata": {},
          "url": "url_9254e121d785",
          "images": [
            "images_e564fe2c0d03"
          ]
        },
        "billing_scheme": "billing_scheme_3828e2cd64b5",
        "lookup_key": "lookup_key_858bbfbff35a",
        "tiers": [
          {
            "unit_amount": 0,
            "flat_amount": 0,
            "up_to": 0
          }
        ],
        "tiers_mode": "tiers_mode_0e4196b47cdc"
      },
      "quantity": 0,
      "deleted": false
    }
  ],
  "proration_behavior": "proration_behavior_3e5b982c1876"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://apitest.wooshpay.com/v1/subscriptions/' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
  "cancel_at_period_end": false,
  "line_items": [
    {
      "id": "si_1942466974063788032",
      "price_data": {
        "currency": "currency_9be108a6ee4e",
        "product": "product_cddfddb17876",
        "unit_amount": 0,
        "recurring": {
          "interval": "interval_565d0f3c498a",
          "interval_count": 0,
          "usage_type": "usage_type_1e35c1ec858f"
        },
        "active": false,
        "metadata": {},
        "nickname": "nickname_94ad62776055",
        "product_data": {
          "id": "id_37bf9721d87d",
          "name": "name_3c67055cd98e",
          "active": false,
          "description": "description_976184aca331",
          "metadata": {},
          "url": "url_9254e121d785",
          "images": [
            "images_e564fe2c0d03"
          ]
        },
        "billing_scheme": "billing_scheme_3828e2cd64b5",
        "lookup_key": "lookup_key_858bbfbff35a",
        "tiers": [
          {
            "unit_amount": 0,
            "flat_amount": 0,
            "up_to": 0
          }
        ],
        "tiers_mode": "tiers_mode_0e4196b47cdc"
      },
      "quantity": 0,
      "deleted": false
    }
  ],
  "proration_behavior": "proration_behavior_3e5b982c1876"
}'

Responses

🟢200成功
application/json
Body
object {0}
Example
{}
Modified at 2025-07-10 02:28:38
Previous
confirm
Next
支付invoice
Built with