Create Subscription

Create a subscription for regular, automatic payments.

This method triggers the Customer Subscription Created webhook. This webhook contains the same information as the response.

The following asynchronous webhooks provide information about later changes to the subscription:

Depending on the parameters in the request, some of these webhooks are triggered synchronously.

Note

Clients with PCI certification can handle personal identifying information for cards. Clients that are not PCI-certified can use Checkout Page or Payment Link to collect money from a card.
Before you create a subscription with a payment method token, verify that the value of is_tokenizable is true. See also Payment Method Type.
If the payment method category is card, certain operations require 3DS authentication. To simulate this authentication in the sandbox, use the URL from the redirect_url field that appears in Invoice Payment Created Webhook and Webhook - Payment Succeeded. See Simulating 3DS Authentication Simulating 3DS Authentication.
A card payment that requires 3DS authentication must be authenticated within 15 minutes.
All plans in the subscription must have the same value for trial_period_days.

Parameters

Request Header Parameters

Request Body Parameters

- billing
- Determines the method of billing at the end of the billing cycle. Set to pay_automatically - Rapyd generates a payment object, then attempts to pay it using the designated payment method.
- billing_cycle_anchor
- Determines the start of the next full billing cycle, as defined in the plan described in the items. One of the following values:
  - now - The present day. The next billing cycle starts right now.
  - Timestamp in Unix time - A time in the future, at or after the end of the free trial period, not more than the length of the billing cycle. The current billing cycle will be shorter than all other billing cycles. Relevant to creation of the subscription.
  - unchanged - The original billing cycle anchor is unchanged. Relevant to updating a subscription.
  Note
  If you update trial_end, billing_cycle_anchor will be reset to the end of the new trial period. If you want a different billing cycle anchor, you must update the subscription again at the moment you want, and set billing_cycle_anchor to now.
- cancel_at_period_end
- Determines the last date that charges accrue.
  - true - Charges accrue until the end of the current billing period, then the subscription is canceled.
    When no trial period is set, after cancel_at_period_end is set to true the subscription will not be renewed at the next interval.
    When a trial period is set after cancel_at_period_end is set to true, the subscription will not begin.
  - false - When the subscription is created, no end is defined. When Cancel Subscription is run, charges stop immediately and the subscription is canceled.
  false
- coupon
- The ID of a discount coupon that applies to all invoice lines associated with this subscription. If the coupon defines a fixed monetary discount, it must use the same currency as the subscription's plan.
- customer
- ID of the customer who pays for this subscription. String starting with cus_.
- days_until_due
- Number of days from the invoice date for customer to complete the payment.
- metadata
- A JSON object defined by the client. See Metadata.
- payment_fields
- Additional payment_options fields.
- payment_method
- Payment method ID or Payment Method object. If not specified in this field, the payment method is the default payment method specified for the customer. To create a payment method ID, use Add Payment Method to Customer. The ID is a string starting with card_ or other_.
- simultaneous_invoice
- Determines whether each upcoming subscription invoice is issued immediately.
  - true - The invoice is issued when the subscription is created.
  - false - The invoice is issued an hour after the subscription is created.
  false
- subscription_items
- In requests, an array of objects containing the following fields:
  Note
  All subscription items must have plans with identical values for interval and interval_count.
  - plan - ID of a plan that describes the service and pricing structure. The plan must be active. String.
  - quantity - Number of units of the service described in plan.
- tax_percent
- The percentage tax rate that is applied to the subtotal of the invoice, after subtracting all discounts. Decimal.Range: 0-100, with up to four decimal places.
- trial_end
- Defines the customer's free trial period. Relevant when trial_period_days is not defined. One of the following values:
  - The date and time of the end of the free trial period, in Unix time.
  - now - There is no free trial period.
- trial_from_plan
- Determines whether the subscription uses the free trial period defined in the plan.
  - true - Uses the trial period defined in the plans added to the subscription. When trial_from_plan is true, all plans in the subscription must have the same value for trial_period_days.
  - false - Uses the trial period defined in the subscription.
  false
