Overview

Payabl’s SDKs are designed to deliver clear error messages and detailed logs to assist you in identifying and resolving issues. Whether you’re dealing with initialization problems, network issues, or payment processing errors, this guide provides targeted steps to get you back on track.

Common Error Scenarios

• Initialization Errors
  Example: The SDK fails to initialize due to missing or invalid configuration parameters.
  Action: Verify the setup per the SDK Initialization Guide for Android or iOS Configuration.
• Network Connectivity Issues
  Example: The app cannot connect to Payabl servers.
  Action: Check your internet connection, firewall settings, and confirm that no proxies are blocking the requests.
• Payment Processing Failures
  Example: Payment transactions are declined or fail to process.
  Action: Validate the payment details and ensure compliance with the integration requirements outlined in the Android Save Card or iOS Save Card Guides.
• Configuration Mismatches
  Example: Incorrect API keys or environment settings.
  Action: Double-check your configuration parameters against your account details and the relevant integration documentation (iOS) or Android integration.

Troubleshooting Steps

1. Verify SDK Initialization

   • Ensure that the SDK is initialized according to the required steps.
   • Review the relevant guide:
     • Android SDK Initialization
     • iOS Configuration

2. Check Configuration Parameters

   • Confirm that your API keys, endpoints, and environment settings are correct.
   • Refer to the Integration Guides for detailed setup instructions.

3. Review Logs and Debug Output

   • Enable detailed logging to capture error messages.
     • Android: Use Logcat to monitor runtime logs.
     • iOS: Use Xcode’s console logs.
   • Look for error codes, timestamps, or stack traces that can pinpoint the issue.

4. Test Network Connectivity

   • Verify that your device or simulator has internet access.
   • Ensure no firewall or proxy restrictions are blocking the connection.

5. Reproduce and Isolate the Issue

   • Replicate the error in a controlled environment.
   • Note down the steps and any associated error codes; this can help narrow down the cause.

Logging & Debugging

• Enable Detailed Logging:
  Activating verbose logging in your development environment is crucial for diagnosing issues.
• Monitor Console Outputs:
  Regularly check your device or simulator console for exceptions or warnings that occur during SDK operations.

Common Gateway Error Scenarios

Please check our section on Declines and Failed Payments to learn why payments might fail and get tips for reducing declines. For further details on errors, refer to one of our following API sections:

1. payabl. Response codes - status codes that payabl. generates and sends in response.
2. Card Issuer related error codes
3. Mastercard Error Codes
   1. Mastercard Merchant Advice Codes
4. Visa Error Codes

When to Contact Support

If the issue persists after following the steps:

• Collect Information:
  Gather logs, error codes, and a detailed description of the issue and reproduction steps.
• Review Documentation:
  Double-check our integration guides to ensure nothing was missed.
• Contact Us:
  Reach out to our support team at [email protected] for further assistance.

Additional Resources

• Android SDK Documentation
• iOS SDK Documentation
• Server Setup Guide

Remember to use the latest version of our SDKs to benefit from the most recent improvements and fixes.