Returns a monthly CSV report with card brand fees, interchange, plan fees, and raw billing event transaction (BET) rows for each merchant, enabling full-month audit and billing verification.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
MASM1001 Monthly MAS Summary Export
The MASM1001 file is the Merchant Accounting System (MAS) monthly summary report. It extends the daily MASD1001 structure with two additional row types — Interchange (BETs) and Individual Plan (BETs) — which carry the raw transaction counts and volumes used as the billing basis for interchange and plan fee calculations. This makes MASM1001 the complete audit-level report for monthly reconciliation and billing verification.
Endpoint
GET /download/YYYYMMDD/MASM1001
Authentication
Basic HTTP Authentication required.
Encode username:password in Base64 and pass in the Authorization header:
Authorization: Basic {base64(username:password)}When to use
Use this file at month-end to reconcile all processing fees against the merchant statement, verify that the billing engine applied the correct transaction volumes, and confirm net processor margin for the full reporting period. The BET rows allow you to cross-check that the volumes used in fee calculations match the raw transaction counts from the Transactions file.
Query Parameters
None. The file is identified by the date path segment (YYYYMMDD) and delivered via SFTP.
Response
200 OK — Returns CSV content (with header row) with the following columns:
| Column | Type | Description |
|---|---|---|
MID | string | Merchant identifier |
Association | string | Internal association or bank group code |
Group | string | Processing group code |
Category | string | Fee category: Card Brand Fees, Interchange, Interchange (BETs), Individual Plan, Individual Plan (BETs), Discount, Discount (DRT/VRT) |
Fee | string | Specific fee name, interchange program name, or BET label |
Number | integer | Transaction count; populated in BET rows, 0 in standard fee rows |
Amount | decimal | Dollar volume tied to Number; populated in BET rows, 0.00 in standard fee rows |
SalesNumber | integer | Number of sales transactions driving this fee (standard rows only) |
SalesAmount | decimal | Total sales volume in dollars for this fee (standard rows only) |
CreditNumber | integer | Number of credit/refund transactions |
CreditAmount | decimal | Total dollar value of credits/refunds |
Income | decimal | Revenue recognized by the processor (0.00 in BET rows) |
Expense | decimal | Cost incurred by the processor (0.00 in BET rows) |
Total | decimal | Net result: Income − Expense; 0.00 in BET rows; negative = net cost to processor |
Note: MASM1001 does not include the
FeesPaidcolumn that appears in MASD1001.
Fee Category Descriptions:
| Category | Description |
|---|---|
Card Brand Fees | Assessment and network fees charged by card brands |
Interchange | Interchange costs passed through from the issuing bank |
Interchange (BETs) | Raw billing event rows — Income, Expense, and Total are always 0.00; reference only |
Individual Plan | Per-merchant plan fees under negotiated pricing |
Individual Plan (BETs) | Raw billing event rows — Income, Expense, and Total are always 0.00; reference only |
Discount | Discount rate lines per card type |
Discount (DRT/VRT) | Dynamic/variable rate table placeholders; typically zero-value |
MID,Association,Group,Category,Fee,Number,Amount,SalesNumber,SalesAmount,CreditNumber,CreditAmount,Income,Expense,Total
9180000000001234,999001,999000,Card Brand Fees,VS-ASSMNT CRE,0,0.00,11,5474.54,0,0.00,7.66,7.66,0.00
9180000000001234,999001,999000,Card Brand Fees,VS-Assessment,0,0.00,11,5474.54,0,0.00,0.00,0.55,-0.55
9180000000001234,999001,999000,Card Brand Fees,MC-Assessment,0,0.00,2,502.05,0,0.00,0.08,0.13,-0.05
9180000000001234,999001,999000,Interchange,VS Non Qual Cns CR,0,0.00,1,851.32,0,0.00,26.92,26.92,0.00
9180000000001234,999001,999000,Interchange,MC Corp Std,0,0.00,2,502.05,0,0.00,15.01,15.01,0.00
9180000000001234,999001,999000,Interchange (BETs),VS-NONQUALCONCR,1,851.32,0,0.00,0,0.00,0.00,0.00,0.00
9180000000001234,999001,999000,Interchange (BETs),MC-CORP STANDARD,2,502.05,0,0.00,0,0.00,0.00,0.00,0.00
9180000000001234,999001,999000,Individual Plan,VS-Sales Outg,0,0.00,1,851.32,0,0.00,1.28,0.00,0.00
9180000000001234,999001,999000,Individual Plan (BETs),VISA,1,851.32,0,0.00,0,0.00,0.00,0.00,0.00
9180000000001234,999001,999000,Discount,VS,0,0.00,1,851.32,0,0.00,0.00,0.00,0.00
9180000000001234,999001,999000,Discount (DRT/VRT),Discount,0,0.00,0,0.00,0,0.00,0.00,0.00,0.00Error Codes
| Code | When it happens |
|---|---|
| 400 | Malformed date format in URL path |
| 401 | Invalid or missing Basic Auth credentials |
| 403 | User does not have permission for this operation |
| 404 | No MASM1001 file found for the specified date |
| 500 | Internal server error |
Common Mistakes
- Including BET rows in financial totals —
Interchange (BETs)andIndividual Plan (BETs)rows always have0.00forIncome,Expense, andTotaland are reference-only. - Looking for the
FeesPaidcolumn — it does not exist in MASM1001 (only in MASD1001). - Treating
Discount (DRT/VRT)rows with zero values as errors — these are expected zero-value placeholders for variable rate table merchants. - Not cross-referencing BET row
NumberandAmountagainst theSalesNumberandSalesAmountin corresponding standard fee rows — mismatches indicate a billing discrepancy. - Comparing month-to-date MASD1001 daily sums directly to MASM1001 totals without accounting for timing differences in posting.
Related Endpoints
GET /download/YYYYMMDD/MASD1001— daily MAS detail withFeesPaidcolumnGET /download/YYYYMMDD/Transactions— transaction data that drives fee calculationsGET /download/YYYYMMDD/SimplifiedFormat— simplified transaction export for cross-referencing volumes
Example
curl -X GET "https://hq.staging.netevia.dev/download/20260528/MASM1001" \
-H "Authorization: Basic $(echo -n 'username:password' | base64)"