Skip to main content

​
Goal

Enable your team to manually review, approve, or cancel withdrawal payments before they are posted to the payment network.

​
Steps

​
Step 1: Disable automatic posting of withdrawals

​
What you need to do

Configure withdrawal authorizations so approved payments are held for review instead of being automatically posted to the network.
Automatic posting can only be disabled for cash_out payments.

​
How to do it

  • Set approval_mode to manual when authorizing a withdrawal payment.
When a payment is approved with approval_mode: manual, the intent enters a pending state and is not posted to the network. If you have enabled webhooks, you will receive an intent.approved webhook with the intent in a pending state to your webhook url.

​
Step 2: Review pending payments

​
What you need to do

Retrieve details about pending withdrawal intents so your team can review the payment before releasing funds.

​
How to do it

  • Make a request to get an intent and inspect the payment details.

​
Step 3: Approve or cancel the payment

​
What you need to do

Approve or cancel the withdrawal after completing your review.

​
How to do it

It is recommended that you always cancel or approve manual withdrawal payments so that payments enter into a terminal status and are not left in “pending” for an indefinite period.
curl --request POST \
  --url https://sandbox.pushcash.com/authorize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "user_lVpbPL0K1XIiHx0DxipRbD",
  "amount": 1000,
  "currency": "USD",
  "direction": "cash_out",
  "approval_mode": "manual",
  "token": "token_mbDRHFi3dxIZEtykHsgUGC"
}
'

{
  "id": "intent_5Jun2aRUEs7xGddsARCowB",
  "status": "pending",
  "direction": "cash_out",
  "amount": 1000,
  "currency": "USD",
  "created_at": "2026-01-05T22:31:02Z"
}

​
Integration checklist

  • Set approval_mode to manual for withdrawal authorizations
  • Implement approve and cancel actions for reviewed payments