Sign in

v1

latestOpenAPI 3.0.22026-08-04530309.0 KB
Transactions

Approve or deny a transaction

Approves or denies a pending Transaction. This endpoint is used to explicitly authorize or reject a Transaction before it is executed.

put/transactions/{uid}/authorize

Request body

authorization_status'client_approved' | 'client_denied' required

The current status of the transaction authorization.

denied_memostring

Freeform text (up to 44 characters) that should be attached to the transaction if the transaction is to be denied. Optional.

denied_reason'debit_limit_exceeded' | 'insufficient_funds' | 'international_payment' | 'unauthorized_credit' | 'unauthorized_debit' | 'vrn_archived' | 'vrn_locked'

The reason for the authorization denial. For wire transactions, must be one of (vrn_archived), (vrn_locked), (international_payment), (unauthorized_credit). For ACH transactions, must be one of (vrn_archived), (vrn_locked), (debit_limit_exceeded), (unauthorized_credit), (unauthorized_debit), (insufficient_funds)

Example request

{
  "authorization_status": "client_denied"
}

Response

The authorization resource is returned

Example response

{
  "authorization": {
    "authorization_finalized_at": "2024-10-09T00:12:53.729Z",
    "authorization_required_by": "2024-10-10T00:18:53.729Z",
    "authorization_status": "client_denied",
    "denied_memo": "denied memo",
    "denied_reason": "debit_limit_exceeded"
  }
}