Skip to main content
POST
/
authorize
Authorize payment
curl --request POST \
  --url https://api.pushcash.com/authorize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 1000,
  "currency": "USD",
  "direction": "cash_in",
  "token": "token_3r09eejo3r32rjoj3r23r3",
  "redirect_url": "<string>",
  "webhook_url": "<string>",
  "account_id": "<string>",
  "approval_mode": "automatic"
}'
{
  "id": "intent_production_mbDRHFi3dxIZEtykHsgUGC",
  "amount": 1000,
  "direction": "cash_in",
  "currency": "USD",
  "credential": {
    "display_name": "Chase Checking",
    "last4": "6018"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
amount
integer
required

Amount of the payment in the smallest unit of specified currency.

Example:

1000

​
currency
enum<string>
required

Currency associated with the amount

Available options:
USD
​
token
string
required

The token retrieved from the Push User Widget

Example:

"token_3r09eejo3r32rjoj3r23r3"

​
direction
enum<string>

Direction of the payment.

  • Submit cash_in for deposits or purchases
  • Submit cash_out for withdrawals or redemptions
Available options:
cash_in,
cash_out
​
redirect_url
string

Enable redirects from the authentication flow back to the original application. If omitted, the authentication flow will notify the parent browser via postMessage when the user completes the flow.

​
webhook_url
string

The URL for your webhook endpoint. See Webhooks for details on webhook format.

​
account_id
string

The settlement account for the transaction. This parameter is required if your Push instance is configured with Multiple Settlement Accounts.

​
approval_mode
enum<string>

Enable manual review of payouts or redemptions through this parameter. See Manual Review for details.

Available options:
automatic,
manual

Response

Payment approved

Response for approved payment authorization

​
id
string
required

The payment intent ID

​
amount
integer
required

Amount of the payment in the smallest unit of specified currency

​
direction
enum<string>
required

Direction of the payment.

  • Submit cash_in for deposits or purchases
  • Submit cash_out for withdrawals or redemptions
Available options:
cash_in,
cash_out
​
currency
enum<string>
required

Currency associated with the amount

Available options:
USD
​
credential
object
required

The credentials used for the payment intent

Example:
{
  "display_name": "Chase Checking",
  "last4": "6018"
}
⌘I