Authorize Bank Transactions

post

https://api.cardda.com/v1/banking/bank_accounts/{bank_account_id}/authorize

Authorize bank transactions of a bank account

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

bank_account_id

string

required

The id of the bank account

Body Params

Requires the selection of the bank key to use.

Requires the authorization method to use, which depends on the bank, with its corresponding token or device_id (for more information on bank devices, please contact us).

The following banks require the selection of transactions to be authorized:

Banco de Chile

Banco Itau

Banco Santander Chile

Cardda Wallet

bank_key_id

string

required

The id of the bank key to be used.

authorization_method

string | null

enum

Second factor to authorize the operation with. Which value is valid depends on the sending
bank — multipass at BCI, santander_pass at Santander, bice_pass at BICE, itau_pass
at Itaú, digipass or device at Banco de Chile, token where the bank issues a numeric
code. Pair device with device_id; every other method pairs with token. In the Mexican
operation the field is not required.

Allowed:

token

string

device_id

string

Device to be used for authorization

transactions_ids

array of strings

transactions_ids

Headers

company-id

uuid

required

UUID of the company on whose behalf the request is made. Send it on banking
requests to identify the acting company. Note that user-scoped list endpoints
(e.g. the recipients/transactions indexes) resolve results across all companies
the authenticated user is a member of, rather than strictly from this header.
See The company-id header for details on how to obtain
a value for this header and the error responses to expect when it is missing or invalid.

Responses

400

The authorization was called with authorization method set to token, but only one transaction was in the queue which is not allowed. There must be 2 or more to use that method

401

Unauthorized

409

The authorization was called while there are some transactions pending to be enqueued

422

The authorization method has a non valid value

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The authorization is being processed, and since that process is async the response is an empty object

402Payment required — the account does not have enough balance to authorize the selected transactions.

404Not found — there are no transactions eligible to authorize for this account.