ReepayCheckoutSheet Android SDK Module

CheckoutSheet is a prebuilt UI that contains the steps to pay in Reepay Checkout window - collecting payment details and confirming the payment. The checkout is placed into a sheet or a fullscreen cover that displays on top of your app's UI.

See official documentation

Table of contents

• Features
• Requirements
• Getting started
  • Example

Features

• Payment security: We are PCI compliant, which makes it simple for you to collect sensitive data such as credit card numbers. This means the sensitive data is sent directly to Reepay instead of passing through your server.

• SCA-ready: The SDK automatically performs native 3D Secure authentication to comply with Strong Customer Authentication regulation in Europe.

Requirements

The ReepayCheckoutSheet module is compatible with apps targeting Android 8.0 (API level 26) or above.

Getting started

Install from Jitpack

Link to Jitpack repository can be found here

Step 1. Add Jitpack to root settings.gradle file

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

Step 2. Add dependency to build.gradle.kts. Replace TAG with the desired version number

dependencies {
    ...
    implementation("com.github.reepay:reepay-android-checkout-sheet:TAG")
}

Install locally

Step 1. Download this repository

Step 2. Register this module in the root settings.gradle.kts file:

include(":checkout")

...

project(":checkout").projectDir =
    file("/PATH/TO/SDK/reepay-android-checkout-sheet/checkout")

Step 3. Add dependency in build.gradle.kts

dependencies {
    ...
    implementation(project(":checkout"))
}

Configuration

Basic setup

override fun onCreate(savedInstanceState: Bundle?) {
    ...

    // Instantiate checkout sheet
    val checkoutSheet = CheckoutSheet(this)

    // Create configuration
    val config = CheckoutSheetConfig(
        sessionId = "", // Session id from Billwerk+ checkout
        sheetStyle = SheetStyle.FULL_SCREEN, // Sets the height of the Checkout sheet
        dismissible = true, // If set to `true`, the sheet will render a close button and be dismissible by pressing outside the checkout sheet hit box.
        hideHeader = true, // If set to `true`, the sheet will be rendered without the header
        closeButtonIcon = R.drawable.button_close_icon, // (Optional) Overrides the default icon for the close button. Argument is the id of the string. Image must be square
        closeButtonText = R.string.close_button_text // (Optional) Text shown next to the close button. Argument is the id of the string
    )

    // Open checkoutSheet (for example, inside a setOnClickListener)
    checkoutSheet.open(config)
}

Listen for events

override fun onCreate(savedInstanceState: Bundle?) {

    // Set up checkout sheet as shown above

    ...

    listenForEvents()
}


private fun listenForEvents() {
    lifecycleScope.launch {
        repeatOnLifecycle(Lifecycle.State.STARTED) {
            CheckoutEvent.events.collect { eventType ->
                // Log the event here
            }
        }
    }
}

Example

• Reepay Checkout demo app
  • This demo app demonstrates how to build a checkout flow using CheckoutSheet, an embeddable component that supports card payments with a single integration.