Integration

This section details how to integrate the payabl. Android SDK into your app, describing how merchant server participates in the process and how it aligns with the Mobile SDK Backend API endpoints.

Installation & Dependencies

Retrieving the AAR Fles

  • AAR Files:
    • payabl_sdk.aar
    • ipworks3ds_sdk.aar (for production, use ipworks3ds_sdk_deploy.aar)
  • Location:
    • These files should be placed in the lib folder within the module where the SDK will be integrated. You can retrieve them from our GitHub Releases Page or from the designated documentation repository.

Configuring Your Build

Add the following snipped to your module's build.gradle file:

  • Kotlin DSL:
    implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar"))))
    
  • Groovy:
    implementation fileTree(dir: "libs", include: ["*.aar"])
    

Additional Dependencies

Include all additional dependencies listed in the provided dependencies.txt file. These cover the necessary libraries required for the SDK to function correctly.

Sentry Crash Analytics

🚧

Warning!

If your application utilizes Sentry via the AndroidManifest.xml, include the following meta-data to avoid merge conflicts:

<meta-data 
    android:name="io.sentry.auto-init" 
    android:value="false"
    tools:replace="android:value" />

What’s Next