User guide: Webhooks

User guide: Webhooks

πŸ”— User Guide: Webhooks

Our platform allows you to configure webhooks to receive automatic updates on key events related to your orders and incidents.

πŸ“Œ What are they for?
Webhooks allow you to keep your systems synchronized without the need for manual queries.

πŸ“Œ What are webhooks?

A webhook is an automatic call that our system makes to a URL that you previously configure every time a relevant event occurs.

For example, when the status of an order or an incident changes, Dropea can automatically send that information to your system so you can react immediately.

πŸ”‘ Initial setup

To start using webhooks, follow these steps:

  1. Log in to My Account β†’ Access Token .
  2. Create an API Key with permissions over your orders and incidents.
  3. Configure two endpoints or public URLs:
    • πŸ“¦ One to receive order status updates.
    • πŸ› οΈ Another one to receive incident status updates.

βœ… Security: HMAC signatures

To validate the authenticity of received events, each webhook can include a digital signature in the header.

Header:
X-Dropea-Hmac-Sha256

Content:
SHA256 hash generated using the POST body, i.e., the payload , and your corresponding API Key as the secret key.

This allows you to verify that the request actually comes from dropea and has not been altered.

⚠️ Important:
Signature validation is optional at the moment, but we recommend implementing it to strengthen the security of the integration.

πŸ›οΈ Order Status Update

When the status of an order is updated, Dropea sends a notification to the webhook configured with the event structure.

❌ Example 1: order changes from confirmed to cancelled 

 {"topic":"order:status_update","order_id":265494,"prev_status":"confirmed","new_status":"cancelled","updated_at":"2025-05-29 14:14:58"}

βœ… Example 2: order changes from pending to confirmed 

 {"topic":"order:status_update","order_id":265494,"prev_status":"pending","new_status":"confirmed","updated_at":"2025-05-29 14:14:58"}

πŸ” Example 3: order changes from error to pending 

 {"topic": "order:status_update",
 "order_id":265496,"prev_status":"error","new_status":"pending","updated_at":"2025-05-29 14:38:05"}

πŸ› οΈ Incident Update

When the status of an incident is updated, Dropea sends a notification to the webhook configured for incidents.

πŸ“Œ Example 1: Incident changes from pending to handled by the client 

 {
 "topic": "incidence:status_update",
 "incidence_id": 189044,
 "prev_status": "pending",
 "new_status": "client_managed",
 "updated_at": "2025-02-13 14:23:56"
 }

πŸ”„ Example 2: Incident goes from handled by the customer to solution sent 

 {
 "topic": "incidence:status_update",
 "incidence_id": 265494,
 "prev_status": "client_managed",
 "new_status": "solution_send",
 "updated_at": "2025-05-29 16:10:45"
 }

βœ… Example 3: Incident changes from solution sent to resolved 

 {
 "topic": "incidence:status_update",
 "incidence_id": 265494,
 "prev_status": "solution_send",
 "new_status": "resolved",
 "updated_at": "2025-05-29 17:42:30"
 }

πŸ“‹ Details by field

Field Guy Description
topic string It can be order:status_update or incidence:status_update , depending on the origin of the event.
order_id integer ID of the affected order. This will only be present if the topic is order:status_update .
incidence_id integer ID of the affected incident. This will only be present if the topic is incidence:status_update .
prev_status string Previous state of the object. Example: pending , confirmed , error .
new_status string New status after the change.
updated_at date Date and time of the time zone change Europe/Madrid .
πŸ• Time zone:
The updated_at field uses the Europe/Madrid time zone:
β˜€οΈ UTC+2 in summer, during daylight saving time.
❄️ UTC+1 in winter, during standard time.

    • Related Articles

    • User guide: Dropea GraphQL API with Apollo

      πŸ”Œ User guide: Dropea GraphQL API with Apollo This guide shows you how to generate an API Key in Dropea and how to use it in Apollo Studio to interact with the GraphQL API. πŸ”‘ Generate API Key in Dropea Go to My Account β†’ Access Tokens . Assign a ...

    • Chatby Activation Guide

      πŸ€– Chatby Activation Guide Chatby allows you to boost your sales, confirm orders, and automatically resolve issues thanks to artificial intelligence. ▢️ Activation Guide: The following guide shows you how to activate Chatby step by step: View Chatby ...

    • Guide to setting up my Dropea account

      πŸš€ Where can I find a guide to start setting up my Dropea account? Once you log into your dropshipper account, you will find a guide with the first steps to set up your dropshipping account. πŸ“ Where to find it? The guide can be found in the My ...

    • 1. Verify identity

      πŸ” Identity verification Before performing the verification, keep in mind that if you want to invoice as a company, the user you register must have a legal link with the company. Follow these steps to complete identity verification correctly. πŸ“± Step ...

    • Manage the return of an order

      πŸ”„ Manage the return of an order There are different types of returns depending on the reason. Below, we explain how to handle them in each case. πŸ“¦ Return due to dissatisfaction When you make a sale through Dropea, it's a wholesale transaction. If ...