Login
to Juspay Dashboard and navigate to Marketplace tab to get the Simpl enabled on your payment page.
Juspay will release these changes in testing environment (CUG) for you to initiate the end to end testing on your app / website.
Please add the Simpl Fingerprint Dependencies as per the designated platforms (Android, iOS) provided below.
Android :
Include the Simpl Fingerprinting SDK as a dependency.
SDK version: Refer to the release notes for the most recent SDK version here.
Please ensure that INTERNET android permission is added to AndroidManifest.xml
Verify that you are loading the Simpl Fingerprinting SDK properly by logging Log.d("SimplFingerprint", SimplFingerprint.getInstance().toString()); in the Logcat console. You should receive an Object in return.
iOS :
Integrate the Simpl SDK by installing the CocoaPods dependency.
SDK version: Refer to the release notes for the most recent SDK version here.
The above code installs the latest version of the pod available in the CocoaPods Specs repo (or your private repo, if that’s where it’s hosted).
If you already have a Podfile.lock, it will lock to the version recorded there until you run pod update SimplFingerPrint.
pod 'SimplFingerPrint', '<version>' : Installs the specific version you mention.
Example: pod 'SimplFingerPrint', '1.0.11'
This forces CocoaPods to always use that version, regardless of newer versions being available.
If the latest pod version is 1.4.0:
pod 'SimplFingerPrint' → Will install 1.4.0 (unless Podfile.lock has an older version pinned).
pod 'SimplFingerPrint', '1.2.3' → Will always install 1.2.3.
Before enabling the Simpl payment option on your payment page, a check needs to be made to ensure that the user is eligible to use Simpl.
Simpl eligibility is checked using the phone number.
Use the SIMPL Eligibility Payload to check if the user is eligible for Simpl flow.
If the user is not eligible, either hide the Simpl option or grey it out and provide the reason for the ineligibility.
If the user is eligible and linking is required, then Simpl is displayed with the option to link.
Additional Simpl-related parameters are expected to be passed to Juspay while you are creating the order.
Refer to the Create Order API call for Simpl for the necessary changes.
Modify Process Payload to initiate Simpl transactions.
Refer to the Process Payload call for the necessary changes.
Once the Simpl wallet is linked, merchants have to dynamically handle the UI to display the current balance for the Simpl wallet.
Utilize the Refresh Wallet SDK call to fetch the Simpl balance and Direct Wallet Token for a user.
Alternatively, Juspay also provides this information through the Refresh Wallet API, which can be invoked from your backend.
If you want to provide users with the option to unlink their linked Simpl wallet, you can utilize the Delink Wallet API call.
Backend changes are required on your end to handle Simpl transaction-related webhook requests and order status responses.
