Here are the steps to configure the TSYS FSP Integration, which allows boarding and reporting for TSYS FSP portfolios.
Request Setup from TSYS
- Contact your RM to request boarding and reporting (details below) for your portfolio and Merchant Central.
- TSYS will contact Merchant Central with the necessary credentials and information.
Reporting
The following files (with sample naming structure shown below) should be enabled to go to the SFTP:
| 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 |
Note: TSYS may use variations in the naming of files, and may send the files multiple times per day.
*Note: We only support monthly residuals files (_MLY_) and not daily residuals files (_DLY_).
To pull in the info from the SFTP, ensure the following tasks are set at 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 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 (gets merchant bank account info from API)
Note: the TSYS API - Merchant Information task should only be to retrieve merchant details when first adding the portfolio to Merchant Central. It should not be added to the schedule to run periodically.
Boarding & Real-Time Account Changes
1) Get the PPM pricing templates spreadsheets from mReports, list of associations, and ERG names and provide to Support.
2) Submit your TSYS project to enable these commands that will handle boarding new merchants to TSYS Express and PPM as well as the ability to 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 the commands are used in the TurboApp and Helpdesk, please see our article on TSYS Wholesale Boarding API Usage.
Boarding a Merchant to TSYS
To board an account to TSYS, click the Board Merchant button on a lead. To use One-Click Boarding, follow these steps.
This will launch TurboApp, where you can enter the remaining required merchant information and then submit the application to the processor:
Viewing Daily Batches With Transactions
To view the daily batches with transactions go to the Merchant Details page and click on the Batches tab:
There is also a Deposits tab.
When comparing the Deposits and Batches from mReports to Merchant Central, there is a one day delay in the reporting. (i.e. May 13th in mReports appears as May 14th in Merchant Central).
Also, if the batch figures do not match, the difference will be any chargebacks that have occurred as they are accounted for within the batch view of Merchant Central.
To view the merchant’s account status information which is retrieved from TSYS open the Account Status tab.
Within the tab, there are several accordions which you can expand in order to view the different types of information: