Bank Account ARS

Introduction

ARS Bank Account is used as the destination bank account when you transact with ARS fiat. In order to receive money into your ARS bank account, you need to register it here first and then reference it in tickets that involve ARS transactions.

info

All the endpoints here are applicable to subAccounts, just pass the subAccountId field followed by the subaccount id as the request parameter.

Register an ARS Beneficiary Account

Let's take a look at the data needed to create your ARS bank account:

HTTP POST Request

Endpoint:

https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/ars/

cURL Example:

curl -X POST "https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/ars/" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{
  "alias": "Mi Cuenta Principal",
  "description": "Cuenta bancaria principal en Argentina",
  "cvu": "0000003100002800000000"
}'

Request Fields

Field	Type	Required	Validation Rules	Description
alias	string	Yes	Max 255 characters; must be unique per user	A custom name for the account to help identify it.
description	string	Yes	Max 500 characters	A brief description of the bank account.
cvu	string	Yes	20-22 numeric digits	The CVU (Código Virtual Único) for the ARS account.

Sample JSON Body

{
  "alias": "Mi Cuenta Principal",
  "description": "Cuenta bancaria principal en Argentina",
  "cvu": "0000003100002800000000"
}

JSON Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "accountData": {
    "cvu": "0000003100002800000000",
    "accountHolders": []
  }
}

Response Fields Explained

Field	Type	Description
id	string (UUID)	Unique identifier for this beneficiary account - SAVE THIS for future operations
accountData	object	Contains CVU and account holder information
accountData.cvu	string	The CVU you provided (echoed back)
accountData.accountHolders	array	Empty array on creation; populated when account is used in transactions

List all ARS beneficiaries bank accounts

To get all the ARS bank accounts, let's use the endpoint below, with filter fields:

info

All the endpoints here are applicable to subAccounts, just pass the subAccountId field followed by the subaccount id as the request parameter.

HTTP GET Request

https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/ars/

Filter Fields

Field	Type	Description
subAccountId	string	The ID of a sub-account. If provided, data will be fetched for the sub-account; leave empty for main account.
createdAfter	int64	Filters results to include only those created after this timestamp.
createdBefore	int64	Filters results to include only those created before this timestamp.
cursor	string	Cursor for pagination. Pass the value from the previous response to retrieve the next set of results.
alias	string	Filters results to include only those with the specified alias.

cUrl Example:

curl -X GET "https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/ars/?subAccountId=&createdAfter=1700000000&createdBefore=1800000000&cursor=NEXT_CURSOR&alias=Mi Cuenta Principal" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

JSON Response

{
  "bankAccounts": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "userId": "11111111-1111-1111-1111-111111111111",
      "alias": "Mi Cuenta Principal",
      "description": "Cuenta bancaria principal en Argentina",
      "cvu": "0000003100002800000000",
      "accountHolders": [
        {
          "cuit": "27123456789",
          "name": "Juan Pérez"
        }
      ],
      "createdAt": "2025-02-20T15:13:08.320462Z"
    }
  ],
  "cursor": "MzItMTc0MDA2NDM4ODMyMA..."
}

Response Fields Explained

Field	Type	Description
bankAccounts	array	Array of ARS beneficiary accounts for this user
bankAccounts[].id	string (UUID)	Unique account identifier
bankAccounts[].userId	string (UUID)	Your user ID (account owner)
bankAccounts[].alias	string	The friendly name you assigned
bankAccounts[].description	string	The description you provided
bankAccounts[].cvu	string	The CVU (Código Virtual Único)
bankAccounts[].accountHolders	array	Account holders from transactions (CUIT and name)
bankAccounts[].createdAt	timestamp	ISO 8601 creation date
cursor	string	Pagination cursor for next page (only if more results exist)

Pagination

• If cursor is present in the response, there are more results available
• Pass this cursor value in the next request as a query parameter to fetch the next batch
• No cursor in response means you've reached the last page

Get ARS beneficiary bank account by ID

To retrieve the details of a specific ARS bank account:

info

All the endpoints here are applicable to subAccounts, just pass the subAccountId field followed by the subaccount id as the request parameter.

HTTP GET Request

https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/ars/00000000-0000-0000-0000-000000000000

cUrl Example

curl -X GET "https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/ars/00000000-0000-0000-0000-000000000000" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

JSON Response

{
  "bankAccount": {
    "id": "00000000-0000-0000-0000-000000000000",
    "userId": "11111111-1111-1111-1111-111111111111",
    "alias": "Mi Cuenta Principal",
    "description": "Cuenta bancaria principal en Argentina",
    "cvu": "0000003100002800000000",
    "accountHolders": [
      {
        "cuit": "27123456789",
        "name": "Juan Pérez"
      }
    ],
    "createdAt": "2025-02-20T15:13:08.320462Z"
  }
}

Response Fields Explained

Field	Type	Description
bankAccount	object	Wrapper object containing the account details
bankAccount.id	string (UUID)	Unique account identifier
bankAccount.userId	string (UUID)	Your user ID (account owner)
bankAccount.alias	string	The friendly name you assigned
bankAccount.description	string	The description you provided
bankAccount.cvu	string	The CVU (Código Virtual Único)
bankAccount.accountHolders	array	Account holders discovered through transactions (CUIT and name)
bankAccount.createdAt	timestamp	ISO 8601 creation date

Delete ARS beneficiary bank Account

To delete a specific ARS bank account:

info

All the endpoints here are applicable to subAccounts, just pass the subAccountId field followed by the subaccount id as the request parameter.

HTTP DELETE Request

https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/ars/00000000-0000-0000-0000-000000000000

cUrl Example

curl -X DELETE "https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/ars/00000000-0000-0000-0000-000000000000" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

JSON Response

{}

Status Code: HTTP 200 OK

Response: Empty JSON object - indicates successful deletion

Your ARS bank account has been deleted!

Conclusion

In this section, you have learned how to manage ARS bank accounts within the Avenia API system.

What we've covered:

• ✅ Creating an ARS Bank Account – Register a new ARS bank account for transfers.
• ✅ Fetching All ARS Bank Accounts – Retrieve all your ARS bank accounts.
• ✅ Fetching a Specific ARS Bank Account by ID – Retrieve details by UUID.
• ✅ Deleting an ARS Bank Account – Permanently remove an ARS bank account.

By following these steps, you now have full control over your ARS bank accounts within Avenia API. You can now use the returned beneficiaryArsBankAccountId when creating tickets that involve ARS transactions.