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

# Card Events

> These are the webhook events for card

### Account drain

```json Response theme={null}
{
  "event": "account.drain",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "account:event:drain",
    "event_id": "evt-drain",
    "amount": "29.89",
    "date": "2024-10-24T17:09:15Z"
  }
}
```

### Account inflow

```json Response theme={null}
{
  "event": "account.inflow",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "account:event:inflow",
    "event_id": "evt-inflow",
    "customer_id": "7796fa1a-51dc-4af1-850c-ff80611724c2",
    "amount": "501.9",
    "date": "2024-10-02T17:17:05Z"
  }
}
```

### Account KYC

```json Response theme={null}
{
  "event": "account.kyc",
  "status": "PENDING",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "account:event:kyc",
    "event_id": "evt-account-kyc",
    "customer_id": "3399b5fd-190c-4dd4-709e-08dcf790b612",
    "date": "2024-10-28T20:40:21Z"
  }
}
```

### Authorization is approved

```json Response theme={null}
{
  "event": "debit",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:payment",
    "event_id": "evt-auth",
    "transaction_id": "txn-uuid",
    "amount": 1.76,
    "card_balance_before": 2.27,
    "card_balance_after": 0.51,
    "reason": "PAYPAL *ZSBAINERNTE",
    "date": "2023-05-19 09:55:14"
  }
}
```

### Authorization is declined

```json Response theme={null}
{
  "event": "debit",
  "status": "FAILED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:payment",
    "event_id": "evt-declined",
    "transaction_id": "txn-uuid",
    "amount": 50,
    "reason": "No sufficient funds",
    "date": "2023-05-19 09:24:47"
  }
}
```

### Authorization is reversed

```json Response theme={null}
{
  "event": "credit",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:reversal",
    "event_id": "evt-reversal",
    "transaction_id": "txn-uuid",
    "amount": 1,
    "date": "2023-05-19 09:24:48"
  }
}
```

### Authorization is settled

```json Response theme={null}
{
  "event": "debit",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:payment",
    "event_id": "evt-settled",
    "transaction_id": "txn-uuid",
    "amount": 3.32,
    "date": "2023-05-19 09:49:22"
  }
}
```

### Card blocked

```json Response theme={null}
{
  "event": "card.blocked",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:blocked",
    "event_id": "evt-blocked",
    "reason": "Suspected Fraud",
    "date": "2021-05-17 16:03:12"
  }
}
```

### Card creation

```json Response theme={null}
{
  "event": "card_creation",
  "status": "COMPLETED",
  "environment": "sandbox",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:created",
    "wallet_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "date": "2022-04-29T03:25:10.824806+01:00",
    "reason": "Card created successfully"
  }
}
```

### Card expiring

```json Response theme={null}
{
  "event": "card.expiring",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:expiring",
    "event_id": "evt-expiring",
    "date": "2024-07-10 22:49:06"
  }
}
```

### Card issued

```json Response theme={null}
{
  "event": "credit",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "wallet_id": "39996940-69de-40f6-a675-bebdeb2be50d",
    "event_type": "card:event:issued",
    "event_id": "862db610-4f1b-4cc7-6792-08db563a2507",
    "transaction_id": "txn-uuid",
    "transaction_date": "2024-01-20T19:03:44",
    "amount": 100,
    "card_balance_before": 0,
    "card_balance_after": 100,
    "date": "2023-01-20 19:03:44"
  }
}
```

### Card terminated

```json Response theme={null}
{
  "event": "card.terminated",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:terminated",
    "event_id": "evt-terminate",
    "reason": "Card Terminated",
    "amount": 5,
    "date": "2024-02-27T16:18:45Z"
  }
}
```

### Card topup

```json Response theme={null}
{
  "event": "credit",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:topup",
    "event_id": "evt-topup",
    "transaction_id": "txn-uuid",
    "amount": 50,
    "card_balance_before": 60,
    "card_balance_after": 110,
    "reason": "Card Funding of 50",
    "date": "2024-02-27T16:16:33Z"
  }
}
```

### Card verified

```json Response theme={null}
{
  "event": "card.verified",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:verified",
    "event_id": "evt-verify",
    "reason": "Card Account Successfully Verified",
    "date": null
  }
}
```

### Card withdrawal

```json Response theme={null}
{
  "event": "debit",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:withdrawal",
    "event_id": "evt-withdrawal",
    "transaction_id": "txn-uuid",
    "amount": 5,
    "card_balance_before": 60,
    "card_balance_after": 55,
    "reason": "Card withdrawal",
    "date": "2024-02-27T16:18:45Z"
  }
}
```

### Contactless activation

```json Response theme={null}
{
  "event": "card.contactless_activation",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:contactless_activation",
    "event_id": "evt-activation",
    "customer_id": "7ed0ed28-506a-4131-357a-08de5c4cbf4c",
    "activation_code": "328893",
    "date": "2026-03-16T14:08:17Z"
  }
}
```

### Fee

```json Response theme={null}
{
  "event": "debit",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:fee",
    "event_id": "evt-fee",
    "transaction_id": "txn-uuid",
    "amount": 3.12,
    "reason": "Cross border charge for purchase @ SPIRIT AIR VISA",
    "date": "2023-11-01T12:09:03Z"
  }
}
```

### KYC approved

```json Response theme={null}
{
  "event": "kyc.approved",
  "status": "APPROVED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:kyc",
    "event_id": "evt-kyc",
    "customer_id": "9d9ed3dd-2af6-4ab4-7dd9-08deecb73c54",
    "date": "2026-07-30T15:32:14Z"
  }
}
```

### Refund

```json Response theme={null}
{
  "event": "credit",
  "status": "COMPLETED",
  "environment": "live",
  "data": {
    "card_id": "acf8dab4-a6a9-4f47-b493-0b73e4936883",
    "event_type": "card:event:reversal",
    "event_id": "evt-refund",
    "transaction_id": "txn-uuid",
    "amount": 25.89,
    "reason": "Refund of 25.89 from TEMU.COM on Terminated Card",
    "date": "2024-12-11 16:54:40"
  }
}
```


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