SDK

---

Overview

Welcome to FLIZ! This guide will help you integrate FLIZ Mobile SDK into your app to securely accept and process payments. FLIZ handles everything within an easy-to-use in-app webview, creating a seamless payment experience for your users.

Here's a video of how our webview looks within the app of one of our clients:

Step 1: Get Your API Key

1. Sign up on the FLIZ app.
2. Go to Installations → App SDK.
3. Generate and copy your API Key.

⚠️ Important: Securely store your API Key for authentication purposes.

Step 2: Set up your webhook

Add your callback URL in FLIZ app under the webhook section, and copy and save the one-time Webhook Secret. If you want to learn more about how we use webhooks go to our Webhooks guide.

Step 3: Authenticate Your App

Authenticate your app to receive a JWT token necessary for secure transactions. Please review our Authentication guide to learn more about how to authenticate with Fliz.

Step 4: Add FLIZ SDK to Your App

Now it's time to add the FLIZ SDK to your project. Follow platform-specific installation instructions:

Installation

• Android: Add the FLIZ SDK with Gradle or Maven. GitHub repository
• iOS: Install via CocoaPods or SwiftPM. GitHub repository

Initiate Payments

Once the SDK is integrated, use the initiatePayment method to start the payment flow:

FlizpaySDK.initiatePayment(amount, token, metadata, urlScheme);

Parameters Explained

Parameter	Type	Description	Required
amount	String	Amount of money the user is paying	✅
token	String	JWT token obtained from the authentication step	✅
metadata	Object	Custom key-value pairs (e.g. user IDs) to enrich or track a transaction	❌
urlScheme	String	Your app's custom URL scheme for redirecting users back to the app after a transaction	❌

Example

Initiate a payment of €49.99 like this:

const amount = "49.99";
const jwtToken = "YOUR_JWT_TOKEN";
const metadata = {
    "order_id": "ORD-8721",
    "customer_tier": "gold",
    "campaign": "spring-sale"
  }
const urlScheme = "myapp://"

FlizpaySDK.initiatePayment(amount, jwtToken, metadata, urlScheme);

Congratulations! Your app is now configured to securely process payments through FLIZ.

Support

Need assistance? Reach out to FLIZ Support.