Skip to main content
This reference defines the different webhook types that can be received from Push Cash.

​
intent.approved

Triggered when an intent is successfully approved.
FieldTypeDescription
idstringUnique identifier for the intent
tagstringYour internal transaction identifier (if provided)
directionstringEither cash_in or cash_out
amountintegerAmount in cents (e.g., 5000 = $50.00)
statusstringIntent status (approved)
railstringPayment rail used (ach or card)
currencystringCurrency code (USD)
typestringPayment type (push or card_only)
limits_utilizationobjectObject containing limit utilization details
limits_utilization.daily_cash_instringDaily cash-in limit usage
limits_utilization.daily_cash_outstringDaily cash-out limit usage
limits_utilization.monthly_cash_instringMonthly cash-in limit usage
limits_utilization.monthly_cash_outstringMonthly cash-out limit usage
Example Webhook Payload: 
{
 "type": "intent.approved",
 "data": {
   "id": "intent_sandbox_mbDRHFi3dxIZEtykHsgUGC",
   "tag": "txn_12345",
   "direction": "cash_in",
   "amount": 5000, // Amount in cents (e.g., 5000 = $50.00)
   "status": "approved",
   "rail": "ach",
   "currency": "USD",
   "type": "push",
   "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"
}

​
intent.declined

Triggered when an intent is declined.
FieldTypeDescription
idstringUnique identifier for the intent
tagstringYour internal transaction identifier (if provided)
directionstringEither cash_in or cash_out
amountintegerAmount in cents (e.g., 5000 = $50.00)
statusstringIntent status (declined)
decline_categorystringReason for decline (e.g., insufficient_funds, fraud_risk)
currencystringCurrency code (USD)
typestringPayment type (push or card_only)
Example Webhook Payload: 
{
 "type": "intent.declined",
 "data": {
   "id": "intent_sandbox_mbDRHFi3dxIZEtykHsgUGC",
   "tag": "txn_12345",
   "direction": "cash_out",
   "amount": 5000, // Amount in cents (e.g., 5000 = $50.00)
   "status": "declined",
   "decline_category": "insufficient_funds",
   "currency": "USD",
   "type": "card_only"
 },
 "timestamp": "2024-01-14T22:31:02.756096Z"
}
⌘I