Card Network Reports

Card Network Quarterly Report

The Card Network Quarterly Report endpoint returns all necessary data to complete the quarterly reporting that acquirers must submit to the Card Network for which they are licensed.The Card Network network must be explicitly provided in the endpoint's path. Currently, we support reports for Mastercard and Visa. Next to the network, the acquirerIdCode, year, and quarter parameters must also be provided as a path in the URL. The acquirerIdCode parameter is the ICA in the case of Mastercard and the BIN in the case of Visa.The responses will look different per network since this endpoint has been modeled to return the aggregations as requested per card network. The response will contain a section of transactions that returns a collection of transaction volume aggregations as per card scheme reporting requirements. Under the transaction, there will be a field detail that 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 concerning the previous quarter, as required for the quarterly Card Network reporting.

The endpoint returns the following information:

acquirerId: This parameter represents the code assigned to the acquirer, 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.
transactions: This object encapsulates information related to transactions within the specified card scheme quarterly report. It includes details such as transaction volume, count, and additional information such as the cardEntry, fundingSource, countryCodeCard, and cardBrand.
merchant: The merchant object provides insights into merchants participating in the card scheme and their associated information. This information encompasses the total number of active merchants (acceptors) and provides the change in this count compared to the previous month.
activeMerchantKeys: This parameter, represented as an array of strings, is a key feature of the endpoint. It allows for easy identification and tracking of merchants with transactional activity during the specified reporting period. This feature is particularly useful for acquirers who want to focus on active merchants for analysis or further processing, enhancing the efficiency of their reporting and business operations.