- Overview
- Request Setup from TSYS
- Reporting
- Boarding & Real-Time Account Changes
- Viewing Daily Batches With Transactions
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: