Quick Start Guide

Install NPM Package

Add the dependency to your project.

npm i @tapayadot/accept-react-native@1.1.0

Register the plugin in your app.json.

"plugins": [
    [
        "@tapayadot/accept-react-native"
    ]
]

Initialize Plugin

Pass true to initialize for the demo/testing environment.

// set true for testing environment
await AcceptSDK.initialize(true)

Authenticate Merchant

Obtain a merchant token from your backend and authenticate.

const merchantToken = await myBackend.login()
await AcceptSDK.authenticate(merchantToken)

Execute Merchant Onboarding

Before any transactions are allowed, the merchant needs to finish onboarding. Tapaya Accept SDK is configured to comply with the regulatory requirements of payment processors, banks, and regional laws.

Tapaya Accept SDK offers two ways to execute onboarding of merchant accounts:

• Express Mode: The onboarding flow is prompted from your app, and information is collected inside the Tapaya Accept SDK UI.
• API Mode: Allows you full flexibility of data collection, and only Terms & Conditions are agreed to inside the Tapaya Accept SDK UI.

Merchants must be onboarded before processing transactions. Call presentKyb() to launch the SDK's onboarding UI. You can optionally prefill known business data to reduce friction.

import AcceptSDK, { KybPrefillData } from '@tapayadot/accept-react-native';

// Launch onboarding UI
await AcceptSDK.identity.presentKyb()

// Optionally prefill known fields
const prefill: KybPrefillData = {
    businessType: 'company',
    countryCode: 'CZ',
    legalName: 'My Company s.r.o.',
    registrationNumber: '12345678',
}
await AcceptSDK.identity.presentKyb(prefill)

Create Payment Transaction

To execute a transaction, call one of the payment methods on AcceptSDK.payments. Provide your own paymentIntentId as a unique identifier. Status updates arrive via the statusCallback and errors via errorCallback.

const paymentIntent: CardPaymentIntent = {
    paymentIntentId: Crypto.randomUUID(),
    amount: 15000, // 150.00 Kč
    requestedCurrency: 'CZK',
};

const result = await AcceptSDK.payments.startCardPayment(
    paymentIntent,
    (s) => {
        console.log(s);
    },
    (m, e) => {
        console.log(m + ": " + e);
    }
);

console.log(result);

Add Tapaya Accept SDK

In Xcode, go to File → Add Package Dependencies and enter the repository URL. Add the AcceptSDK product to your target.

dependencies: [
    .package(url: "https://github.com/tapayadot/accept-ios.git", from: "1.1.2")
],
targets: [
    .target(name: "MyApp", dependencies: [
        .product(name: "AcceptSDK", package: "accept-ios")
    ])
]

Configure Info.plist

Add two entries to your app's Info.plist.

The first allows the SDK to detect the Tapaya Accept companion app. The second registers your app's callback URL scheme for deep link returns (replace myapp with your scheme).

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>tapaya-accept</string>
</array>
<key>AcceptCallbackScheme</key>
<string>myapp</string>

Then forward inbound URLs to the SDK:

.onOpenURL { url in
    Accept.handle(url: url)
}

Initialize SDK

Call initialize() once at app launch before using any other SDK method.

try await Accept.initialize(demo: true) // false in production

Authenticate Merchant

Obtain a merchant token from your backend and authenticate.

let merchantToken = myBackend.login()
try await Accept.authenticate(merchantToken: merchantToken)

Pair Companion App

The Tapaya Accept companion app is required for card payments. Check if it is installed and pair, or show the App Store install sheet.

if await Accept.isCompanionAppInstalled() {
    try await Accept.pairWithCompanionApp()
} else {
    try await Accept.presentCompanionAppSheet()
}

Execute Merchant Onboarding

Before any transactions are allowed, the merchant needs to complete KYB (Know Your Business) onboarding. The SDK presents a guided form that collects and submits the required information.

let result = try await Accept.presentKyb()

switch result {
case .submitted:
    // KYB form submitted — await processor approval
case .cancelled:
    // Merchant dismissed without submitting
case .failed:
    // Submission failed
}

You can prefill known fields to reduce friction:

let prefill = KybPrefillData(
    businessType: .company,
    countryCode: "CZ",
    legalName: "My Company s.r.o."
)
let result = try await Accept.presentKyb(prefilling: prefill)

Create Payment Transaction

Request location permission, then call Accept.pay(_:) with the appropriate intent. All amounts are in the smallest currency unit (e.g. 1000 = 10.00 CZK).

try await Accept.requestLocationPermission()

let intent = AcceptCardPaymentIntent(
    amount: 15000, // 150.00 CZK
    requestedCurrency: .czk,
    settlementCurrency: .czk
)

let outcome = try await Accept.pay(intent)

switch outcome {
case .completed(let status):
    print("Paid: \(status.paymentToken), status: \(status.status)")
case .canceled:
    print("User cancelled")
}