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

# Webhook Types

This reference defines the different webhook types that can be received from Push Cash.

## `intent.approved`

Triggered when an intent is successfully approved.

| Field                                 | Type    | Description                                                             |
| :------------------------------------ | :------ | :---------------------------------------------------------------------- |
| `id`                                  | string  | Unique identifier for the intent                                        |
| `tag`                                 | string  | Your internal transaction identifier (if provided)                      |
| `direction`                           | string  | Either cash\_in or cash\_out                                            |
| `amount`                              | integer | Amount in cents (e.g. 5000 = \$50.00)                                   |
| `status`                              | string  | Intent status (`approved` or `pending`)                                 |
| `rail`                                | string  | Payment rail used (`ach` or `card`)                                     |
| `currency`                            | string  | Currency code (USD)                                                     |
| `type`                                | string  | Payment type (`secure_debit`, `card_only_credit`, or `card_only_debit`) |
| `limits_utilization`                  | object  | Object containing limit utilization details                             |
| `limits_utilization.daily_cash_in`    | string  | Daily cash-in limit usage                                               |
| `limits_utilization.daily_cash_out`   | string  | Daily cash-out limit usage                                              |
| `limits_utilization.monthly_cash_in`  | string  | Monthly cash-in limit usage                                             |
| `limits_utilization.monthly_cash_out` | string  | Monthly cash-out limit usage                                            |

## `intent.declined`

Triggered when an intent is declined.

| Field              | Type    | Description                                                                                                                              |
| :----------------- | :------ | :--------------------------------------------------------------------------------------------------------------------------------------- |
| `id`               | string  | Unique identifier for the intent                                                                                                         |
| `tag`              | string  | Your internal transaction identifier (if provided)                                                                                       |
| `direction`        | string  | Either `cash_in` or `cash_out`                                                                                                           |
| `amount`           | integer | Amount in cents (e.g. 5000 = \$50.00)                                                                                                    |
| `status`           | string  | Intent status (`declined`)                                                                                                               |
| `decline_category` | string  | Reason for decline – see the [full list of decline categories](./apireference/authorization/authorize-payment#response-decline-category) |
| `currency`         | string  | Currency code (USD)                                                                                                                      |
| `type`             | string  | Payment type (`secure_debit`, `card_only_credit`, or `card_only_debit`)                                                                  |

<ResponseExample>
  ```json intent.approved theme={null}
  {
   "type": "intent.approved",
   "data": {
     "id": "intent_sandbox_mbDRHFi3dxIZEtykHsgUGC",
     "tag": "txn_12345",
     "direction": "cash_in",
     "amount": 5000,
     "status": "approved",
     "rail": "ach",
     "currency": "USD",
     "type": "secure_debit",
     "limits_utilization": {
       "daily_cash_in": "5000.00",
       "daily_cash_out": "0.00",
       "monthly_cash_in": "5000.00",
       "monthly_cash_out": "0.00"
     }
   },
   "timestamp": "2024-01-14T22:31:02.756096Z"
  }
  ```

  ```json intent.declined theme={null}
  {
   "type": "intent.declined",
   "data": {
     "id": "intent_sandbox_mbDRHFi3dxIZEtykHsgUGC",
     "tag": "txn_12345",
     "direction": "cash_in",
     "amount": 5000,
     "status": "declined",
     "decline_category": "insufficient_funds",
     "currency": "USD",
     "type": "card_only_debit"
   },
   "timestamp": "2024-01-14T22:31:02.756096Z"
  }
  ```
</ResponseExample>