Silverflow API Docs - File Subscriptions

The File Subscription functionality provides users with a mechanism to retrieve the raw files sent and received from the card networks from the Silverflow API via an existing Distribution object.

Audience

Product / Engineering
Risk
Finance
Compliance
Merchant support

Purpose

The File Subscription endpoint aims to provide end users with the raw files received from the card scheme via Silverflow. This can include files such as acknowledgement files, reconciliation reporting files and fraud monitoring reports, among others.

Functionality

Create, update, delete and list subscription	Via API
Receive raw files	Pushed to SFTP via Distributions
Data types	Varies per card network
Data sources	Files sourced directly from the card networks

Considerations

Users can have multiple file types linked to a given subscription.
The File Subscription will send the subscribed files to the location specified in the distribution key as soon as Silverflow has received the files from the card networks.
Currently, email and S3 are not supported distribution types for the File Subscription endpoints.
PGP encryption is required for this functionality, as such, the PGP public key is required in the request body.

File Type and Descriptions

File Name	Description
`american-express_grrcn`	The Global Raw Data Reconciliation File (also known as “GRRCN”) contains the core reconciliation data required by most acquirers to assist with their financial reconciliation processes.
`mastercard_ipm`	The Integrated Product Messages (“IPM”) file format is the standard used for processing clearing activity and interchange-related activity through Mastercard's Global Clearing Management System (“GCMS”). It is based on the ISO 8583 standard.
`mastercard_t140`	The T140 file is a bulk file type used by the GCMS to transmit various optional reconciliation and error reports.
`mastercard_tn70`	Similar to the T140, the TN70 is a bulk file type used by GCMS to deliver various optional reconciliation and audit reports to users in a raw data format.
`mastercard_tll8`	The TLL8 file is a file type used in order to transmit fraud and loss database information.
`visa_base2`	The BASE II file system serves as the core mechanism for the electronic exchange of Visa interchange transaction data and the settlement of funds between acquirers and issuers.
`visa_dbraw`	The DB RAW file type serves as a Debit Raw Data file within the BASE II system. DB RAW reports are primarily used to deliver SMS (single message service) detail reports.
`visa_undif`	The UNDIF file format refers to undifferentiated files. These are the "regular daily incoming" files sent by Visa containing data that has not been separated into specific categories through customized delivery services.

Relevant Links

API Reference: Create a Distribution: Documentation for creating a Distribution Object.
API Reference: Create a File Subscription: Documentation for creating a File Subscription.

Step-by-step User Guide

Configure your Distribution Key Call the Create a Distribution Object endpoint to configure where your files should go. Note: The File Subscription endpoints currently only support SFTP distributions, which can be created via the CreateSftpDistributionObject.
Subscribe to File Types Using the distributionKey generated in Step 1, call the Create File Subscription endpoint. You will need to specify the file you want to receive and basic request parameters (e.g., acquirerReferences and publicKey).
Receive Your Files Once successfully configured, Silverflow will automatically encrypt and push the specified files to your designated location as they are received from the card networks.