---
title: "Start the subscription"
method: POST
path: "/zephr/subscribe"
tags: ["Payments"]
---

# Start the subscription

`POST /zephr/subscribe`

Uses the payment info captured by the payment provider drop-in UI and create a customer with a recurring payment.
When the payment provider responds successfully, the logged-in user will be temporarily granted all entitlements in the product's associated bundle.

## Headers

- `cookie` string

## Request body

- object
  - `product_id` string, required — Product ID/slug
  - `plan_id` string — Plan ID/slug
  - `discount_code` string — Discount/promotion code
  - `vendor_fields` object — Parameters specific to the payment provider in-use.
    - `payment_nonce` string — (Stripe) Payment method nonce from Braintree drop-in UI.
    - `skip_trial_period` boolean — (Braintree) Whether or not to skip any trial period that may be associated with this subscription. This should be `null` or not set to use the configured trial period.
    - `start_date` string — (Braintree) ISO 8601 date format which determines when the subscription will start. When the attribute is passed, the value must be in the future. Otherwise, the subscription is expected to start immediately.
    - `payment_method` string — (Stripe) Payment method from Stripe Elements UI.
    - `vault_payment_method` boolean — (Braintree) If the payment nonce requires vaulting, for example if Google Pay is being used. Defaults to false.

## Response `200`

OK

- object
  - `grant_id` string — New grant of product bundle to user.
  - `client_secret` string — (Stripe) reference to Stripe payment required to process payment in front end.
  - `payment_intent_id` string — (Stripe) reference to the payment intent if payment requires confirmation.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/zuora/apis/public-api-reference.md) · [All operations](https://skmtc.net/zuora/apis/public-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuora/public-api-reference/revisions/0400dd83950b/schema)