Authorize Transaction
https://api.druo.com/transactions/authorizeAuthorizes 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
An optional custom identifier for this transaction.
The unique identifier of the tenant that originated the transaction.
The origin account details from which the transaction is funded.
The UUID of the account used to fund this transaction.
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.
INDIVIDUALORGANIZATIONThe 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 organization's legal name. Required if type is ORGANIZATION.
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.
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.
INDIVIDUALORGANIZATIONThe 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 organization's legal name. Required if type is ORGANIZATION.
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.
An optional description for this transaction. This description may be visible to end users (e.g., in email receipts).
The transaction statement descriptor reported to financial institutions. Must contain at least one letter and be between 4 and 22 characters.
The transaction amount, specified in the smallest currency denomination (e.g., cents for USD).
The three-letter ISO 4217 currency code.
An optional primary identifier for associating the transaction with your own internal database. Maximum of 40 characters.
An optional secondary identifier for associating the transaction with your own internal database. Maximum of 40 characters.
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.
If true, automatically generates and sends a receipt to the preferred receipt channel.
Response
The transaction's unique identifier.
trx_422f0f81-5001-4cce-a229-242d9ab9960aThe current status of the transaction.
PROCESSINGSUCCESSFULFAILEDCANCELEDREVERSEDSUCCESSFULThe unique identifier of the tenant that initiated the transaction.
ten_0521aadc-5fbd-4b3c-af0a-a4f4b8d6f20aThe origin account details used to fund the transaction.
{"uuid": "acc_7985e8a4-8f38-4eab-8b27-a5d1c6dbf340"}The unique identifier of the origin account.
acc_7985e8a4-8f38-4eab-8b27-a5d1c6dbf340The destination account details receiving the transaction funds.
{"uuid": "acc_7985e8a4-8f38-4eab-8b27-a5d1c6dbf340"}The unique identifier of the destination account.
acc_7985e8a4-8f38-4eab-8b27-a5d1c6dbf340The total transaction amount in the smallest currency denomination.
10000The total fee amount charged for this transaction in the smallest currency denomination.
400The total net amount (total_amount minus total_fee) in the smallest currency denomination.
9600The description of this transaction.
Insurance policy renewal - INV12324The statement descriptor reported to financial institutions.
NOVO BILLING* INV12324An optional secondary internal identifier.
bj39fhow39fhqp3f0hfae4344The key-value metadata pairs attached to the transaction.
{"order_id": "6735"}Indicates whether a receipt was automatically generated and sent.
trueThe GMT timestamp when the transaction was created.
2021-11-15T23:23:38The GMT timestamp when the transaction was last updated.
2021-11-15T23:23:38
