---
updatedAt: 2025-09-23T20:52:12.000Z
agentTools:
  projectIndex: https://developers.berkeleypayment.com/llms.txt
---

# Card Status Changed Webhook

**data Object (event payload)**

| Field            | Value   | Is Required | Description                                                             |
| :--------------- | :------ | :---------- | :---------------------------------------------------------------------- |
| account          | object  | Yes         | IDs and identifiers associated with the account of an event (see below) |
| timestamp        | Date    | Yes         | Date and time the event is received by Berkeley                         |
| new\_raw\_status | string  | No          | Most recent raw status of a card                                        |
| suspended        | boolean | No          | True if card was suspended. False if card was un-suspended.             |
| cad              | string  | No          | Generated card ID                                                       |

**account Object**

| Field                | Value   | Is Required | Description                                        |
| :------------------- | :------ | :---------- | :------------------------------------------------- |
| id                   | integer | Yes         | ID of cardholder account                           |
| cardholder\_id       | integer | Yes         | ID of cardholder                                   |
| processor\_reference | string  | Yes         | Reference to the account on the processor's system |
| available\_balance   | string  | No          | Balance available on the account                   |

**Possible Status Codes (new\_raw\_status)**

| Code     | Description                           |
| :------- | :------------------------------------ |
| active   | Active                                |
| closed   | Closed                                |
| lost     | Marked As Lost                        |
| stolen   | Marked As Stolen                      |
| shipping | Card is getting prepared for shipping |

**Sample Request**

```
// Card raw status modified to active using modify card status endpoint
{
  "program_id": 2,
  "event": "card_status_changed",
  "event_time": "2021-09-28T10:23:17.560200822-04:00",
  "data": {
    "account": {
      "id": 1,
      "cardholder_id": 1,
      "processor_reference": "129201097356",
      "available_balance": "0.00"
    },
    "timestamp": "2021-09-28T10:23:17Z",
    "new_raw_status": "active"
  }
}
// Card suspended using modify card status endpoint
{
  "program_id": 2,
  "event": "card_status_changed",
  "event_time": "2021-09-28T10:23:17.560200822-04:00",
  "data": {
    "account": {
      "id": 1,
      "cardholder_id": 1,
      "processor_reference": "129201097356",
      "available_balance": "0.00"
    },
    "timestamp": "2021-09-28T10:23:17Z",
    "suspended": true
    "cad":"12345"
  }
}
```

**JSON Schema**

```
{
  "$id": "https://api.pungle.io/schemas/event/card_status_changed",
  "title": "Card Status Changed Event payload",
  "type": "object",
  "properties": {
    "account": {
      "title": "Account Information",
      "type": "object",
      "properties": {
        "id": {
          "description": "ID of cardholder account",
          "type": "number",
          "minimum": 0
        },
        "cardholder_id": {
          "description": "ID of cardholder",
          "type": "number",
          "minimum": 0
        },
        "processor_reference": {
          "description": "Reference to the account on the processor's system",
          "type": "string"
        },
        "available_balance": {
          "description": "Balance available on the account",
          "type": "string"
      }
    },
    "timestamp": {
      "description": "Date and time Berkeley receives the event",
      "type": "string"
    },
    "new_raw_status": {
      "description": "Most recent status of an account",
      "type": "string",
      "enum": [
        "active",
        "closed",
        "lost",
        "stolen"
      ]
    },
    "suspended": {
      "description": "true if card was suspended, false if card was unsuspended",
      "type": "boolean"
    }
  }
}

```