Gateway Error Messages: Understanding and Resolving Issues
What the common payment gateway errors actually mean — security violations, declines, malformed requests — and how to clear each one.
Gateway Error Messages: Understanding and Resolving Issues
This guide provides context to common error messages encountered by Paytia when interacting with payment gateways and offers steps to resolve them effectively.
1. Security Violation
A "Security Violation" error generally occurs when the payment gateway is unable to authenticate the connection from Paytia. This error indicates that the credentials or settings required for successful communication between Paytia and your payment gateway are incorrect or incomplete.
Steps to Resolve:
Verify Merchant Account Details:
- Login to the Paytia administration portal.
- Navigate to the Manage Payments > Payment Gateway Setup page.
- Check the following information:
- Username
- Password
- API Service Keys
- Ensure these credentials are accurate and match those provided by your payment gateway.
Check for IP Address Whitelisting:
- Some payment gateways require you to whitelist the IP address of the platform making API calls for added security.
- Refer to your payment gateway's documentation to confirm if IP whitelisting is necessary.
Update Gateway Trust Settings:
- If your payment gateway requires specific configurations to trust external platforms, ensure that Paytia's IP address is added to the trusted list.
Consult the Support Article:
- For detailed instructions on adding Paytia's IP address to your payment gateway, review the article: "How do I add the Paytia payment service IP address to my payment gateway?"
By following these steps, you should be able to resolve the "Security Violation" error and ensure seamless communication between Paytia and your payment gateway. If the issue persists, contact Paytia Support for additional assistance.
More in Troubleshooting
How do I reset a users password?
You don't set a user's password for them. You resend the reset link from the management portal and they choose their own.
How should I enter monetary values in the payment IVR?
There's no decimal point on a phone keypad, so the IVR assumes one. GBP 100.00 is 10000; 10.00 is 1000. Get it wrong and you'll charge the wrong amount.
How to Change Your Password
Two routes: change it from inside your account if you know your current password, or reset it from the login screen if you don't.
Troubleshooting Call Audio Quality Issues with Paytia
We sit in the middle of the call, so audio problems can come from either leg. Working out which side it's on is what gets it fixed quickly.
What is an Agent ID?
An Agent ID ties each payment to the member of staff who took it, which is what makes reporting and auditing possible.
What is an OTP code?
The one-time code we email during registration to confirm the address is yours. Here's where to enter it and what to do if it doesn't turn up.
Still need help?
Our support team is here to help. Submit a ticket and we'll get back to you within one business day.