formall

formall

7 articles

Resolving Payment Errors


Payment errors can disrupt your business operations. This guide helps you identify and resolve common payment-related issues so you can ensure smooth transactions.

Before you start

  • Ensure you have access to your payment gateway account.
  • Verify that your internet connection is stable.

Steps to resolve payment errors

  1. Check Payment Gateway Credentials Navigate to the payment integration section of your application. Verify that the credentials entered for your payment gateway are correct. If needed, re-enter them and save the configuration.

  2. Verify Payment Gateway Status Visit the payment gateway's official website or contact their support to check if there are any ongoing outages or maintenance activities affecting transactions.

  3. Review Transaction Logs Access the transaction logs in your application to identify any patterns or specific errors associated with failed payments. Look for error codes or messages that can provide insight into the issue.

  4. Test Payment Gateway Integration Use the billing simulation feature to test the payment gateway integration. This allows you to simulate transactions and verify that the setup is functioning correctly without processing real payments.

  5. Update Payment Gateway Settings If there are updates or changes in the payment gateway's API or settings, ensure that your application reflects these updates. Adjust any necessary settings and save the changes.

  6. Contact Payment Gateway Support If the issue persists, contact the support team of your payment gateway for further assistance. Provide them with detailed information from your transaction logs to expedite the troubleshooting process.

Example: Testing Payment Gateway Integration

To simulate a transaction and verify your payment gateway setup, use the billing simulation feature:

{
 "transaction_type": "simulation",
 "amount": "100.00",
 "currency": "USD",
 "gateway": "example_gateway"
}

If something goes wrong

  • Incorrect Credentials: If you receive an error indicating incorrect credentials, double-check the username, password, and any API keys entered. Refer to the "Managing Your Billing Information" article for guidance on updating credentials.

  • Gateway Outage: If transactions fail due to a gateway outage, monitor the gateway's status page for updates. Consider setting up alerts for future outages.

  • Configuration Mismatch: If the billing simulation fails, revisit the payment integration settings. Ensure all configurations match the latest requirements from your payment gateway.

Last verified 2026-10-04

Is this helpful?