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
currency	string	Currency code (USD)
type	string	Payment type (secure_debit, card_only_credit, or card_only_debit)

intent.approved

{
 "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"
}