Skip to main content

Webhook: Order update notifications

We can notify your IT team whenever an order is updated on our side.

This mechanism allows your systems to stay synchronized with the latest order information in near real time, including key changes such as status updates.

Overview​

Each time an order is modified, our system can send an HTTP callback to an endpoint exposed on your infrastructure.

Request format​

Our system will call your webhook endpoint using the following structure:

POST /your-endpoint/
Host: www.your-server.com
Content-Type: application/json
Authorization: Bearer xxxxx
{
  "orderId": "XY-123456789",
  "attempts": 3
}

Payload description​

  • orderId: unique identifier of the updated order.
  • attempts: number of delivery attempts already made for this notification.

Acknowledgment requirement​

When your system receives the webhook request, it must respond with an HTTP 200 OK status code.

If we do not receive a successful response, our retry mechanism will resend the same notification with exponential backoff for up to 48 hours.

To ensure a reliable integration:

  • acknowledge the request quickly with an HTTP 200 OK response;
  • process the payload asynchronously when possible;
  • make the handling idempotent to avoid duplicate processing;
  • log the request for monitoring and troubleshooting;
  • validate the Authorization header and the associated token.

Configuration​

To activate and configure the webhook for a given environment, please contact our P2P team.

They will provide the required endpoint and security details for the environment you want to integrate with.