Integration

---

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 quick look at the integration flow:

1. Obtain your API Key from the Fliz app.
2. Authenticate your app to receive a JWT token.
3. Use the JWT token to securely initiate payments through the SDK.

Step 1: Get Your API Key

1. Sign up on the FLIZ app.
2. Go to Installations → SDK Integration.
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.

Request

POST https://api.flizpay.de/auth/verify-apikey

Request Body Parameters

Parameter	Type	Description	Required
email	String	User's email address	✅
iban	String	IBAN of your user (optional)	❌

Required Header

X-API-Key: YOUR_API_KEY

Example Request

curl --request POST \
     --url https://api.flizpay.de/auth/verify-apikey \
     --header 'X-API-Key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{"email": "user@example.com", "iban": "DE02120300000000202051"}'

Example Response

{
  "token": "JWT_TOKEN"
}

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);

Parameters Explained

Parameter	Type	Description	Required
amount	String	Amount of money the user is paying	✅
token	String	JWT token obtained from the authentication step	✅

Example

Initiate a payment of €49.99 like this:

const amount = "49.99";
const jwtToken = "YOUR_JWT_TOKEN";

FlizpaySDK.initiatePayment(amount, jwtToken);

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

Support

Need assistance? Reach out to FLIZ Support.