Documentation
    Documentation
    • Introduction
    • Webhook
    • Integrations
      • REST Integration
      • Nodejs
      • Wordpress
    • Create Checkout Session
      POST
    • Schemas
      • webhooks
        • Webhook | Order Created
        • Webhook | Order Abandoned
        • Webhook | Order Refunded
        • Webhook | Order Failed
      • Cart Session Request
      • Cart Session Response

    Webhook

    STRABL Webhooks Integration#

    1. Introduction#

    STRABL provides webhook functionality to keep merchants’ systems synchronized with real-time order events. By configuring webhooks, merchants can receive updates automatically for order creation, updates, cancellations, refunds, chargebacks, and abandoned carts.

    Key Points#

    1.
    Dashboard Management: Merchants can log in to the Dashboard to manage webhooks.
    2.
    Multiple Webhooks: Up to 5 webhooks can be added per merchant account.
    3.
    HTTPS Only: All webhooks must be HTTPS endpoints to ensure secure communication.
    4.
    X-Client-Signature: Each webhook request includes a X-Client-Signature header. This is a Base64-encoded HMAC-SHA512 signature of the payload.
    The secret key for signature verification is provided when your platform is registered.
    Contact support if the webhook secret is not available.

    2. Webhook Events#

    STRABL sends POST requests to registered webhook endpoints for the following events:
    EventDescription
    order_createdTriggered when a new order is created.
    order_updatedTriggered when an order is updated.
    order_cancelledTriggered when an order is cancelled.
    order_refundedTriggered when an order is refunded.
    order_chargebackTriggered when a chargeback occurs.
    order_abandonedTriggered when a customer abandons a cart.
    Each webhook contains a JSON payload detailing the order and customer information.

    3. Webhook Request Structure#

    Headers#

    Content-Type: application/json
    X-Client-Signature: <Base64 encoded HMAC-SHA512 signature>

    The respective webhook schema/response can be viewed on the webhook section on the left.
    Modified at 2025-09-23 17:03:55
    Previous
    Introduction
    Next
    REST Integration
    Built with