Overview
The TSYS FSP Integration enables merchant boarding and reporting for TSYS FSP portfolios. Follow the steps in this article to configure the integration.
Request Setup from TSYS
- Contact your RM to request boarding and reporting for your portfolio and Merchant Central.
- TSYS will contact Merchant Central with the required credentials and information.
Reporting
The following files should be enabled for delivery to the SFTP. Sample file naming structures are shown below:
| Name | Example File | Use in Merchant |
| ACQ Merchant Detail File | IRISCRMP.1234_MERCH_DTL_MMDDYYYY_HHMMSS.TSYSO | Account Status |
| PPM Pricing Profile Extract File | IRISCRMP.1234_MERCH_PRICING_MMDDYYYY_HHMMSS.TSYSO | Account Status - Pricing |
| TDDF | IRISCRMP.1234_TDDF_MMDDYYYY_HHMMSS.TSYSO | Batches & Transactions |
| Case Action File | IRISCRMP.1234_CASE_ACTION_MMDDYYYY_HHMMSS.TSYSO | Chargebacks & Retrievals |
| ACH Detail File | IRISCRMP.1234_ACH_DETL_MMDDYYYY_HHMMSS.TSYSO | Deposits |
| Authorization Detail File | ADF (Bi-Hourly) Back-End Generated With Card Number Masked | Optional File |
| Dispute Details - Supplemental Images | IRISCRMP.1234_SUP_IMAGE_MMDDYYYY_HHMMSS.zip | Optional File |
| ISO Residual File | IRISCRMP.1234_RESIDUAL_MMDDYYYY_HHMMSS.TSYSO | Residuals* |
| Concatenated PDF Statement File | IRISCRMP.1234_CCAT_STMT_PDF_MMDDYYYY_HHMMSS.TSYSO | Statements |
| Optional Files: | ||
| Batch Maintenance Response | IRISCRMP.1234_RF_BMAINT_11132022_123826.TSYSO | TSYS Reserve Funding |
| Merchant Settings | IRISCRMP.1234_DRF_MER_11112022_230914.TSYSO | TSYS Reserve Funding |
| Reserve Activity | IRISCRMP.1234_DRES_FUND_11112022_225428.TSYSO | TSYS Reserve Funding |
*We only support monthly residual files (_MLY_) and not daily residual files (_DLY_).
☝️ TSYS may use variations in file naming and may send files multiple times per day.
To import information from the SFTP, ensure the following tasks are configured under Manage → Administration → Site Options → Scheduled Tasks.
- TSYS SFTP - Deposits & Batches & Transactions - 8 am every two hours
- TSYS SFTP - Account Information - 8:05 am daily
- TSYS SFTP - Chargebacks & Retrievals - 8:10 am daily
- TSYS SFTP - Statements - 8:30 am monthly on the 2nd, 3rd, and 4th days
- TSYS SFTP - Import Residuals - 8 am daily
- TSYS SFTP - Other Feeds - 7 am daily (retrieves any other files for potential future use)
- TSYS API - DDA - 7 am daily (retrieves merchant bank account information from the API)
☝️ The TSYS API - Merchant Information task should only be used to retrieve merchant details when initially adding the portfolio to Merchant Central. It should not be scheduled to run periodically.
Boarding & Real-Time Account Changes
- Get the PPM pricing template spreadsheets from mReports, the list of associations, and the ERG names, then provide them to Support.
- Submit your TSYS project to enable the commands required to board new merchants to TSYS Express and PPM and make real-time account changes for existing merchants.
TSYS Express Commands
- ViewMerchant
- AddMerchant
- MaintainMerchant
- ViewTerminal
- AddTerminal
- MaintainTerminal
- MaintainTerminalDetails
- ViewMerchantTerminals
- ViewAmexOptBlueReg
- AddAmexOptBlueReg
- MaintainAmexOptBlueReg
- DeleteAmexOptBlueReg
- ViewDiscoverRegistration
- AddDiscoverRegistration
- MaintainDiscoverRegistration
- AddNote
- ViewNotes
TSYS PPM Commands
- AddMerchantFees
- ModifyMerchantFees
- DeleteMerchantFees
- GetMerchantPricing
- SaveMerchantPricing
- GetMerchantDDA
- SaveMerchantDDA
- DeleteMerchantDDA
To learn how these commands are used in TurboApp and Helpdesk, see TSYS Wholesale Boarding API Usage.
Boarding a Merchant to TSYS
To board an account to TSYS, click the Board Merchant button on a lead. This launches the TurboApp, where you can enter the remaining required merchant information and submit the application to the processor:
For faster merchant boarding, follow the instructions in our TSYS FSP One-Click & Auto Boarding guide.
Viewing Daily Batches With Transactions
To view daily batches and their transactions, open the Merchant Details page and click the Batches tab:
Click any batch to view additional details, including transaction amount, card type, authorization code, purchase ID, and more.
A Deposits tab is also available.
When comparing Deposits and Batches in mReports with Merchant Central, there is a one-day delay in reporting. For example, May 13 in mReports appears as May 14 in Merchant Central.
If the batch figures do not match, the difference may be caused by chargebacks, as chargebacks are included within the batch view in Merchant Central.
To view merchant account status information retrieved from TSYS, open the Account Status tab.
The tab contains several accordions that you can expand to view the different types of account information:
Frequently Asked Questions
Can I auto-fill a Discover MID in TSYS TurboApp? Yes. TurboApp can automatically generate the next available Discover MID when boarding merchants through TSYS FSP (Express + PPM), provided the TSYS configuration is set up correctly. To enable Discover MID auto-generation:
- Go to Manage → TurboApp → Boarding APIs → TSYS.
- Under Bank Settings, enable Enable and require Discover Registration.
- Under Discover MID Range, set Starting From to the last Discover MID used outside Merchant Central (IRIS).
- Make sure the Data Source includes the correct Acquirer ID, sometimes referred to by TSYS as the Discover AIID. To access the data source settings navigate to Manage → Processors → Processor Settings, and click the pencil icon in the Actions column on the TSYS processor.
- Confirm that TSYS/Global Payments has provided the appropriate Discover MID range.
Once configured, TurboApp reviews the TSYS MIDs already in the system and suggests the next available Discover MID, so it does not need to be entered manually for each application.
Important: If Starting From is blank, auto-generation will not work for the first application and the Discover MID must be entered manually. The starting value must also accurately reflect MIDs used outside Merchant Central; otherwise, TurboApp could suggest a MID that is already in use.
Note: Setting MID Validator to None in the Boarding APIs settings disables MID auto-generation.