Authorizations
Basic authentication header of the form Basic <encoded-value>
, where <encoded-value>
is the base64-encoded string username:password
.
Path Parameters
Unique identifier of the subscription
"sub_fooBOwYsaK50AEfK"
Response
Successful response with subscription details
Unique identifier of the subscription
"sub_fooBOwYsaK50AEfK"
The interval group between subscriptions.
DAY
, WEEK
, MONTH
, YEAR
"MONTH"
The number of intervals between subscription billings. For example, interval = MONTH
and intervalCount = 3
bills every 3 months.
2
The number of billing cycles for which the subscription will renew before ending. The first cycle is included in this count.
2
The number of billing cycles remaining for the subscription.
2
Three-letter currency code
"USD"
The amount in lowest count unit (e.g., cents for USD)
100
The currency that the customer paid in
"USD"
Timestamp of when the subscription was created
"2024-09-26T10:41:50.472+00:00"
The status of the subscription
ACTIVE
, INACTIVE
, INCOMPLETE
, CREATED
, CANCELLED
"CREATED"
Description of the order, if any
"Order for 2 items"
The amount to be charged at the start of the subscription. The upfront amount replaces the first subscription cycle amount. Regular amount apply from the next cycle.
200
The number of trial periods before the first billing cycle.
7
The interval for the trial period.
DAY
, WEEK
, MONTH
, YEAR
"DAY"
A collection of key-value pairs that can be attached to an object for storing additional structured information. This is useful for capturing custom data or context-specific attributes.
Constraints:
- Maximum of 50 key-value pairs allowed.
- Each key must be no longer than 40 characters.
- Each value must be a string and cannot exceed 500 characters.
{
"orderId": "12345",
"customerNote": "Deliver after 5 PM"
}