- trial_period_days
- The number of days in the customer's free trial period. Integer. Range: 0-730.
  Relevant when trial_end is not defined.

Response Parameters

- billing
- Determines the method of billing at the end of the billing cycle. Set to pay_automatically - Rapyd generates a payment object, then attempts to pay it using the designated payment method.
- billing_cycle_anchor
- Determines the start of the next full billing cycle, as defined in the plan described in the items. One of the following values:
  now - The present day. The next billing cycle starts right now.
  Timestamp in Unix time - A time in the future, at or after the end of the free trial period, not more than the length of the billing cycle. The current billing cycle will be shorter than all other billing cycles. Relevant to creating a subscription.
  unchanged - The original billing cycle anchor is unchanged. Relevant to updating a subscription.
- cancel_at_period_end
- Determines the last date that charges accrue.
  true - Charges accrue until the end of the current billing period, then the subscription is canceled.
  When no trial period is set, after cancel_at_period_end is set to true the subscription will not be renewed at the next interval.
  When a trial period is set after cancel_at_period_end is set to true, the subscription will not begin.
  false - When the subscription is created, no end is defined. When Cancel Subscription is run, charges stop immediately and the subscription is canceled.
- cancel_checkout_url
- URL where the customer is redirected after pressing Back to Website to exit the hosted page. This URL overrides the merchant_website URL. Does not support localhost URLs.
- canceled_at
- Date and time that the subscription is canceled by the customer or by the client. Unix time.
- complete_checkout_url
- URL where the customer is redirected after pressing Finish to exit the hosted page. This URL overrides the merchant_website URL. Does not support localhost URLs.
- complete_payment_url
- URL where the customer is redirected when payment is successful, after returning from an external page such as a 3DS page. Does not support localhost URLs.
- coupon
- The ID of a coupon that applies to all invoice lines associated with this subscription. String starting with coupon_.
- created_at
- Time of creation of this subscription, in Unix time.
- current_period_end
- End of the current billing cycle, in Unix time.
- current_period_start
- Start of the current billing cycle, in Unix time.
- customer_token
- ID of the customer who pays for this subscription. String starting with cus_.
- days_until_due
- Number of days the customer has for paying this invoice.
- discount
- Contains information about the coupon that applies to the subscription.
- ended_at
- Date that the subscription was canceled or otherwise terminated. Unix time.
- error_payment_url
- URL where the customer is redirected when payment is not successful, after returning from an external page, such as a 3DS page. Does not support localhost URLs.
- id
- ID of the Subscription object. String starting with sub_.
- language
- Determines the default language of the hosted page. For a list of values, see List Supported Languages.
  When this parameter is null, the language of the user's browser is used.
  If the language of the user's browser cannot be determined, the default language is English.
- merchant_reference_id
- Identifier defined by the client for reference purposes. Limit: 45 characters.
- metadata
- A JSON object defined by the client. See Metadata.
- page_expiration
- End of the time when the customer can use the hosted page, in Unix time. If page_expiration is not set, the hosted page expires 14 days after creation.
  Range: 1 minute to 30 days.
- payment_fields
- Additional payment_options fields.
- payment_method
- Payment method used for paying invoices generated by this subscription. The ID is a string starting with card_ or other_.
- product
- ID of a product object. String starting with product_ Relevant to List Subscriptions.
- simultaneous_invoice
- Determines when the subscription invoice is issued.
  true - Payment is created when the invoice is issued.
  false - Payment is created one hour after the invoice is issued.
- status
- Status of the subscription. One of the following:
  active - The customer is currently paying for this subscription.
  canceled - The customer has canceled this subscription, but it remains in the Rapyd database.
  past_due - Payment for this subscription was not received by the end of the billing period.
  trialing - The subscription is in its free trial period.
  unpaid - An error occurred in the payment for this subscription.
