DRUO
Get started
Acquirer Transactions

Authorize Transaction

POSThttps://api.druo.com/transactions/authorize

Authorizes a transaction request.

Initiates the authorization flow for a payment or transaction. This endpoint requires an Authorization Bearer Token to authenticate the user agent with the server and grant access to protected resources.

Request body

custom_idstringoptional

An optional custom identifier for this transaction.

typestringRequired

The transaction type.

Possible values:PAYMENT
tenant_idstringoptional

The unique identifier of the tenant that originated the transaction.

origin_accountobjectRequired

The origin account details from which the transaction is funded.

origin_account.uuidstringoptional

The UUID of the account used to fund this transaction.

origin_account.tokenstringoptional

The token representing the origin account.

The UUID of the institution where the account is registered. Required if uuid and token are not provided.

The account number. Required if uuid and token are not provided.

The routing number of the financial institution.

The UUID of an existing end user to associate with this transaction. Required if new_end_user_details is not present.

Details for creating a new end user to associate with this transaction.

The type of end user (e.g., individual or company). Required if new_end_user_details is present.

Possible values:INDIVIDUALORGANIZATION

The end user's first name. Required if type is INDIVIDUAL.

The end user's last name. Required if type is INDIVIDUAL.

The organization's name.

The user's local identification number. Required if local_id_country is COL.

The user's local identification type. Required if local_id_country is COL.

The user's identification country code in 3-letter ISO format. Required if country is COL.

The user's email address.

The user's phone number details.

The country code for the phone number.

The phone number without the country code.

destination_accountobjectRequired

The destination account details receiving the transaction funds.

The unique identifier of the destination account.

The token representing the destination account.

The UUID of the institution where the destination account is registered. Required if uuid and token are not provided.

The destination account number. Required if uuid and token are not provided.

The routing number of the destination financial institution.

The UUID of an existing end user to associate with this transaction. Required if new_end_user_details is not present.

Details for creating a new end user to associate with this destination account.

The type of end user (e.g., individual or company). Required if new_end_user_details is present.

Possible values:INDIVIDUALORGANIZATION

The end user's first name. Required if type is INDIVIDUAL.

The end user's last name. Required if type is INDIVIDUAL.

The organization's name.

The user's local identification number. Required if local_id_country is COL.

The user's local identification type. Required if local_id_country is COL.

The user's identification country code in 3-letter ISO format. Required if country is COL.

The user's email address.

The user's phone number details.

The country code for the phone number.

The phone number without the country code.

descriptionstringoptional

An optional description for this transaction. This description may be visible to end users (e.g., in email receipts).

statement_descriptorstringoptional

The transaction statement descriptor reported to financial institutions. Must contain at least one letter and be between 4 and 22 characters.

amountintegerRequired

The transaction amount, specified in the smallest currency denomination (e.g., cents for USD).

currencystringRequired

The three-letter ISO 4217 currency code.

primary_referencestringoptional

An optional primary identifier for associating the transaction with your own internal database. Maximum of 40 characters.

secondary_referencestringoptional

An optional secondary identifier for associating the transaction with your own internal database. Maximum of 40 characters.

metadataobjectoptional

Key-value pairs for attaching custom metadata. Supports up to 50 keys, with key names up to 40 characters and values up to 500 characters.

auto_send_receiptbooleanoptional

If true, automatically generates and sends a receipt to the preferred receipt channel.

Response

uuidstringoptional

The transaction's unique identifier.

Example: trx_422f0f81-5001-4cce-a229-242d9ab9960a
codestringoptional

The transaction's human-readable tracking code.

Example: TXNMW9PCWE
statusstringoptional

The current status of the transaction.

Possible values:PROCESSINGSUCCESSFULFAILEDCANCELEDREVERSED
Example: SUCCESSFUL
typestringoptional

The type of transaction.

Example: PAYMENT
tenant_idstringoptional

The unique identifier of the tenant that initiated the transaction.

Example: ten_0521aadc-5fbd-4b3c-af0a-a4f4b8d6f20a
origin_accountobjectoptional

The origin account details used to fund the transaction.

Example: {"uuid": "acc_7985e8a4-8f38-4eab-8b27-a5d1c6dbf340"}
origin_account.uuidstringoptional

The unique identifier of the origin account.

Example: acc_7985e8a4-8f38-4eab-8b27-a5d1c6dbf340
destination_accountobjectoptional

The destination account details receiving the transaction funds.

Example: {"uuid": "acc_7985e8a4-8f38-4eab-8b27-a5d1c6dbf340"}

The unique identifier of the destination account.

Example: acc_7985e8a4-8f38-4eab-8b27-a5d1c6dbf340
total_amountintegeroptional

The total transaction amount in the smallest currency denomination.

Example: 10000
total_feeintegeroptional

The total fee amount charged for this transaction in the smallest currency denomination.

Example: 400
net_amountintegeroptional

The total net amount (total_amount minus total_fee) in the smallest currency denomination.

Example: 9600
currencyobjectoptional

The currency details.

Example: {"code":"USD"}
currency.codestringoptional

The three-letter ISO 4217 currency code.

Example: USD
descriptionstringoptional

The description of this transaction.

Example: Insurance policy renewal - INV12324
statement_descriptorstringoptional

The statement descriptor reported to financial institutions.

Example: NOVO BILLING* INV12324
primary_referencestringoptional

An optional primary internal identifier.

Example: ABC123
secondary_referencestringoptional

An optional secondary internal identifier.

Example: bj39fhow39fhqp3f0hfae4344
metadataobjectoptional

The key-value metadata pairs attached to the transaction.

Example: {"order_id": "6735"}
auto_send_receiptbooleanoptional

Indicates whether a receipt was automatically generated and sent.

Example: true
date_created_gmtstringoptional

The GMT timestamp when the transaction was created.

Example: 2021-11-15T23:23:38
date_updated_gmtstringoptional

The GMT timestamp when the transaction was last updated.

Example: 2021-11-15T23:23:38
NextPUTValidate Transaction