SDK Troubleshooting

Common integration errors and solutions for SDKs

Mobile SDKs

Integration errors due to outdated SDK versions.

To troubleshoot this issue, follow this step:

• Always use the latest SDK versions. Check the Changelog for updates.

NOT_AVAILABLE isn’t a trusted source, app should be installed from play store or another whitelisted app

When the user is trying to install apps from sources other than the Play Store / App Store and test them in a Production environment then Cashfree mobile SDK Android, React Native, Flutter, Cordova, Ionic, Capacitor will block the transaction.

To troubleshoot this issue, follow these steps: The guidelines provided here to test app in production environments.

NDK version mismatch error with flutter_cashfree_pg_sdk

This issue occurs when there is an NDK version mismatch between your local setup and the SDK requirements.
To troubleshoot this issue, follow these steps:

• Update the ndk.dir path in your local.properties file:
  ndk.dir=/path/to/ndk/<required_version>
• Alternatively, open Android Studio > SDK Manager > SDK Tools, and install the required NDK version.

Gradle build error: Could not resolve com.cashfree.pg:api...

This issue occurs when Gradle cannot find the required Cashfree dependencies.
To troubleshoot this issue, follow these steps:

• Add the following repositories inside android/build.gradle under allprojects > repositories:
  google()
mavenCentral()
maven { url "https://jitpack.io" }

How to initialise payment using cashfree_pg_sdk

To initialise a payment, follow these steps:

• Use the method:
  CashfreePGSDK.doPayment(orderId, setEnvironment, setPaymentSessionId);
• Ensure the following:
  • orderId and paymentSessionId are securely generated from your backend.
  • setEnvironment is either SANDBOX or PRODUCTION.
  • You specify the platform (for example, UPI, card, or netbanking).

Why don’t UPI apps launch in test mode?

This issue occurs in the sandbox (test) environment. Real UPI apps don’t launch because transactions are simulated.
To test UPI behaviour, follow these steps:

• Use the Cashfree UPI simulator with sandbox credentials.
• For end-to-end testing, use production mode with small payment amounts.

SDK shows strange or inconsistent errors

To troubleshoot this issue, follow these steps:

• Run:
  flutter clean
flutter pub get
• If issues persist, delete the following directories:
  .gradle/
.idea/

Server-Side SDKs

Sample integration kits

Sample integration kits

• Python
• Java
• .NET
• PHP
• Node.js
• Go