- subscription_items
- An object containing the following fields:
  data
  Array of objects that describe individual subscription items.
  created
  The time the subscription item was created, in Unix time. Response only.
  id
  ID of the Subscription Item object. String starting with subi_.
  metadata
  A JSON object defined by the client. See Metadata.
  plan
  The pricing plan that defines the product and pricing structure associated with this subscription item. Cannot be a plan that is already part of the subscription.
  active
  Indicates whether the plan is available to be added to a subscription.
  aggregate_usage
  Determines which quantity is used to calculate the pricing. One of the following:
  max - The maximum reported usage within the billing cycle.
  sum - The sum of all usage during a billing cycle.
  last_during_period - The last usage reported within the billing cycle.
  last_ever - The last usage ever reported, if the latest billing cycles contain no usage at all.
  amount
  The amount to charge, in units of the currency defined in currency.
  Relevant when billing_scheme is set to per_unit.
  billing_scheme
  Describes how to compute the price. One of the following:
  per_unit - The amount specified in amount is charged for each unit.
  tiered - The unit pricing is computed using a tiering strategy as defined with the tiers and tiers_mode fields.
  created_at
  Time the plan object was created, in Unix time.
  currency_code
  Three-letter ISO 4217 code for the currency used in fields that represent monetary amounts.
  id
  Unique ID for this plan.
  interval
  Specifies the units used in defining the billing cycle. One of the following:
  day
  week
  month
  year
  interval_count
  Number of time intervals in the billing cycle. Integer. See interval.
  metadata
  A JSON object defined by the client. See Metadata.
  nickname
  Brief description of the plan.
  product
  Describes this product in the plan.
  active
  Indicates whether the product is currently available for purchase.
  attributes
  Up to 5 unique alphanumeric strings defined by the merchant. Each string defines the key in a key-value pair in the attributes object in the corresponding sku objects.
  created_at
  Time of creation of this product, in Unix time.
  description
  Full text description of the product.
  id
  Unique string for identification of the product.
  images
  Images associated with the product. Array of strings.
  metadata
  A JSON object defined by the client. See Metadata.
  name
  The name of the product or service that appears in the line items in invoices.
  package_dimensions
  Describes the physical size and weight of the product. Contains the following fields:
  height - Height of the package, in units defined by the client.
  length - Length of the package, in units defined by the client.
  weight - Weight of the package, in units defined by the client.
  width - Width of the package, in units defined by the client.
  shippable
  Indicates whether the product can be shipped.
  skus
  An array of SKUs associated with this product. Relevant when type is goods.
  To add SKUs to a product, use Create SKU.
  statement_descriptor
  Description that is suitable for a customer's statement. Limited to 22 characters.
  Relevant when type is service. Must be null when type is goods.
  type
  One of the following:
  services - Relevant to subscriptions and plans.
  goods - Relevant to orders and SKUs.
  unit_label
  Determines what one unit of this product is called on customers’ receipts and invoices, such as minutes, viewings, kilometers or packages.
  Relevant when type is service. Must be null when type is goods.
  updated_at
  Time that this product was last updated, in Unix time.
  tiers
  Defines a tiered pricing structure. Each tier object represents a pricing tier. Relevant when billing_scheme is set to tiered. Contains the following fields:
  amount - The price for each item in this tier. Decimal number.
  up_to - The upper volume limit for this tier. Valid values: inf (infinite) or an integer.
  flat_amount - Extra amount added to the entire tier. Default is 0.
  tiers_mode
  Determines the mode for calculating the total tiered charge. One of the following values:
  graduated - The total cost at each price tier is calculated separately, then all tier charges are added together.
  volume - The total cost is calculated as the number of service units multiplied by the applicable tier price.
  transform_usage
  Defines the transformation that is applied to the reported usage before the billed price is computed. The transformation divides the quantity by the divisor specified in divide_by, then rounds up or down according to the setting in round. Relevant when billing_scheme is set to per_unit. Relevant when billing_scheme is set to per_unit. For more information, see Transformation Pricing in Pricing Plans. Contains the following fields:
  divide_by
  Indicates the divisor in the transformation calculation. Integer.
  1
  round
  Indicates whether the reported number of units should be rounded up or down to the next whole quantity specified in divide_by.
  up
  trial_period_days
  The number of days in the customer's free trial period. Integer. Range: 0-730.
  usage_type
  Determines whether the customer is billed when the service is not actually used. Relevant when billing_scheme is set to per_unit. One of the following:
  metered - The customer is billed only for actual usage.
  licensed - The customer is billed even if the service is not used.
  quantity
  The number of units of the service defined in the plan. Integer. This number can be updated during the billing cycle using Update Subscription or Update Subscription Item.
  has_more
  Indicates that the number of subscription_items records is greater than the number of the returned records.
  total_count
  Number of subscription_items records.
  url
  URL for the record of all subscription items for this subscription.
- tax_percent
- The percentage tax rate that is applied to the subtotal of the invoice, after subtracting all discounts. Decimal.
- total_count
- Total number of subscription items.
- trial_end
- The date and time of the end of the customer's free trial period, in Unix time, or the string now. Relevant when trial_period_days is not defined.
- trial_from_plan
- Determines whether the subscription uses the free trial period defined in the plan.
  - true - Uses the trial period defined in the plans added to the subscription. When trial_from_plan is true, all plans in the subscription must have the same value for trial_period_days.
  - false - Uses the trial period defined in the subscription.
- trial_period_days
- The number of days in the customer's free trial period. Integer. Range: 0-730.
  Relevant when trial_end is not defined.
- trial_start
- Date and time of the start of the customer's free trial period, inUnix time.
- type
- The type of the subscription.
  - payment

Code Samples

.NET

using System;
using System.Text.Json;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                var requestObj = new
                {
                    customer = "cus_ec543c4dfcf6ac1d015b2e3e4fd07180",
                    billing = "pay_automatically",
                    billing_cycle_anchor = "",
                    cancel_at_period_end = true,
                    coupon = "",
                    days_until_due = string.Empty,
                    payment_method = "card_156da7de485275ad0bae798b7cb8fea1",
                    subscription_items = new Object[] {
                        new {
                            plan = "plan_51788cf4ed1b672cb0a2a97773887f5b",
                            quantity = 1
                        }
                    },
                    metadata = new
                    {
                        merchant_defined = true
                    },
                    tax_percent = 10.5,
                    trial_end = 0,
                    trial_from_plan = true,
                    trial_period_days = string.Empty,
                    plan_token = ""
                };

                string request = JsonSerializer.Serialize(requestObj);

                string result = RapydApiRequestSample.Utilities.MakeRequest("POST", "/v1/payments/subscriptions", request);
    
                Console.WriteLine(result);
            }
            catch (Exception e)
            {
                Console.WriteLine("Error completing request: " + e.Message);
            }
        }
    }
}

JavaScript

const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;

async function main() {
  try {
    const body = {
      customer: 'cus_ec543c4dfcf6ac1d015b2e3e4fd07180',
      billing: 'pay_automatically',
      billing_cycle_anchor: '',
      cancel_at_period_end: true,
      coupon: '',
      days_until_due: null,
      payment_method: 'card_156da7de485275ad0bae798b7cb8fea1',
      subscription_items: [
        {
          plan: 'plan_51788cf4ed1b672cb0a2a97773887f5b',
          quantity: 1
        }
      ],
      metadata: {
        merchant_defined: true
      },
      tax_percent: 10.5,
      trial_end: 0,
      trial_from_plan: true,
      trial_period_days: null,
      plan_token: ''
    };
    const result = await makeRequest('POST', '/v1/payments/subscriptions', body);

    console.log(result);
  } catch (error) {
    console.error('Error completing request', error);
  }
}

PHP

<?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/<path-to-your-utility-file>/utilities.php";
include($path);

