Bank Account EUR

Introduction

EUR Bank Account is used as the destination bank account when you off-ramp to EUR fiat through SEPA transfers. In order to receive money into your EUR bank account, you need to register it here first and then reference it in tickets that send EUR out to a bank.

warning

SWIFT transfers are NOT supported. If you send funds via SWIFT instead of SEPA, we will not have visibility of the payment and will not be able to process or track it. Please ensure all EUR transfers use SEPA network only.

info

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

Register a EUR Beneficiary Account

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

HTTP POST Request

Endpoint:

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

cURL Example:

curl -X POST "https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/eur/" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{
  "alias": "Payroll Account",
  "description": "Main EUR beneficiary account",
  "iban": "FR186323717830259KW1JGZSE48",
  "bic": "COBADEFFXXX",
  "country": "FRA",
  "bankBeneficiaryName": "ACME Corp dGmbH"
}'

Fields

Field	Type	Description
alias	string	A custom name for the account to help identify it.
description	string	A brief description of the bank account.
iban	string	The International Bank Account Number (IBAN).
bic	string	The Bank Identifier Code (BIC) for SEPA transfers only. (OPTIONAL PARAMETER)
country	string	The country code (e.g., "FRA", "DEU", "ITA").
bankBeneficiaryName	string	The full name of the account holder.

Sample JSON Body

{
  "alias": "Payroll Account",
  "description": "Main EUR beneficiary account",
  "iban": "FR186323717830259KW1JGZSE48",
  "bic": "COBADEFFXXX",
  "country": "FRA",
  "bankBeneficiaryName": "ACME Corp dGmbH"
}

JSON Response

{
  "id": "00000000-0000-0000-0000-000000000000"
}

List all EUR beneficiaries bank accounts

To get all the EUR 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/eur/

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/eur/?subAccountId=&createdAfter=1700000000&createdBefore=1800000000&cursor=NEXT_CURSOR&alias=Payroll Account" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

JSON Response

{
  "bankAccounts": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "userId": "11111111-1111-1111-1111-111111111111",
      "alias": "Payroll Account",
      "description": "Main EUR beneficiary account",
      "iban": "FR186323717830259KW1JGZSE48",
      "bic": "COBADEFFXXX",
      "country": "FRA",
      "bankBeneficiaryName": "ACME Corp dGmbH",
      "createdAt": "2025-02-20T15:13:08.320462Z"
    }
  ],
  "cursor": "MzItMTc0MDA2NDM4ODMyMA..."
}

Get EUR beneficiary bank account by ID

To retrieve the details of a specific EUR 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/eur/00000000-0000-0000-0000-000000000000

cUrl Example

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

JSON Response

{
  "bankAccount": {
    "id": "00000000-0000-0000-0000-000000000000",
    "userId": "11111111-1111-1111-1111-111111111111",
    "alias": "Payroll Account",
    "description": "Main EUR beneficiary account",
    "iban": "FR186323717830259KW1JGZSE48",
    "bic": "COBADEFFXXX",
    "country": "FRA",
    "bankBeneficiaryName": "ACME Corp dGmbH",
    "createdAt": "2025-02-20T15:13:08.320462Z"
  }
}

Delete EUR beneficiary bank Account

To delete a specific EUR 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/eur/00000000-0000-0000-0000-000000000000

cUrl Example

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

Your EUR bank account has been deleted!

Conclusion

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

warning

Important: Always use SEPA transfers for EUR transactions. SWIFT transfers are not supported and will not be visible or processed by our system. Ensure your bank supports SEPA transfers before registering EUR beneficiaries.

What we've covered:

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

By following these steps, you now have full control over your EUR bank accounts within Avenia API. You can now use the returned beneficiaryEurBankAccountId when creating output tickets that off-ramp EUR to a bank via SEPA network.