PayFacto API v1.3.9 (STP Installer) - STPI/STP - Integration Overview Document 2.0
STPI/STP Integration Overview Document 2.0
1
Unzip the SDK folder, it contains the following:
STPI Integration Documentation
- STPI-STP Integration Overview
- STPI-STP Client Installation Guide 2.0 – STPI Installation Guide (describes the important configurable options, for dev do not install STPI as a service)
- STPI- POS Interface (The doc with the API)
- STPI Error Codes
- STPISecure1.3.9
- tmcpayattable.p12 – Certificates required for POS integration
2
Make sure you have Java Runtime Environment (JRE v1.8 or above) installed on the computer.
3
- Common STPI properties can be edited under “gateway_sm.properties” but for dev purposes that should not be required. Refer to the STPI-STP Client Installation Guide on the properties.
- Start STPI Client using “run.bat” under ‘STPIClient’ folder.
4
- For DEV, the pos can connect to STPI on port 5656 without using SSL. Standard TCP messaging is used.
- That port can be configured from the STPI configuration file called gateway_sm.properties, pos.server.port=5656
5
- For details on the API, refer to the STPI Integration document named STPI-POS Interface.pdf.
- For the supported error codes, refer to the document named STPI Error Codes.pdf.
⚠️
Please note there is a $5 limit on the amount supported per check when working in non-SSL mode.
6
- After the POS integration is complete in the clear, switch to SSL.
- On STPI set the following property under gateway_sm.properties file to 2, i.e.: pos.server.mode=2.
- Restart STPI Client to enable SSL.
- Then use tmcpayattable.p12 on the pos side to setup SSL communication between STPI and the POS. The password for that file is tmc.
7
Now you are properly configured to work in production mode with SSL enabled. And amounts greater than $5 are also be supported. Perform a few end-to-end tests to make sure everything is operating as expected.
⚠️
This document and the information within are the property of PayFacto Payments Inc. (“PayFacto”) and may only be used for the purpose for which they are intended and supplied. Reproduction of this document or use of the information within, in whole or in part, is strictly prohibited without the express written consent of PayFacto. PayFacto reserves the right to revise this document and to periodically make changes to the content hereof, without obligation of PayFacto to notify any person or organization of such revision or changes.
- STPI - POS Interface (published in this Knowledge Base – link once cross-referenced)
- STPI-STP Client Installation Guide 2.0 (referenced in source document – not yet migrated to this Knowledge Base)
- STPI Error Codes (referenced in source document – not yet migrated to this Knowledge Base)