try {
    $body = [
        "customer" => "cus_ec543c4dfcf6ac1d015b2e3e4fd07180",
        "billing" => "pay_automatically",
        "billing_cycle_anchor" => "",
        "cancel_at_period_end" => true,
        "coupon" => "",
        "days_until_due" => null,
        "payment_method" => "card_156da7de485275ad0bae798b7cb8fea1",
        "subscription_items" => [
            array(
                "plan" => "plan_51788cf4ed1b672cb0a2a97773887f5b",
                "quantity" => 1
            )
        ],
        "metadata" => array(
            "merchant_defined" => true
        ),
        "tax_percent" => 10.5,
        "trial_end" => 0,
        "trial_from_plan" => true,
        "trial_period_days" => null,
        "plan_token" => ""
    ];
    $object = make_request('post', '/v1/payments/subscriptions', $body);
    var_dump($object);
} catch(Exception $e) {
    echo "Error: $e";
}
?>

Python

from pprint import pprint

from utilities import make_request

subscription = {
    "customer": "cus_ec543c4dfcf6ac1d015b2e3e4fd07180",
    "billing": "pay_automatically",
    "billing_cycle_anchor": "",
    "cancel_at_period_end": True,
    "coupon": "",
    "days_until_due": "",
    "payment_method": "card_156da7de485275ad0bae798b7cb8fea1",
    "subscription_items": [
        {
            "plan": "plan_51788cf4ed1b672cb0a2a97773887f5b",
            "quantity": 1
        }
    ],
    "metadata": {
        "merchant_defined": True
    },
    "tax_percent": 10.5,
    "trial_end": 0,
    "trial_from_plan": True,
    "trial_period_days": "",
    "plan_token": "",
}

result = make_request(method='post', path='/v1/subscriptions', body=subscription)
pprint(result)

/v1/payments/subscriptions

Create Subscription

curl -X post
https://sandboxapi.rapyd.net/v1/payments/subscriptions
-H 'access_key: your-access-key-here'
-H 'Content-Type: application/json'
-H 'idempotency: your-idempotency-parameter-here'
-H 'salt: your-random-string-here'
-H 'signature: your-calculated-signature-here'
-H 'timestamp: your-unix-timestamp-here'
-d '{
    "customer": "cus_ec543c4dfcf6ac1d015b2e3e4fd07180",
    "billing": "pay_automatically",
    "cancel_at_period_end": true,
    "coupon": "",
    "payment_method": "card_156da7de485275ad0bae798b7cb8fea1",
    "subscription_items": [
        {
            "plan": "plan_51788cf4ed1b672cb0a2a97773887f5b",
            "quantity": 1
        }
    ],
    "metadata": {
        "merchant_defined": true
    },
    "tax_percent": 10.5,
    "trial_end": 0,
    "trial_from_plan": true,
    "trial_period_days": null
}
'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "0192a34d-c0ad-4b89-b7b3-dbe3129cba66"
    },
    "data": {
        "id": "sub_4d9bcdf0a768a90e2f39a04ae1331e90",
        "billing": "pay_automatically",
        "billing_cycle_anchor": 1592379647,
        "created_at": 1592379647,
        "customer_token": "cus_ec543c4dfcf6ac1d015b2e3e4fd07180",
        "days_until_due": null,
        "metadata": {
            "merchant_defined": true
        },
        "tax_percent": 10.5,
        "cancel_at_period_end": true,
        "canceled_at": null,
        "current_period_end": 1594971647,
        "current_period_start": 1592379647,
        "discount": null,
        "ended_at": null,
        "subscription_items": {
            "data": [
                {
                    "id": "subi_a9f34be0551bf85ffb13e4fdb6107d6d",
                    "created": 1592379647,
                    "metadata": null,
                    "quantity": 1,
                    "plan": {
                        "id": "plan_51788cf4ed1b672cb0a2a97773887f5b",
                        "aggregate_usage": "sum",
                        "amount": 0,
                        "billing_scheme": "tiered",
                        "created_at": 1592311574,
                        "currency": "USD",
                        "interval": "month",
                        "interval_count": 1,
                        "metadata": {
                            "merchant_defined": true
                        },
                        "product": "product_ab9599d248f6d4d4311148aea68e20d0",
                        "nickname": "Basic parking",
                        "tiers": [
                            {
                                "amount": 15,
                                "up_to": "inf",
                                "flat_amount": 0
                            }
                        ],
                        "tiers_mode": "volume",
                        "transform_usage": {
                            "divide_by": 0,
                            "round": ""
                        },
                        "trial_period_days": 0,
                        "usage_type": "licensed"
                    }
                }
            ],
            "has_more": false,
            "total_count": 0,
            "url": "/v1/subscription_items?subscription=sub_4d9bcdf0a768a90e2f39a04ae1331e90"
        },
        "status": "active",
        "trial_end": null,
        "trial_start": null,
        "payment_method": "card_156da7de485275ad0bae798b7cb8fea1",
        "payment_fields": null,
        "payout_fields": null,
        "type": "payment",
        "simultaneous_invoice": true
    }
}

