Webhook Event Types

All events WickiePay can send to your webhook endpoints.

Payment Events

Event	Description
payment.created	A new payment has been created
payment.processing	Blockchain transaction detected, awaiting confirmations
payment.completed	Payment confirmed and settled
payment.underpaid	Customer sent less than the required amount
payment.expired	Payment expired without receiving full funds
payment.cancelled	Payment was cancelled

Payment Event Payload

{
  "event": "payment.completed",
  "timestamp": "2026-01-15T10:25:00Z",
  "data": {
    "uuid": "payment-uuid",
    "merchantId": "merchant-uuid",
    "type": "IN",
    "status": "COMPLETE",
    "reference": "order-12345",
    "displayCurrency": {
      "currency": "EUR",
      "amount": 100.00
    },
    "paidCurrency": {
      "currency": "USDC",
      "amount": 108.50
    },
    "transactions": [
      {
        "txHash": "0xabc...123",
        "network": "ETHEREUM",
        "confirmations": 12,
        "amount": 108.50,
        "currency": "USDC"
      }
    ],
    "metadata": {
      "orderId": "order-12345"
    }
  }
}

Channel Payment Events

Event	Description
channel.payment.detected	Deposit detected on a channel address
channel.payment.confirmed	Channel deposit confirmed
channel.payment.completed	Channel payment settled

Deposit Events

Event	Description
deposit.status_change	Deposit status changed (pending, confirmed, complete)

Withdrawal Events

Event	Description
withdrawal.status_change	Withdrawal status changed

Trade Events

Event	Description
trade.conversion.created	A new conversion was created
trade.conversion.state_changed	Conversion status changed

Balance Events

Event	Description
balance.updated	Digital asset balance changed

Approval Events

Event	Description
approval.request.status_changed	Approval request status changed
approval.vote_required	A vote is required on a pending approval

Audit Events

Event	Description
audit.api	API call audit log
audit.login	Authentication login event

Event Filtering

Subscribe to specific events or use wildcards:

# Specific event
"events": ["payment.completed"]

# Category wildcard
"events": ["payment.*"]

# All events
"events": ["*"]