Create the Subscription soliciation
This is the initial request to the service. It will include the personal data and the cart items. There are two kind of items:
- material_subscription, that are single / static items: sunglasses or any non-customized items
- subscription_package: that may consist of a frame and 2 lenses, or a set of glasses.
The request for a new subscription solicitation is a POST call using JSON content.
Endpoint: /api/public/v1/subscriptions
Method: POST
Shopper confirmation
This endpoint will only create a solicitation. Yet, the shopper will have to go through the checkout process to confirm the subscription. You must wait for a webhook to get the confirmation of the operation.
Payload example:
{
"merchant": {
"id": "tienda_moderna",
"store_ref": "tienda_moderna"
},
"reference": "ref001-5",
"operator_ref": "[email protected]",
"cart_items": [
{
"reference": "glasses1",
"type": "material_subscription",
"name": "Progressive Glasses",
"quantity": 1,
"price_with_tax": 35000,
"subscription_vat_rate": 2100
},
{
"quantity": 1,
"type": "subscription_package",
"name": "Glasses Package",
"price_with_tax": 75000,
"subscription_vat_rate": 2100,
"items": [
{
"reference": "frame1",
"type": "material_subscription",
"name": "Designer Frame",
"quantity": 1,
"price_with_tax": 40000,
"subscription_vat_rate": 2100
},
{
"reference": "lenses1",
"type": "material_subscription",
"name": "Anti-glare Lenses",
"quantity": 1,
"price_with_tax": 35000,
"subscription_vat_rate": 2100
}
]
}
],
"given_names": "John",
"surnames": "Doe Jr",
"mobile_phone": "679959234",
"email": "[email protected]",
"date_of_birth": "2000-12-20",
"nin": "12345678Z",
"nin_control": "0012201M",
"address": "C falsa, 123",
"postal_code": "01234",
"city": "Barcelona"
}
Field explanation
| Field Path | Format | Example | Description |
|---|---|---|---|
| merchant.id | String | merchant_1 | Provided by sequra’s onboarding team |
| merchant.store_ref | String | store_abc | Shared with Sequra’s onboarding team |
| operator_ref | [email protected] | Shared with Sequra’s onboarding team | |
| reference | String | pos_1234 | Internal id generated at Merchant’s PoS |
| price_with_tax (and any other price property) | Integer | 35000 | Price in cents. 350.00€ |
| subscription_vat_rate (and any other rate property) | Integer | 2100 | Percentage multiplied by 100 = 21.00% |
Checkout our swagger documentation for more details on the payload fields
Response
{
"id": 7,
"created_at": "2025-07-23T12:31:49.651Z",
"activated_at": null,
"renewal_at": null,
"current_month": 0,
"total_months": 24,
"customer": {
"given_names": "Iván",
"surnames": "Cinque Junior",
"email": "",
"phone": null,
"full_name": "Iván Cinque Junior"
},
"status": "draft",
"payment_status": "paid",
"reference": "ref001-5",
"available_actions": {
"cancel": false,
"withdraw": true,
"resend_sms": true,
"add_product": false,
"change_item": false,
"activate_product": false,
"use_warranty": false,
"update_customer_info": false,
"update_payment_info": false,
"change_graduation": false,
"reset_sms_count": false,
"receive_gift_kit": false,
"extend_period": false
},
"credit_card": null,
"credit_card_type": null,
"contract_number": null,
"discounts": null,
"confirmed_at": null,
"last_delivery_date": null,
"next_delivery_date": null,
"gift_kits_remaining": 4,
"gift_kits_delivered": 0,
"last_persisted_cart": {
"id": 7,
"reference": "ref001-5",
"code": "V9xHtx513GMqDNct",
"cart_items": [
{
"id": "74c1c0e9-8966-4156-a46d-7605a2dec81e",
"type": "material_subscription",
"reference": "glasses1",
"reference_uuid": "e7342263-c0f3-41f3-b0a1-0e307fc39588",
"name": "Progressive Glasses",
"price_with_tax": {
"value": 35000,
"string": "350,00 €"
},
"quantity": 1,
"total_with_tax": {
"value": 35000,
"string": "350,00 €"
},
"status": "pending",
"activated_at": "",
"subscription_price": {
"value": 1458,
"string": "14,58 €"
},
"discount_type": null,
"discount_amount": null,
"original_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"original_subscription_price": {
"value": 0,
"string": "0,00 €"
},
"catalogue_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"catalogue_subscription_price": {
"value": 0,
"string": "0,00 €"
},
"line_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"line_subscription_price": {
"value": 0,
"string": "0,00 €"
}
},
{
"id": "91fca517-db0d-41b1-8f8b-dc51a57761c9",
"type": "subscription_package",
"reference": null,
"reference_uuid": "c61594e3-3a32-45ff-82f9-5c92b1cc52d6",
"name": "Glasses Package",
"price_with_tax": {
"value": 75000,
"string": "750,00 €"
},
"quantity": 1,
"total_with_tax": {
"value": 75000,
"string": "750,00 €"
},
"status": "pending",
"activated_at": "",
"subscription_price": {
"value": 3125,
"string": "31,25 €"
},
"discount_type": null,
"discount_amount": null,
"original_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"original_subscription_price": {
"value": 0,
"string": "0,00 €"
},
"catalogue_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"catalogue_subscription_price": {
"value": 0,
"string": "0,00 €"
},
"line_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"line_subscription_price": {
"value": 0,
"string": "0,00 €"
},
"items": [
{
"id": "a34bc81b-d8e8-48cf-9500-ee5d726e28bb",
"type": "material_subscription",
"reference": "frame1",
"reference_uuid": null,
"name": "Designer Frame",
"price_with_tax": {
"value": 40000,
"string": "400,00 €"
},
"quantity": 1,
"total_with_tax": {
"value": 40000,
"string": "400,00 €"
},
"status": "pending",
"activated_at": "",
"subscription_price": {
"value": 1667,
"string": "16,67 €"
},
"discount_type": null,
"discount_amount": null,
"original_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"original_subscription_price": {
"value": 0,
"string": "0,00 €"
},
"catalogue_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"catalogue_subscription_price": {
"value": 0,
"string": "0,00 €"
},
"line_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"line_subscription_price": {
"value": 0,
"string": "0,00 €"
}
},
{
"id": "277cf119-9981-40a3-8a68-a2acd2568b46",
"type": "material_subscription",
"reference": "lenses1",
"reference_uuid": null,
"name": "Anti-glare Lenses",
"price_with_tax": {
"value": 35000,
"string": "350,00 €"
},
"quantity": 1,
"total_with_tax": {
"value": 35000,
"string": "350,00 €"
},
"status": "pending",
"activated_at": "",
"subscription_price": {
"value": 1458,
"string": "14,58 €"
},
"discount_type": null,
"discount_amount": null,
"original_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"original_subscription_price": {
"value": 0,
"string": "0,00 €"
},
"catalogue_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"catalogue_subscription_price": {
"value": 0,
"string": "0,00 €"
},
"line_price_with_tax": {
"value": 0,
"string": "0,00 €"
},
"line_subscription_price": {
"value": 0,
"string": "0,00 €"
}
}
]
}
],
"sms_mobile_phone": "679959234",
"status": "pending",
"total_with_tax": {
"value": 160000,
"string": "1.600,00 €"
},
"meta": {},
"created_at": "2025-07-23T12:31:49.488Z",
"discount": {
"value": 0,
"string": "0,00 €"
},
"other_payment": null,
"cart_handling": null,
"cart_registration": null,
"setup_fee": null,
"desired_first_charge_on": null,
"solicitation": null,
"installments_count": null,
"operator_ref": "[email protected]",
"resettable": false,
"can_reset": false,
"can_resend_sms": true,
"customer_data": {
"given_names": "Iván",
"surnames": "Cinque Junior",
"nin": "12345678Z",
"email": "",
"phone": "",
"dob": "2000-12-20"
},
"order_uuid": null,
"subscription_id": 7,
"withdrawable_subscription": true,
"currency": "EUR"
},
"subscription_events": [
{
"id": "d697a495-3a34-441d-a484-a32878a45ef1",
"subscription_id": 7,
"type": "subscription_created",
"data": {
"cart_id": 7
},
"created_at": "2025-07-23T12:31:49.710Z"
}
]
}Updated about 3 hours ago