Create Subscription with Payment Fields

curl -X post
https://sandboxapi.rapyd.net/v1/payments/subscriptions
-H 'access_key: your-access-key-here'
-H 'Content-Type: application/json'
-H 'idempotency: your-idempotency-parameter-here'
-H 'salt: your-random-string-here'
-H 'signature: your-calculated-signature-here'
-H 'timestamp: your-unix-timestamp-here'
-d '{
    "customer": "cus_ec543c4dfcf6ac1d015b2e3e4fd07180",
    "billing": "pay_automatically",
    "cancel_at_period_end": false,
    "coupon": "",
    "payment_method": "card_156da7de485275ad0bae798b7cb8fea1",
    "subscription_items": [
        {
            "plan": "plan_51788cf4ed1b672cb0a2a97773887f5b",
            "quantity": 1
        }
    ],
    "metadata": {
        "merchant_defined": "true"
    },
    "tax_percent": 10.5,
    "trial_end": 0,
    "trial_from_plan": true,
    "trial_period_days": "",
    "payment_fields": {
        "error_payment_url": "https://error.example1234.net",
        "complete_payment_url": "https://complete.example5678.net"
    }
}
'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "ad65f71a-c208-479d-9e79-8cce9ca2f05b"
    },
    "data": {
        "id": "sub_324ee75f8c26f1df94bc8cc693f3c729",
        "billing": "pay_automatically",
        "billing_cycle_anchor": 1592380020,
        "created_at": 1592380020,
        "customer_token": "cus_ec543c4dfcf6ac1d015b2e3e4fd07180",
        "days_until_due": null,
        "metadata": {
            "merchant_defined": "true"
        },
        "tax_percent": 10.5,
        "cancel_at_period_end": false,
        "canceled_at": null,
        "current_period_end": 1594972020,
        "current_period_start": 1592380020,
        "discount": null,
        "ended_at": null,
        "subscription_items": {
            "data": [
                {
                    "id": "subi_8de71d1894d62170571afbe14df1f848",
                    "created": 1592380020,
                    "metadata": null,
                    "quantity": 1,
                    "plan": {
                        "id": "plan_51788cf4ed1b672cb0a2a97773887f5b",
                        "aggregate_usage": "sum",
                        "amount": 0,
                        "billing_scheme": "tiered",
                        "created_at": 1592311574,
                        "currency": "USD",
                        "interval": "month",
                        "interval_count": 1,
                        "metadata": {
                            "merchant_defined": true
                        },
                        "product": "product_ab9599d248f6d4d4311148aea68e20d0",
                        "nickname": "Basic parking",
                        "tiers": [
                            {
                                "amount": 15,
                                "up_to": "inf",
                                "flat_amount": 0
                            }
                        ],
                        "tiers_mode": "volume",
                        "transform_usage": {
                            "divide_by": 0,
                            "round": ""
                        },
                        "trial_period_days": 0,
                        "usage_type": "licensed"
                    }
                }
            ],
            "has_more": false,
            "total_count": 0,
            "url": "/v1/subscription_items?subscription=sub_324ee75f8c26f1df94bc8cc693f3c729"
        },
        "status": "active",
        "trial_end": null,
        "trial_start": null,
        "payment_method": "card_156da7de485275ad0bae798b7cb8fea1",
        "payment_fields": {
            "error_payment_url": "https://error.example1234.net",
            "complete_payment_url": "https://complete.example5678.net"
        },
        "payout_fields": null,
        "type": "payment",
        "simultaneous_invoice": true
    }
}

