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

Report Creation: https://docs.finapi.io/?product=di#post-/cases/-caseId-/report/crosscountry
Report Result: https://docs.finapi.io/?product=di#get-/cases/-caseId-/reports/crosscountry/-reportId-

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