Buvei
API ReferenceWebhook Events

TRANSACTION

A card authorisation, capture, decline, refund, or reversal occurred.

Delivered for every state change in the lifecycle of a card transaction.

Headers

Standard webhook headers — see Webhook security.

Payload

eventIdstring
eventTypestring
Always "TRANSACTION".
timestampinteger
Epoch milliseconds.
dataobject
Response
{
  "eventId": "e_abc123def456",
  "eventType": "TRANSACTION",
  "timestamp": 1640995700000,
  "data": {
    "transactionId": "tc_xyz789",
    "cardId": "cid_1234567890",
    "cardNumber": "555543******1234",
    "description": "Amazon.com",
    "country": "US",
    "reason": null,
    "preAuthAmount": 1500,
    "preAuthCurrency": "USD",
    "preAuthTime": 1640995600000,
    "settlementAmount": 1500,
    "settlementCurrency": "USD",
    "settlementTime": 1640995700000,
    "status": "COMPLETE",
    "fee": 15
  }
}

Event order is not guaranteed. A COMPLETE may arrive before its PENDING. Use the status field on the incoming event, not your assumption of state machine progress.

On this page

Headers
Payload