@klarna/react-native-klarna-network-payment 0.0.1 → 2.7.0

package/README.md

@@ -1,45 +1,159 @@
-# @klarna/react-native-klarna-network-payment
+# Klarna Network Payment SDK React Native
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+[![NPM][npm-badge]][npm-url]
+[![React Native][dependency-badge]][dependency-url]
+[![Platform][platform-badge]][platform-url]
+[![License][license-badge]][license-url]
+[![Developed at Klarna][klarna-badge]][klarna-url]
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+React Native package for Klarna Network Payment. This library wraps KlarnaNetworkPayment and exposes payment request functionality directly on the `Klarna` instance via `klarna.payment`.
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+Requires [`@klarna/react-native-klarna-network-core`](https://www.npmjs.com/package/@klarna/react-native-klarna-network-core) to be installed and initialized first.
 
-## Purpose
+**New Architecture only** (TurboModule).
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@klarna/react-native-klarna-network-payment`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+## Requirements
 
-## What is OIDC Trusted Publishing?
+- iOS 13 or later.
+- Android 5.0 (API 21) or later.
+- React Native 0.76.0 or later (New Architecture required).
+- `@klarna/react-native-klarna-network-core` installed and initialized.
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+## Getting started
 
-## Setup Instructions
+### Add Dependency
 
-To properly configure OIDC trusted publishing for this package:
+#### NPM
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+```shell
+npm install @klarna/react-native-klarna-network-payment --save
+```
 
-## DO NOT USE THIS PACKAGE
+#### Yarn
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+```shell
+yarn add @klarna/react-native-klarna-network-payment
+```
 
-## More Information
+## Usage
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+Import this package once at app startup (e.g. in your root `index.js`) to activate the `payment` property on `Klarna`. After that, `klarna.payment` is available anywhere you have a `Klarna` instance.
 
----
+```ts
+import '@klarna/react-native-klarna-network-payment';
+```
 
-**Maintained for OIDC setup purposes only**
+### Initiate with a payment request ID
+
+Use this when a payment request already exists on the server side.
+
+```ts
+import { Klarna } from '@klarna/react-native-klarna-network-core';
+
+const klarna = await Klarna.initialize({
+  clientId: '...',
+  appReturnUrl: '...',
+});
+
+const paymentRequest = await klarna.payment.initiate('payment-request-id');
+console.log(paymentRequest.state); // 'IN_PROGRESS'
+```
+
+### Initiate with payment request data
+
+Use this to create and initiate a payment request in one step.
+
+```ts
+import type { KlarnaPaymentRequestData } from '@klarna/react-native-klarna-network-payment';
+
+const data: KlarnaPaymentRequestData = {
+  amount: 10000, // in minor currency units (e.g. cents)
+  currency: 'SEK',
+  paymentOptionId: 'option-id', // optional
+  paymentRequestReference: 'ref-123', // optional
+};
+
+const paymentRequest = await klarna.payment.initiate(data);
+```
+
+### Fetch a payment request
+
+```ts
+const paymentRequest = await klarna.payment.fetch('payment-request-id');
+```
+
+### Cancel a payment request
+
+```ts
+const paymentRequest = await klarna.payment.cancel('payment-request-id');
+```
+
+## API
+
+### `klarna.payment`
+
+Accessible on any initialized `Klarna` instance after importing this package.
+
+| Method     | Signature                                                                                       | Description                                                               |
+| ---------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `initiate` | `(paymentRequestIdOrData: string \| KlarnaPaymentRequestData) => Promise<KlarnaPaymentRequest>` | Initiates a payment request by ID or creates and initiates one from data. |
+| `fetch`    | `(paymentRequestId: string) => Promise<KlarnaPaymentRequest>`                                   | Fetches the current state of a payment request.                           |
+| `cancel`   | `(paymentRequestId: string) => Promise<KlarnaPaymentRequest>`                                   | Cancels a payment request.                                                |
+
+### `KlarnaPaymentRequest`
+
+| Field                     | Type                                       | Description                                    |
+| ------------------------- | ------------------------------------------ | ---------------------------------------------- |
+| `paymentRequestId`        | `string`                                   | Unique identifier for the payment request.     |
+| `state`                   | `KlarnaPaymentRequestState`                | Current state of the payment request.          |
+| `previousState`           | `KlarnaPaymentRequestState \| null`        | Previous state, if any.                        |
+| `stateContext`            | `KlarnaPaymentRequestStateContext \| null` | Additional context for the current state.      |
+| `stateReason`             | `KlarnaPaymentRequestStateReason \| null`  | Reason for the current state, if any.          |
+| `paymentRequestReference` | `string \| null`                           | Partner-supplied reference for reconciliation. |
+
+### `KlarnaPaymentRequestState`
+
+`'SUBMITTED' | 'IN_PROGRESS' | 'COMPLETED' | 'EXPIRED' | 'CANCELED' | 'DECLINED'`
+
+### `KlarnaPaymentRequestStateReason`
+
+`'PARTNER_CANCELED' | 'PURCHASE_FLOW_ABORTED' | 'TECHNICAL_ERROR' | 'PAYMENT_DECLINED' | 'PAYMENT_REQUEST_SUBMITTED'`
+
+### `KlarnaPaymentRequestData`
+
+| Field                       | Type                                 | Required | Description                                                 |
+| --------------------------- | ------------------------------------ | -------- | ----------------------------------------------------------- |
+| `amount`                    | `number`                             | Yes      | Total amount in minor currency units (e.g. cents).          |
+| `currency`                  | `string`                             | Yes      | ISO 4217 currency code (e.g. `"SEK"`).                      |
+| `paymentOptionId`           | `string`                             | No       | Pre-select a specific payment option in the flow.           |
+| `paymentRequestReference`   | `string`                             | No       | Partner reference for webhook correlation.                  |
+| `requestCustomerToken`      | `KlarnaRequestCustomerToken`         | No       | Request a customer token to be returned on completion.      |
+| `shippingConfig`            | `KlarnaShippingConfig`               | No       | Configure shipping address collection.                      |
+| `collectCustomerProfile`    | `KlarnaCollectCustomerProfileType[]` | No       | Customer profile fields to collect during the flow.         |
+| `supplementaryPurchaseData` | `KlarnaSupplementaryPurchaseData`    | No       | Line items, shipping, subscriptions, and on-demand details. |
+
+## Support
+
+If you are having any issues using the SDK in your project or if you think that something is wrong with the SDK itself, please follow our [support guide](https://github.com/klarna/react-native-klarna-inapp-sdk/blob/master/SUPPORT.md).
+
+## Contribution
+
+If you want to contribute to this project please follow our [contribution guide](https://github.com/klarna/react-native-klarna-inapp-sdk/blob/master/CONTRIBUTING.md).
+
+## License
+
+This project is licensed under
+[Apache License, Version 2.0](https://github.com/klarna/react-native-klarna-inapp-sdk/blob/master/LICENSE).
+
+<!-- Markdown images & links -->
+
+[npm-badge]: https://img.shields.io/npm/v/@klarna/react-native-klarna-network-payment?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@klarna/react-native-klarna-network-payment
+[dependency-badge]: https://img.shields.io/npm/dependency-version/@klarna/react-native-klarna-network-payment/peer/react-native?style=flat-square
+[dependency-url]: https://www.npmjs.com/package/@klarna/react-native-klarna-network-payment?activeTab=dependencies
+[platform-badge]: https://img.shields.io/badge/platform-React%20Native-lightgrey?style=flat-square
+[platform-url]: https://reactnative.dev
+[license-badge]: https://img.shields.io/github/license/klarna/react-native-klarna-inapp-sdk?style=flat-square
+[license-url]: https://github.com/klarna/react-native-klarna-inapp-sdk/blob/master/LICENSE
+[klarna-badge]: https://img.shields.io/badge/%20-Developed%20at%20Klarna-black?labelColor=ffb3c7&style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAOCAYAAAAmL5yKAAAAAXNSR0IArs4c6QAAAIRlWElmTU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAALQAAAAAQAAAtAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABCgAwAEAAAAAQAAAA4AAAAA0LMKiwAAAAlwSFlzAABuugAAbroB1t6xFwAAAVlpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IlhNUCBDb3JlIDUuNC4wIj4KICAgPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4KICAgICAgPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIKICAgICAgICAgICAgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPgogICAgICAgICA8dGlmZjpPcmllbnRhdGlvbj4xPC90aWZmOk9yaWVudGF0aW9uPgogICAgICA8L3JkZjpEZXNjcmlwdGlvbj4KICAgPC9yZGY6UkRGPgo8L3g6eG1wbWV0YT4KTMInWQAAAVBJREFUKBVtkz0vREEUhsdXgo5qJXohkUgQ0fgFNFpR2V5ClP6CQu9PiB6lEL1I7B9A4/treZ47c252s97k2ffMmZkz5869m1JKL/AFbzAHaiRbmsIf4BdaMAZqMFsOXNxXkroKbxCPV5l8yHOJLVipn9/vEreLa7FguSN3S2ynA/ATeQuI8tTY6OOY34DQaQnq9mPCDtxoBwuRxPfAvPMWnARlB12KAi6eLTPruOOP4gcl33O6+Sjgc83DJkRH+h2MgorLzaPy68W48BG2S+xYnmAa1L+nOxEduMH3fgjGFvZeVkANZau68B6CrgJxWosFFpF7iG+h5wKZqwt42qIJtARu/ix+gqsosEq8D35o6R3c7OL4lAnTDljEe9B3Qa2BYzmHemDCt6Diwo6JY7E+A82OnN9HuoBruAQvUQ1nSxP4GVzBDRyBfygf6RW2/gD3NmEv+K/DZgAAAABJRU5ErkJggg==
+[klarna-url]: https://github.com/klarna

package/android/build.gradle

@@ -0,0 +1,95 @@
+def klarnaNetworkCorePkgJson = providers.exec {
+  commandLine "node", "--print",
+    "require.resolve('@klarna/react-native-klarna-network-core/package.json')"
+}.standardOutput.asText.get().trim()
+
+apply from: "${file(klarnaNetworkCorePkgJson).parent}/android/klarna-network-versions.gradle"
+
+buildscript {
+  ext.KlarnaNetworkPayment = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 21,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return KlarnaNetworkPayment[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.klarna.mobile.sdk.reactnative.klarnanetwork.payment"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  testOptions {
+    unitTests.returnDefaultValues = true
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+  maven {
+    url 'https://x.klarnacdn.net/mobile-sdk/'
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+
+  implementation "com.klarna.mobile.sdk:klarna-network-payment:${klarnaNetworkVersions.klarnaMobileSdkVersion}"
+  implementation "com.klarna.mobile.sdk:klarna-network-payment-button:${klarnaNetworkVersions.klarnaMobileSdkVersion}"
+  compileOnly project(":klarna_react-native-klarna-network-core")
+
+  testImplementation project(":klarna_react-native-klarna-network-core")
+  testImplementation "junit:junit:4.13.2"
+  testImplementation "org.jetbrains.kotlin:kotlin-test-junit:${getExtOrDefault('kotlinVersion')}"
+  testImplementation "io.mockk:mockk:1.14.5"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest />

package/android/src/main/java/com/klarna/mobile/sdk/reactnative/klarnanetwork/payment/KlarnaNetworkPaymentButtonViewSpec.kt

@@ -0,0 +1,22 @@
+package com.klarna.mobile.sdk.reactnative.klarnanetwork.payment
+
+import android.view.View
+import com.facebook.react.bridge.ReadableArray
+import com.facebook.react.uimanager.SimpleViewManager
+import com.facebook.react.uimanager.ViewManagerDelegate
+import com.facebook.react.viewmanagers.KlarnaNetworkPaymentButtonManagerDelegate
+import com.facebook.react.viewmanagers.KlarnaNetworkPaymentButtonManagerInterface
+
+abstract class KlarnaNetworkPaymentButtonViewSpec<T : View> :
+    SimpleViewManager<T>(),
+    KlarnaNetworkPaymentButtonManagerInterface<T> {
+
+    private val delegate: ViewManagerDelegate<T> =
+        KlarnaNetworkPaymentButtonManagerDelegate(this)
+
+    override fun getDelegate(): ViewManagerDelegate<T> = delegate
+
+    override fun receiveCommand(root: T, commandId: String, args: ReadableArray) {
+        delegate.receiveCommand(root, commandId, args)
+    }
+}

package/android/src/main/java/com/klarna/mobile/sdk/reactnative/klarnanetwork/payment/KlarnaNetworkPaymentModule.kt

@@ -0,0 +1,46 @@
+package com.klarna.mobile.sdk.reactnative.klarnanetwork.payment
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+import com.klarna.mobile.sdk.reactnative.klarnanetwork.payment.NativeKlarnaNetworkPaymentSpec
+import com.facebook.react.bridge.ReadableMap
+
+@ReactModule(name = KlarnaNetworkPaymentModule.NAME)
+class KlarnaNetworkPaymentModule(reactContext: ReactApplicationContext) :
+    NativeKlarnaNetworkPaymentSpec(reactContext) {
+
+    private val impl = KlarnaNetworkPaymentModuleImpl(reactContext)
+
+    companion object {
+        const val NAME = NativeKlarnaNetworkPaymentSpec.NAME
+    }
+
+    override fun initiateWithId(instanceId: String, paymentRequestId: String, promise: Promise?) {
+        impl.initiateWithId(instanceId, paymentRequestId, promise)
+    }
+
+    override fun initiateWithData(instanceId: String, data: ReadableMap?, promise: Promise?) {
+        impl.initiateWithData(instanceId, data, promise)
+    }
+
+    override fun fetch(instanceId: String, paymentRequestId: String, promise: Promise?) {
+        impl.fetch(instanceId, paymentRequestId, promise)
+    }
+
+    override fun cancel(instanceId: String, paymentRequestId: String, promise: Promise?) {
+        impl.cancel(instanceId, paymentRequestId, promise)
+    }
+
+    override fun presentationFetch(instanceId: String, data: ReadableMap?, promise: Promise?) {
+        impl.presentationFetch(instanceId, data, promise)
+    }
+
+    override fun presentationHandleLink(instanceId: String, url: String, promise: Promise?) {
+        impl.presentationHandleLink(instanceId, url, promise)
+    }
+
+    override fun dispose(instanceId: String, promise: Promise?) {
+        impl.dispose(instanceId, promise)
+    }
+}

package/android/src/main/java/com/klarna/mobile/sdk/reactnative/klarnanetwork/payment/KlarnaNetworkPaymentModuleImpl.kt

@@ -0,0 +1,163 @@
+package com.klarna.mobile.sdk.reactnative.klarnanetwork.payment
+
+import android.os.Handler
+import android.os.Looper
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableMap
+import com.klarna.mobile.sdk.klarna.network.core.api.common.KlarnaResult
+import com.klarna.mobile.sdk.klarna.network.payment.api.presentation.models.KlarnaPaymentPresentationContent
+import com.klarna.mobile.sdk.klarna.network.payment.api.payment
+import com.klarna.mobile.sdk.reactnative.klarnanetwork.core.KlarnaNetworkCoreModuleImpl
+import java.util.concurrent.ConcurrentHashMap
+
+class KlarnaNetworkPaymentModuleImpl(
+    private val reactContext: ReactApplicationContext
+) {
+    companion object {
+        const val NAME = "KlarnaNetworkPayment"
+        private const val ERROR_ACTIVITY_NOT_FOUND = "Main Activity not found."
+        private const val ERROR_INSTANCE_NOT_FOUND = "No instance found for the given instanceId. Call initialize first."
+        private const val ERROR_NO_PRESENTATION_CONTENT = "No presentation content found. Call presentationFetch first."
+        val storedPresentationContent: ConcurrentHashMap<String, KlarnaPaymentPresentationContent> = ConcurrentHashMap()
+    }
+
+    fun initiateWithId(instanceId: String, paymentRequestId: String, promise: Promise?) {
+        val sdk = KlarnaNetworkCoreModuleImpl.getInstance(instanceId) ?: run {
+            promise?.reject(NAME, ERROR_INSTANCE_NOT_FOUND)
+            return
+        }
+        val activity = reactContext.currentActivity ?: run {
+            promise?.reject(NAME, ERROR_ACTIVITY_NOT_FOUND)
+            return
+        }
+        // PaymentControllerImpl calls fragmentManager.setFragmentResultListener() synchronously
+        // inside initiate(), which calls lifecycle.addObserver() — must run on the main thread.
+        Handler(Looper.getMainLooper()).post {
+            sdk.payment.initiate(activity = activity, paymentRequestId = paymentRequestId) { result ->
+                when (result) {
+                    is KlarnaResult.Success -> promise?.resolve(result.value.toWritableMap())
+                    is KlarnaResult.Failure -> promise?.reject(result.error.name, result.error.message)
+                }
+            }
+        }
+    }
+
+    fun initiateWithData(instanceId: String, data: ReadableMap?, promise: Promise?) {
+        val sdk = KlarnaNetworkCoreModuleImpl.getInstance(instanceId) ?: run {
+            promise?.reject(NAME, ERROR_INSTANCE_NOT_FOUND)
+            return
+        }
+        val activity = reactContext.currentActivity ?: run {
+            promise?.reject(NAME, ERROR_ACTIVITY_NOT_FOUND)
+            return
+        }
+        val paymentRequestData = try {
+            data?.let { KlarnaPaymentRequestMapper.buildPaymentRequestData(it) }
+        } catch (e: Exception) {
+            promise?.reject(NAME, e.message ?: "Invalid payment request data")
+            return
+        } ?: run {
+            promise?.reject(NAME, "data is required")
+            return
+        }
+        // Same as initiateWithId — must run on the main thread for the same reason.
+        Handler(Looper.getMainLooper()).post {
+            sdk.payment.initiate(activity = activity, paymentRequestData = paymentRequestData) { result ->
+                when (result) {
+                    is KlarnaResult.Success -> promise?.resolve(result.value.toWritableMap())
+                    is KlarnaResult.Failure -> promise?.reject(result.error.name, result.error.message)
+                }
+            }
+        }
+    }
+
+    // No Handler wrap needed: fetch and cancel dispatch to Dispatchers.Main internally.
+    fun fetch(instanceId: String, paymentRequestId: String, promise: Promise?) {
+        val sdk = KlarnaNetworkCoreModuleImpl.getInstance(instanceId) ?: run {
+            promise?.reject(NAME, ERROR_INSTANCE_NOT_FOUND)
+            return
+        }
+        sdk.payment.fetch(paymentRequestId = paymentRequestId) { result ->
+            when (result) {
+                is KlarnaResult.Success -> promise?.resolve(result.value.toWritableMap())
+                is KlarnaResult.Failure -> promise?.reject(result.error.name, result.error.message)
+            }
+        }
+    }
+
+    fun cancel(instanceId: String, paymentRequestId: String, promise: Promise?) {
+        val sdk = KlarnaNetworkCoreModuleImpl.getInstance(instanceId) ?: run {
+            promise?.reject(NAME, ERROR_INSTANCE_NOT_FOUND)
+            return
+        }
+        sdk.payment.cancel(paymentRequestId = paymentRequestId) { result ->
+            when (result) {
+                is KlarnaResult.Success -> promise?.resolve(result.value.toWritableMap())
+                is KlarnaResult.Failure -> promise?.reject(result.error.name, result.error.message)
+            }
+        }
+    }
+
+    // No Handler wrap needed: fetch dispatches to Dispatchers.Main internally.
+    fun presentationFetch(instanceId: String, data: ReadableMap?, promise: Promise?) {
+        val sdk = KlarnaNetworkCoreModuleImpl.getInstance(instanceId) ?: run {
+            promise?.reject(NAME, ERROR_INSTANCE_NOT_FOUND)
+            return
+        }
+        val presentationData = try {
+            data?.let { KlarnaPaymentRequestMapper.buildPresentationData(it) } ?: run {
+                promise?.reject(NAME, "data is required")
+                return
+            }
+        } catch (e: Exception) {
+            promise?.reject(NAME, e.message ?: "Invalid presentation data")
+            return
+        }
+        sdk.payment.presentation.fetch(data = presentationData) { result ->
+            when (result) {
+                is KlarnaResult.Success -> {
+                    if (KlarnaNetworkCoreModuleImpl.getInstance(instanceId) != null) {
+                        storedPresentationContent[instanceId] = result.value
+                    }
+                    promise?.resolve(result.value.toWritableMap())
+                }
+                is KlarnaResult.Failure -> promise?.reject(result.error.name, result.error.message)
+            }
+        }
+    }
+
+    fun presentationHandleLink(instanceId: String, url: String, promise: Promise?) {
+        val sdk = KlarnaNetworkCoreModuleImpl.getInstance(instanceId) ?: run {
+            promise?.reject(NAME, ERROR_INSTANCE_NOT_FOUND)
+            return
+        }
+        val activity = reactContext.currentActivity ?: run {
+            promise?.reject(NAME, ERROR_ACTIVITY_NOT_FOUND)
+            return
+        }
+        val content = storedPresentationContent[instanceId] ?: run {
+            promise?.reject(NAME, ERROR_NO_PRESENTATION_CONTENT)
+            return
+        }
+        // handleLink opens a browser/web flow and must run on the main thread.
+        Handler(Looper.getMainLooper()).post {
+            sdk.payment.presentation.handleLink(activity = activity, content = content, url = url) { result ->
+                when (result) {
+                    is KlarnaResult.Success -> {
+                        if (KlarnaNetworkCoreModuleImpl.getInstance(instanceId) != null) {
+                            storedPresentationContent[instanceId] = result.value
+                        }
+                        promise?.resolve(result.value.toWritableMap())
+                    }
+                    is KlarnaResult.Failure -> promise?.reject(result.error.name, result.error.message)
+                }
+            }
+        }
+    }
+
+    fun dispose(instanceId: String, promise: Promise?) {
+        storedPresentationContent.remove(instanceId)
+        promise?.resolve(null)
+    }
+}

package/android/src/main/java/com/klarna/mobile/sdk/reactnative/klarnanetwork/payment/KlarnaNetworkPaymentPackage.kt

@@ -0,0 +1,30 @@
+package com.klarna.mobile.sdk.reactnative.klarnanetwork.payment
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.facebook.react.uimanager.ViewManager
+import java.util.HashMap
+
+class KlarnaNetworkPaymentPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? =
+    if (name == KlarnaNetworkPaymentModule.NAME) KlarnaNetworkPaymentModule(reactContext) else null
+
+  override fun getReactModuleInfoProvider() = ReactModuleInfoProvider {
+    mapOf(
+      KlarnaNetworkPaymentModule.NAME to ReactModuleInfo(
+        name = KlarnaNetworkPaymentModule.NAME,
+        className = KlarnaNetworkPaymentModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true
+      )
+    )
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> =
+    listOf(KlarnaPaymentButtonViewManager())
+}

package/android/src/main/java/com/klarna/mobile/sdk/reactnative/klarnanetwork/payment/KlarnaPaymentButtonPressEvent.kt

@@ -0,0 +1,19 @@
+package com.klarna.mobile.sdk.reactnative.klarnanetwork.payment
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+internal class KlarnaPaymentButtonPressEvent(surfaceId: Int, viewId: Int) :
+    Event<KlarnaPaymentButtonPressEvent>(surfaceId, viewId) {
+
+    override fun getEventName(): String = EVENT_NAME
+
+    override fun canCoalesce(): Boolean = false
+
+    override fun getEventData(): WritableMap = Arguments.createMap()
+
+    companion object {
+        const val EVENT_NAME = "topButtonPress"
+    }
+}