Webhook

Wallet balance changed

​

Fires when your wallet balance changes — after a sale, a payout, or a refund. Carries the new available and pending amounts.

Body

required
application/json
  • data
    Type: object
    required

    Your wallet balance after the change.

    Properties: 3
  • eventId
    Type: string
    required

    Idempotency key. Stable across retries of the same delivery; safe to dedupe on.

  • timestamp
    Type: stringFormat: date-time
    required

    When this webhook was emitted (ISO 8601, UTC).

  • type
    const:  
    balance.updated
    required

Responses

  • 2XX

    Acknowledged. Return any 2XX status to ack receipt; non-2XX triggers Svix's retry schedule.

Request Example for postbalance.updated
{
  "type": "balance.updated",
  "eventId": "665f3a2b1c8d4e9f7a6b5c4d.12840.4210",
  "timestamp": "2026-06-18T08:00:01.000Z",
  "data": {
    "available": {
      "amount": 128.4,
      "currency": "EUR"
    },
    "pending": {
      "amount": 42.1,
      "currency": "EUR"
    },
    "updatedAt": "2026-06-18T08:00:00.000Z"
  }
}
No Body

Acknowledged. Return any 2XX status to ack receipt; non-2XX triggers Svix's retry schedule.

Previous
Account updated
Next
Inventory quantities changed