INTEGRATION

Getting Started

REPORTS

Card Network Reports

INTEGRATION

Card Network Reports

Card Network Quarterly Report

​The Card Network Quarterly Report endpoint returns all necessary data to complete the quarterly reporting which acquirers need to submit to the Card Network for which they are licensed.​The Card Network network needs to be explicitly provided in the path of the endpoint. Currently we support reports for Mastercard and Visa. Next to the network the acquirerIdCode, year and quarter parameter also need to be provided as a path in the URL. The acquirerIdCode parameter is the ICA in case of Mastercard and the BIN in case of Visa.​The responses will look different per network since this endpoint has been modelled to return the aggregations as requested per card scheme. The response will contain a section transactions which returns a collection of transaction volume aggregations as per card scheme reporting requirements. Under the transaction there will be a field detail which describes all the properties that collectively form the aggregation and those fields are determined and regulated by each network. Additionally, the endpoint will return a merchant section which returns the total merchants and merchant acceptors including the delta with respect to the previous quarter as required for the quarterly Card Network reporting.​

The endpoint returns the following information:

  1. acquirerId: This parameter represents the code assigned to the acquirer, which is typically an ICA, BIN or BID. The acquirerId serves as a unique identifier, ensuring that the correct acquirer is associated with the transactions and merchants in the report.

  2. transactions: This object encapsulates information related to transactions within the specified card scheme quarterly report. It include details such as transaction volume, transaction count but also additional information such as the cardEntry, fundingSource, countryCodeCard and the cardBrand.

  3. merchant: The merchant object provides insights into merchants participating in the card scheme and their associated information. This information encompasses the total amount of active merchants (acceptors) and provides the change in this count in comparison with previous month.

  4. activeMerchantKeys: This parameter is an array containing strings representing active merchant keys. The inclusion of activeMerchantKeys allows for easy identification and tracking of merchants with transactional activity during the specified reporting period. It enables users to focus specifically on active merchants for analysis or further processing.