Calling LinX with virtual accounts in the header

LinX services support the use of virtual accounts specified in the request header. This feature allows you to specify one or more bank accounts (IBANs) to be recognized as "virtual" accounts within a batch. This is useful when you have accounts associated with a customer but no files available for them.

Example Scenario

Suppose you need to send two files related to a customer to LinX. The customer also owns a third bank account, but there are no files for this account. By using the virtual accounts header, you can specify the IBAN of this third account. If this IBAN appears in any of the files, LinX will recognize it as belonging to the customer. Transactions between the specified IBANs and those in the files will be marked as internal transactions.

Services Supporting Virtual Accounts

The following services support the use of virtual accounts in the header:

• Convert
• Aggregate
• Consumer Indicator
• Periodical Expenses
• Periodical Income
• Pivot
• Pivot Group
• Profiling

Using the virtual accounts in the header

To use virtual accounts, include a Virtuals key in the request header with a JSON array of IBANs. For example:

Virtuals:
[
	"NL01INGB0123456789",
	"NL01ABNA0123456789"
]