DRUO
Get started
Accounts

Connect Account

POSThttps://api.druo.com/accounts/connect

Submit an account connection request using merchant-provided data to bypass the Connect Link flow.

This endpoint directly creates a Connected Account object. It is designed for merchants who gather account details through their own interface and want to bypass the standard DRUO hosted connection flow.

Request body

user_authorizationstringRequired

Confirmation that the end user has authorized their account to be connected with the DRUO system. Must be TRUE to process the connection.

Possible values:TRUEFALSE
institution_uuidstringRequired

The UUID of the institution where the connected account is registered.

typestringRequired

The type of account. Determines whether the account holds value.

subtypestringRequired

The subtype of the account, providing further detail about the type of account.

account_numberintegerRequired

The account's number.

new_end_user_detailsEndUserRequired

The user information object. This field is required only if existing_end_user_id is empty.

merchant_idstringoptional

The unique identifier of the merchant.

existing_end_user_idstringoptional

The unique identifier of the existing end user.

routing_numberintegeroptional

The account's routing number, which typically indicates where the account was opened.

primary_referencestringoptional

The primary reference of the account. Can be any value to associate the connected account with an entity in an external system.

secondary_referencestringoptional

The secondary reference of the account. Can be any value to associate the connected account with an entity in an external system.

metadatastringoptional

A set of key-value pairs that you can attach to an object. You can specify up to 50 keys, with key names up to 40 characters long and values up to 500 characters long.

alias_network_idstringoptional

A valid code within the alias networks table.

primary_identifierstringoptional

The primary identifier payload, such as a payment key or IBAN.

If true, the user will be taken directly to the redirect URL without showing the DRUO redirect page.

redirect_urlstringoptional

The URL to redirect to after the connection flow is completed. The parameters 'ac' (account code), 'al4' (last 4 digits), 'ain' (institution name), 'as' (status), 'aid' (account UUID), and 'clid' (link UUID) will be appended as URL query parameters.

Response

uuidstringoptional

The unique identifier of the connected account.

Example: acc_747536f4-1efd-4cad-91b3-cc8aaeed93e3
codestringoptional

The code or record locator for the connected account.

Example: ACSCDSVFGH
current_statusstringoptional

The current status of this connected account.

Example: CONNECTED

If true, the account requires validation via the Validate Account endpoint using the slug provided in pending_account_validations.

Example: true

A list of pending account validations required to complete the account connection.

remarksstringoptional

The connection status remarks for this connected account.

Example: ACCOUNT_DOES_NOT_EXIST
institutionobjectoptional

An object containing the UUID and name of the institution where the connected account is registered.

Example: {"uuid":"ins_ff6c5094-1cd1-11ec-9621-0242ac130002","name":"Banco"}
last_4stringoptional

The last four digits of the actual account number.

Example: 4524
typestringoptional

The type of account. Determines whether the account holds value.

Example: DEPOSITORY
subtypestringoptional

The subtype of the account, providing further detail about its type.

Example: SAVINGS
capabilitiesstringoptional

The capabilities enabled for this account.

Example: PAYMENTS, BALANCE, IDENTITY, AUTHENTICATION, TRANSFERS
end_userEndUseroptional

The full End User object related to this account.

disconnection_reasonstringoptional

The reason why the account was disconnected.

Example: ACTIVITY_COMPLETED
disconnection_notestringoptional

Additional notes explaining the account's disconnection.

primary_referencestringoptional

The primary reference of the account, used to associate it with an entity in an external system.

Example: 23423524
secondary_referencestringoptional

The secondary reference of the account, used to associate it with an entity in an external system.

Example: bj39fhow39fhqp3f0hfae4344
metadatastringoptional

A set of key-value pairs attached to the account object.

Example: {"order_id": "6735"}
creation_sourcestringoptional

The source that initiated the creation of the account.

Example: MERCHANT_API
date_created_gmtstringoptional

The date and time the account was created in GMT format.

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

The date and time the account was last updated in GMT format.

Example: 2021-11-15T23:23:38Z
NextPOSTValidate Account