Skip to main content
Skip table of contents

Introduction to Cross-Country Transfers

Get an overview of your customer's international financial connections.

This report is appropriate for B2B and B2C use cases.

What it solves

In order to be able to assess a client well, it is important to know what international connections he has. This is especially important from the point of view of risk management, compliance, security, and fraud detection. In this way, unusually high transaction volumes can be detected and analysed.
The customer's behaviour can also be analysed through the cross-country report, for example, which countries are particularly important for him, which markets are growing, and which are less important.

Cross-Country Transfers Report

The Cross-Country Transfer gives an overview of data such as the number of relevant transactions. In which countries are the financial connections? How frequent and how high are the international money transfers?

Other data includes the account information and the transactions used in the report. This is very helpful if you want to check the values, for example, as part of a detailed credit check.

Aggregations

A Cross-Country Aggregation can be generated with the following query:

JSON
{
  "aggregations": [
    {
      "alias": "Cross-Country",
      "includeLabelGroup": [
        "CROSS_COUNTRY_TRANSFER"
      ]
    }
  ]
}

Used data fields

All transactions of the customer are used for this purpose. This includes data like IBAN, counterpart name, purpose, amount, and so on.

The report response itself is divided into the following sections.

Main Section

A full API schema can be seen here

The main part of the report can also be found in the “Get all Reports” endpoint at $.reports.crossCountry.

Field

Description

Mandatory

creationDate

Timestamp of when the report was created, in the format 'YYYY-MM-DD HH:MM:SS.SSS' (CET Europe / Berlin).

yes

caseId

ID of the case in which the report was created.

yes

startDate

Date of the start date of the reporting period under review in the format 'YYYY-MM-DD' (CET Europe / Berlin).

yes

endDate

Date of the end date of the reporting period under review in the format 'YYYY-MM-DD' (CET Europe / Berlin).

yes

daysOfReport

The number of full days, that the reporting period under review contains.

yes

transactionsStartDate

Date when user's first transaction took place in the report period under review in the format 'YYYY-MM-DD' (CET Europe / Berlin). This field takes into consideration all the transactions of the user, irrespectively of the assigned to them label.

no

totalTransactionsCount

The number of the user transactions, that took place in the report period under review. This field takes into consideration all the transactions of the user, irrespectively of the assigned to them label.

yes

totalTransactionsSum

The sum of the amount of user's transactions, that took place in the report period under review. This field takes into consideration all the transactions of the user, irrespectively of the assigned to them label.

yes

totalTransactionsAvg

The average of the amount of user's transactions, that took place in the report period under review. This field takes into consideration all the transactions of the user, irrespectively of the assigned to them label.

yes

crossCountryTransfers

The data of the cross country transfer are unique in the combination of originationCountry and destinationCountry. Inside those objects, we find a total sum and average of all transactions between those 2 countries over the report period and a monthly view.

no

completeMonths

List of complete (full) calendar months inside the report period under review in the format 'YYYY-MM'. The complete months list is based on transactions within the reporting time frame. The month with the first transaction determines the first month in this list.

no

Cross Country Transfers Section

Field

Description

Mandatory

originationCountry

Object containing the two-character ISO code and the name of the originator country of the transaction.

yes

destinationCountry

Object containing the two-character ISO code and the name of the destination country of the transaction.

yes

frequency

If possible, the frequency of payments between both countries of the customer is displayed here.

no

totalTransactionsCount

The number of user's transactions between these countries by the period.

yes

totalTransactionsSum

The sum of the amount of the user's transactions between these countries by the period.

yes

totalTransactionsAvg

The average amount of the user's transactions between these countries by the period.

yes

monthlyTransfers

Presents a monthly split summary of the transactions between both countries as a list. For each entry, the month and the year are listed, as well as the total amount and the number of transactions.

If showOnlyCompleteMonths=false, the list of months is calculated between transactionsStartDate of the report and endDate of the report, hence both complete and incomplete months are included.

If showOnlyCompleteMonths=true, only the list of complete months between transactionsStartDate of the report and endDate of the report, is included.

All accounts are taken into consideration for the monthly objects.

yes

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.