---
title: "Solicit subscription"
method: POST
path: "/subscriptions"
tags: ["Subscriptions"]
---

# Solicit subscription

`POST /subscriptions`

## Headers

- `Sequra-Merchant-Id` string, required

## Request body

- SubscriptionSolicitation
  - `order` object, required
    - `selected_credit_agreement` object, required
      - `product` string, required
    - `merchant_reference` object
      - `order_ref_1` string, required
      - `order_ref_2` string
      - `subscription_ref_1` string
    - `merchant` object, required
      - `id` string, required
      - `notify_url` string
      - `events_webhook` object
        - `url` string, required
        - `parameters` object
      - `store_ref` string
      - `operator_ref` string
      - `return_url` string
      - `implicit_mobile_phone_validation` object
        - `validated_mobile_phones` string[]
    - `cart` object, required
      - `currency` string, required
      - `gift` boolean, required
      - `order_total_with_tax` integer, required
      - `subscription_total_price` integer
      - `subscription_period` integer
      - `items` object[], required
    - `customer` object
      - `given_names` string
      - `surnames` string
      - `date_of_birth` string, date
      - `nin` string
      - `email` string, email
      - `city` string
      - `address` string
      - `postal_code` string
    - `delivery_method` object
      - `name` string, required
      - `home_delivery` boolean
    - `invoice_address` object
      - `given_names` string
      - `surnames` string
      - `company` string, required
      - `address_line_1` string, required
      - `address_line_2` string, required
      - `postal_code` string, required
      - `city` string, required
      - `country_code` string, required
      - `mobile_phone` string
    - `state` string
    - `first_charge_date` string
    - `subscription` object
      - `discounts` unknown[]
        - unknown
    - `platform` object, required
      - `name` string, required
      - `version` string, required
      - `uname` string, required
      - `db_name` string, required
      - `db_version` string, required
      - `plugin_version` string
      - `php_version` string
      - `partner_ref` string
    - `gui` object
      - `layout` string

## Response `204`

Subscription renewed

## Other responses

- `403` — Access forbidden
- `409` — Subscription solicitation failed

---

[API](https://skmtc.dev/sequra/apis/checkout-api.md) · [All operations](https://skmtc.dev/sequra/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequra/checkout-api/revisions/2b0b60c52d04/schema)