Demographic reports contain a subset of the fields available in event reports. Like event reports, rows are identified by an EDR ID and each row contains the following fields:
Running a demographics report
An demographics report request is a formatted HTTPS GET request. The format is defined as follows:
GET /reporting/version/<version>/mso/<msoid>/merchant?timeOfRecord=<time>
Where:
- <version>is the Reporting API version number (the version is '1').
- <msoid> is the MSO ID.
- <time> indicates the point in time of the merchant’s configuration that you want shown in the report.
To make sure all related events that are part of the same event record have been collected and will appear in the report, you must not set a time that is later than two minutes before the present time.
Setting and formatting the time zone
There are two optional parameters you can specify for event reports:
- csv.timeZone=<+ or ->HH:MM
If specified, the time of records is output in the indicated time zone and without a time zone indicator. For example, if you set 'csv.timeZone=+10:00', times of events appear in the report as UTC+10 hours.
If omitted, the output is UTC with a 'Z' appended to indicate UTC time zone.
- csv.timeFormat=<iso8601 or iso8601-T>
If specified as iso8601-T, the output uses a space instead of a T as the date-time separator.
If omitted, or specified as iso8601, the date-time separator is 'T'.
Processing an demographics report
Use the information in the demographics report, broken down by type and source, for your own gateway usage analysis or billing requirements.
Using Hosted Payment Form as an example:
- If a merchant uses Hosted Payment Form to perform an authorization, you could decide not to charge this instance of payment form usage, but instead bundle the cost into the authorization charge.
- However, if the payer used Hosted Payment Form for a token inquiry, you could charge the payment form usage.
- Contact Mastercard Gateway for complete details on the contents and format of Web Services reports and how they could be used for your analysis and billing requirements.