Skip to main content

App subscriptions_update

Webhookapp/subscriptions_update

Triggered when the recurring charge status update.

Requires the shop access scope. Minimum supported version: 202207.

Request headers​

    X-Shoplazza-Topicstring

    The event that triggered this delivery, e.g. orders/create

    Example: orders/create
    X-Shoplazza-Hmac-Sha256string

    Base64-encoded HMAC-SHA256 signature of the request body, generated with your app's Client Secret. Use it to verify the request comes from Shoplazza

    X-Shoplazza-Shop-Domainstring

    The domain of the store that generated the event

    Example: example.myshoplaza.com
    X-Shoplazza-Api-Versionstring

    The API version used to serialize the payload

    Example: 2025-06
    X-Shoplazza-Deduplication-IDstring

    Deduplication ID for this delivery. It stays the same across retries of the same event—use it for idempotency

Request body​

    activated_onstring

    Subscription activation date

    application_idstring

    App ID

    billing_onstring

    Next billing date

    cancelled_onstring

    Charge cancellation date

    capped_amountstring

    Capped amount for usage-based billing

    charge_interval_daysinteger

    Billing interval in days

    charge_timesinteger

    Number of charges (0 means unlimited)

    idstring

    Recurring app charge ID

    namestring

    Charge name shown to the merchant

    pricestring

    Recurring charge amount

    remaining_charge_timesinteger

    Remaining number of charges (always 1 when unlimited)

    statusstring

    Current status of the recurring app charge

    store_idinteger

    Store ID

    testboolean

    Whether this is a test charge

    trial_daysinteger

    Number of trial days offered by the subscription

    trial_ends_onstring

    Trial end date

    updated_atstring

    Last update time, in ISO-8601 format