Subscription contract update
| Event Group | Event Identification |
|---|---|
| subscribe | subscribe/update |
Subscription contract update
Request Headers
- X-Shopline-Topic string requiredThe unique identifier for the event.Example:
orders/edited - X-Shopline-Hmac-Sha256 string requiredThe signature of the request. Upon receiving the request, you must verify the signature to confirm the authenticity and integrity of the data.Example:
XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM= - X-Shopline-Shop-Domain string requiredThe store domain.Example:
example.myshopline.com - X-Shopline-Shop-Id string requiredThe store ID.Example:
1610418123456 - X-Shopline-Merchant-Id string requiredThe merchant ID.Example:
2000001234 - X-Shopline-API-Version string requiredThe API version.Example:
v20250601 - X-Shopline-Webhook-Id string requiredThe ID of this Webhook event.Example:
b54557e48a5fbf7d70bcd043
Request Body
billing_policyobject
Billing strategy informationinterval stringInterval units ( day , MONTH , weed , year )interval_count integerInterval valuemax_cycles integerMaximum cycleminCycles integerMinimum cycledelivery_policyobject
Shipping plandelivery_name stringShipping plan namedelivery_seq stringShipping plan single- event_type stringEvent type
- id stringSubscription contract single number
line_itemsobject[]
The information for contract lines.amount stringThe amount of the product with a precision of 2 decimal places, eg, '88.10'.amount_setobject
The product's amount in multi-currency.presentment_moneyobject
The monetary information of the buyer side.amount stringThe amount of the product with a precision of 2 decimal places, eg, '88.10'.currency_code stringThe currency code.shop_moneyobject
The monetary information of the seller side.amount stringThe amount of the product with a precision of 2 decimal places, eg, '88.10'.currency_code stringThe currency code.attributesobject[]
The attributes of the products.key stringThe attribute key or name of the product.value stringThe attribute value of the product.group_id stringThe group ID of the line item.id stringThe unique ID of the contract line item.image_url stringThe image URL of the product.pricing_policyobject[]
The discount information for the selling plan.cycle_discountsobject[]
The adjustment of the subscription cycles.adjustment_type stringThe type of discounts:FIXED_AMOUNT: a fixed amount discountPERCENTAGE: a percentage discount.adjustment_value longThe discount value in amount or a percentage.product_source stringThe source of the product:main_site: for main site productscustomize: for customized productsquantity stringThe quantity of the product.sku stringThe item number of the product.title stringThe title of the product.variant_id stringThe SKU of the line item.- status stringContract status , ACTIVE、PAUSED、EXPIRED、CANCELLED、FAILED
- store_id stringstore ID
Status Codes
After receiving a webhook notification from SHOPLINE, you must respond with the following format:
HTTP/1.1 200 OKFor more information about how to subscribe to webhooks and webhook response rules, refer to Webhook overview.
Was this article helpful to you?