---
title: "Create a partner subscription token"
method: POST
path: "/partner/billing/token"
tags: ["Partner Billing"]
---

# Create a partner subscription token

`POST /partner/billing/token`

Creates a partner subscription token (called by partner using retailer's access token)

🔒 Requires: `billing:partner_subscription:write` scope

## Request body

- PartnerSubscriptionTokenRequest — PartnerSubscriptionTokenRequest represents the request's body for subscription token API
  - `components` PartnerSubscriptionTokenComponent[] — Components is a list of components to add on to the plan
    - `component_handle` string, required — Unique reference to the component to be included in the new subscription
    - `component_price_handle` string, required — Unique reference to the component price point
    - `quantity` integer, required — How many components should be added
  - `coupon_code` string — CouponCode is the coupon code to be attached to the activation
  - `price_handle` string, required — ProductPricePointHandle is the product price point handle
  - `product_handle` string, required — ProductHandle is the product handle
  - `return_url` string, required — ReturnURL is the URL to which the user is redirected to after giving his/her consent

## Response `200`

- object
  - `data` PartnerSubscriptionTokenResponse — PartnerSubscriptionTokenResponse contains the token and its expiration time
    - `expires_at` string — ExpiresAt is the exact time of token expiry in UTC timezone and displayed in RFC3339 format
    - `expires_in` string — ExpiresIn is the number of seconds till the token is expired
    - `token` string — Token is a randomly generated string that is a required parameter for consent page

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)