Mobile SDKs
Integration errors due to outdated SDK versions.
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
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
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:
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...
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:
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
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:
orderIdandpaymentSessionIdare securely generated from your backend.setEnvironmentis eitherSANDBOXorPRODUCTION.- You specify the platform (for example, UPI, card, or netbanking).
Why don't UPI apps launch in test mode?
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:
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.
Is UPI Intent supported on desktop websites?
Is UPI Intent supported on desktop websites?
No. UPI Intent works only on supported mobile devices and mobile applications, because it opens an installed UPI app.On desktop websites, present UPI QR. Do not offer UPI Intent or UPI Collect on desktop, except where NPCI still allows Collect. See UPI Collect Flow Deprecation for QR setup, iOS support, and exemption details.
Why do I get a payment_session_id_invalid error in the React Native SDK?
Why do I get a payment_session_id_invalid error in the React Native SDK?
The
payment_session_id_invalid error means the payment session ID is missing or does not exist. A common cause is an environment mismatch: the order was created in one environment and the SDK session points to another.To resolve this error:- Create the order in the same environment that the app uses.
- Initialise
CFSessionwithCFEnvironment.PRODUCTIONfor production orders, orCFEnvironment.SANDBOXfor sandbox orders.
SDK shows strange or inconsistent errors
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/