Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wava.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Webhook Events

​
Order events

These events are sent to both direct merchants and partners.
EventDescriptionWhen it fires
order.confirmedPayment completed successfullyAfter buyer completes payment
order.cancelledOrder was cancelledAfter cancellation via API or timeout
order.refundedRefund processedAfter refund is completed
order.failedPayment failedAfter gateway rejects payment

​
Partner events

These events are sent only to partners.
EventDescriptionWhen it fires
store.activatedA new store was onboardedAfter a store completes activation on the partner’s platform
store.updatedStore configuration changedAfter 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.