Create Subscription with Multiple Items

curl -X post
https://sandboxapi.rapyd.net/v1/payments/subscriptions
-H 'access_key: your-access-key-here'
-H 'Content-Type: application/json'
-H 'idempotency: your-idempotency-parameter-here'
-H 'salt: your-random-string-here'
-H 'signature: your-calculated-signature-here'
-H 'timestamp: your-unix-timestamp-here'
-d '{
    "customer": "cus_5bee14584a78638ba717e746be62ee01",
    "billing": "pay_automatically",
    "cancel_at_period_end": false,
    "payment_method": "card_794ddbfd19fcc548c8399ca957f11a24",
    "subscription_items": [
        {
            "plan": "plan_27921a1d4ebeb2db2e6aadf69a0094b1",
            "quantity": 1
        },
        {
            "plan": "plan_9609f87fcf8144a53ce52964497b1bab",
            "quantity": 1
        }
    ]
}
'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "4c6949d5-bf37-4835-88bc-6f4d60edf5ff"
    },
    "data": {
        "id": "sub_1b33870bcc1b5d1b62da638170efa843",
        "billing": "pay_automatically",
        "billing_cycle_anchor": 1671427743,
        "created_at": 1671427743,
        "customer_token": "cus_5bee14584a78638ba717e746be62ee01",
        "days_until_due": 30,
        "metadata": {},
        "tax_percent": 0,
        "cancel_at_period_end": false,
        "canceled_at": null,
        "current_period_end": 1674106143,
        "current_period_start": 1671427743,
        "discount": null,
        "ended_at": null,
        "subscription_items": {
            "data": [
                {
                    "id": "subi_345afc1b6b0f48923593034ac3cf55d6",
                    "created": 1671427743,
                    "metadata": null,
                    "quantity": 1,
                    "plan": {
                        "id": "plan_27921a1d4ebeb2db2e6aadf69a0094b1",
                        "aggregate_usage": "sum",
                        "amount": 5,
                        "billing_scheme": "per_unit",
                        "created_at": 1669022872,
                        "currency": "USD",
                        "interval": "month",
                        "interval_count": 1,
                        "metadata": {},
                        "product": "product_8a9a3932967cb7f2caf91d3cc07be5c8",
                        "nickname": "Basic",
                        "tiers": [],
                        "tiers_mode": "",
                        "transform_usage": {
                            "divide_by": 1,
                            "round": "up"
                        },
                        "trial_period_days": 0,
                        "usage_type": "licensed"
                    }
                },
                {
                    "id": "subi_c5ab875d7288b4b238440e1cdfd82339",
                    "created": 1671427743,
                    "metadata": null,
                    "quantity": 1,
                    "plan": {
                        "id": "plan_9609f87fcf8144a53ce52964497b1bab",
                        "aggregate_usage": "max",
                        "amount": 50,
                        "billing_scheme": "per_unit",
                        "created_at": 1669288713,
                        "currency": "USD",
                        "interval": "month",
                        "interval_count": 1,
                        "metadata": {},
                        "product": "product_2ddd6f6b43f598d30543ef23ab806b58",
                        "nickname": "Premium Metered",
                        "tiers": [],
                        "tiers_mode": "",
                        "transform_usage": {
                            "divide_by": 1,
                            "round": "up"
                        },
                        "trial_period_days": 0,
                        "usage_type": "metered"
                    }
                }
            ],
            "has_more": false,
            "total_count": 0,
            "url": "/v1/subscription_items?subscription=sub_1b33870bcc1b5d1b62da638170efa843"
        },
        "status": "active",
        "trial_end": null,
        "trial_start": null,
        "payment_method": "card_794ddbfd19fcc548c8399ca957f11a24",
        "payment_fields": null,
        "payout_fields": null,
        "type": "payment"
    }
}

In this section:

Documentation

Create Subscription

Note

Parameters

Request Header Parameters

Request Body Parameters

Note

Note

Response Parameters

Code Samples

Search results