> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laikipay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Catalog

> Supported webhook event types and payload schemas

# 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

```json theme={null}
{
  "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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.