Webhook Events Summary

Overview of all webhook events sent by VesuvioPay

VesuvioPay sends webhooks for the following categories:

Cart Events (Currently Active):

• cart.created - New cart created
• cart.item_added - Item added to cart
• cart.item_updated - Cart item quantity changed
• cart.item_removed - Item removed from cart
• cart.abandoned - Cart inactive for configured period
• cart.recovered - Customer resumed abandoned cart
• cart.cleared - All items removed from cart
• cart.checkout_started - Customer began checkout process

Order Events (Currently Active):

• order.created - Order successfully placed (NOT sent for SDK-created orders)
• order.status_updated - Order status changed (NOT sent for SDK updates)
• order.confirmed - Order confirmed (NOT sent for SDK updates)
• order.shipped - Order shipped (NOT sent for SDK updates)
• order.delivered - Order delivered (NOT sent for SDK updates)
• order.cancelled - Order cancelled (NOT sent for SDK updates)

Product Events (Future - Admin Panel):

• product.created - Product created in admin panel
• product.updated - Product modified in admin panel
• product.variant_created - New variant added
• product.variant_updated - Variant modified

SDK Integration Notes:

To prevent webhook loops, the following do NOT trigger webhooks:

• Orders created via POST /api/v1/orders (external platform orders)
• Order status updates via PUT /api/v1/orders/{id}/status
• Order cancellations via PUT /api/v1/orders/{id}/cancel
• Product/variant updates via SDK endpoints

Webhook Management:

Use the following endpoints to manage your webhooks:

• POST /api/v1/webhooks - Create webhook endpoint
• GET /api/v1/webhooks - List webhook endpoints
• PUT /api/v1/webhooks/{id} - Update webhook endpoint
• DELETE /api/v1/webhooks/{id} - Delete webhook endpoint
• POST /api/v1/webhooks/{id}/test - Test webhook endpoint