INTEGRATION
CHARGES
DISPUTES & FRAUD
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:
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.
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 thecardBrand
.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.
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.