Webhook Event Types

Below is the list of events dispatched by Laiki Pay:

Event Name	Description
`card.transaction.completed`	Debit transaction settled at global merchant checkout
`card.transaction.declined`	Transaction declined due to balance, limit, or merchant rules
`card.created.success`	Virtual card successfully provisioned
`card.funded.success`	Card balance deposited from merchant vault
`card.withdrawn.success`	Unspent funds swept from card back to vault
`card.status.updated`	Card frozen or unfrozen
`card.spend_limits.updated`	Daily or monthly spend caps changed
`card.terminated`	Card permanently closed and unspent balance refunded

Sample Payload: Transaction Completed

{
  "event": "card.transaction.completed",
  "timestamp": 1728604800,
  "data": {
    "cardId": "crd_8f921ab0c1",
    "maskedPan": "411111******1111",
    "amount": 25.00,
    "currency": "USD",
    "reference": "TX_DEBIT_918239",
    "merchantName": "Amazon Web Services",
    "status": "SETTLED"
  }
}

Sample Payload: Card Funded

{
  "event": "card.funded.success",
  "timestamp": 1728604900,
  "data": {
    "cardId": "crd_8f921ab0c1",
    "amount": 100.00,
    "currency": "USD",
    "newBalance": 125.00,
    "reference": "FUND_RECHARGE_0192"
  }
}