Webhook Events
Order events
These events are sent to both direct merchants and partners.
| Event | Description | When it fires |
|---|
order.confirmed | Payment completed successfully | After buyer completes payment |
order.cancelled | Order was cancelled | After cancellation via API or timeout |
order.refunded | Refund processed | After refund is completed |
order.failed | Payment failed | After gateway rejects payment |
Partner events
These events are sent only to partners.
| Event | Description | When it fires |
|---|
store.activated | A new store was onboarded | After a store completes activation on the partner’s platform |
store.updated | Store configuration changed | After a store updates its settings |
Payload structure
All webhook payloads follow the same structure:
{
"event": "order.confirmed",
"data": {
"id_order": 12345,
"id_external": "order-12345",
"status": "confirmed",
"amount": 50000,
"currency": "COP",
"payment_gateway": "nequi",
"created_at": "2025-01-18T10:30:00.000Z",
"confirmed_at": "2025-01-18T10:31:15.000Z"
}
}
The id_external field contains the order_key you provided when creating the order. Use it to match webhooks to your internal records.
