Payment terminal integration testing
To complete the integration of a payment terminal, final testing and completion of a test protocol are required before going live. You will find the link at the end of the relevant section according to your integration type below.
In the test environment, you can try out the integration without worrying about real financial charges — all transactions take place only in the test environment and no actual financial operations are performed. You can pay contactlessly by card, phone, or watch. Contact payment (inserting a card into the terminal) is not fully supported in the test environment (transactions may be declined). You can simulate different transaction results using the amounts from the Amount-based simulator table.
Testing Remote Connection Integration (CloudPOS - REST API)
Final Testing
To successfully complete the payment terminal integration with your cash register system using the REST API over the internet, always perform final testing according to the test protocol. The scope of testing depends on the integrated functions your cash register system supports and which are enabled on the given terminal.
Testing Procedure
Verify that your cash register system correctly sends requests to our API and receives responses. Verify that the terminal is connected to the internet and in the Switchio Pay application on the terminal, both the GSA server and Authorization server are Online.
According to the instructions in the test protocol, perform the following operations:
- test payment initiation
- test payment reversal
- test payment status inquiry
- test settlement completion
If you have integrated additional features, test those as well (according to the scope of your integration):
- test terminal status
- test refund initiation
- test refund reversal
- test refund status inquiry
Fill in the final test protocol for integration via CloudPOS - REST API.
Testing Local Network Connection Integration (GSA Protocol)
Final Testing
To successfully complete the payment terminal integration on the same local network with your cash register system using the GSA protocol, always perform final testing according to the test protocol. The scope of testing depends on the integrated functions your cash register system supports and which are enabled on the given terminal.
Testing Procedure
Review the guidelines in the Implementation and Best Practices section and verify that your implementation complies with them. Verify that both the terminal and cash register are connected to the same local network and HTTP protocol (not HTTPS) is used for communication. Verify that in your cash register you have configured the correct IP address and port number as shown on the terminal. Verify that the terminal is connected to the internet and in the Switchio Pay application on the terminal, both the GSA server and Authorization server are Online.
According to the instructions in the test protocol, perform the following operations:
- test payment processing
- test payment reversal
- test settlement completion
If you have integrated additional features, test those as well (according to the scope of your integration).
- test transaction status inquiry
- test refund processing
- test pre-authorization, completion, and cancellation
Fill in the final test protocol for integration via GSA Protocol.
Testing Custom Application Integration (ECR Protocol)
Final Testing
To successfully complete the payment terminal integration from a custom cash register application using the ECR protocol, always perform final testing according to the test protocol. The scope of testing depends on the integrated functions your application supports and which are enabled on the given terminal.
Testing Procedure
Review the guidelines in the Android application for payment terminal section and send us at developer@comgate.cz a link to your application (.apk file) and brief documentation at minimum explaining how to test all payment operation types that your application integrates, as well as any login credentials if needed for testing. A Comgate employee will test the application and inform you of the results.
According to the instructions in the test protocol, perform the following operations:
- test payment processing
- test payment reversal
- test settlement completion
If you have integrated additional features, test those as well (according to the scope of your integration).
- test refund processing
- test pre-authorization, completion, and cancellation
Fill in the final test protocol for integration via ECR Protocol.