Flitt

https://docs.flitt.com
Admin
Flitt is a payment gateway API platform that enables merchants to process payments through multiple...
Tokens:153,343
Snippets:794
Trust Score:7.2
Update:1 week ago
Show doc for...
Tokens:
Raw
### Run PHP SDK example server

Source: https://docs.flitt.com/api/create-order

Command to start a local PHP server for the SDK example.

```bash
cd ~/php-sdk
php -S localhost:8000
```

--------------------------------

### Clone and install iOS SDK example

Source: https://docs.flitt.com/api/mobile/apple-ios-swift

Commands to clone the iOS SDK repository and install CocoaPods dependencies for the example app.

```bash
git clone git@github.com:flittpayments/ios-sdk.git
cd ios-sdk/Example
pod install

```

--------------------------------

### Alternative setup using npm

Source: https://docs.flitt.com/sdk-and-mobile/sdk/wallets

Instead of the CDN script tag, you can install the SDK via npm and import it. This is the alternative to the basic HTML setup.

```bash
npm i @flittpayments/js-sdk
```

```javascript
import $checkout from "@flittpayments/js-sdk";
```

--------------------------------

### Start subscription response (JSON)

Source: https://docs.flitt.com/api/cancel-subscriptions

Example response for a successful start request. Shows response_status 'success' and status 'active'.

```json
{
    "response": {
        "response_status": "success",
        "merchant_id": 1549901,
        "order_id": "test_subscription11",
        "status": "active",
        "signature": "a7adf395dae783a4676abbafe7f2479b2f6cfbca"
    }
}

```

--------------------------------

### Run local PHP server for example

Source: https://docs.flitt.com/sdk-and-mobile/sdk/php

Start a local PHP development server on port 8000 from the php-sdk directory to test the checkout example.

```bash
cd ~/php-sdk
php -S localhost:8000

```

--------------------------------

### Complete MainActivity example

Source: https://docs.flitt.com/api/mobile/googlepay-android

A complete example of MainActivity implementing Google Pay integration, including UI setup, support check, and state restoration.

```kotlin
package com.example.cloudipspAndroidSdkExampleKotlin

import android.content.Intent
import android.os.Bundle
import android.view.View
import android.widget.Button
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import com.flittpayments.android.Cloudipsp
import com.flittpayments.android.CloudipspWebView
import com.flittpayments.android.GooglePayCall
import com.flittpayments.android.Order
import com.flittpayments.android.Receipt

class MainActivity : AppCompatActivity(), View.OnClickListener, Cloudipsp.PayCallback, Cloudipsp.GooglePayCallback {

    private val RC_GOOGLE_PAY = 100500
    private val K_GOOGLE_PAY_CALL = "google_pay_call"
    private var cloudipsp: Cloudipsp? = null
    private var googlePayCall: GooglePayCall? = null // <- this should be serialized on saving instance state
    private lateinit var webView: CloudipspWebView
    private lateinit var googlePayButton: Button

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main) // Set the layout for this activity

        // Initialize UI elements
        webView = findViewById(R.id.webView) // Initialize CloudipspWebView from layout
        googlePayButton = findViewById(R.id.google_pay_button) // Initialize Button from layout
        googlePayButton.setOnClickListener(this) // Set click listener for Google Pay button

        // Check if Google Pay is supported and set button visibility accordingly
        if (Cloudipsp.supportsGooglePay(this)) {
            googlePayButton.visibility = View.VISIBLE // Show Google Pay button
        } else {
            googlePayButton.visibility = View.GONE // Hide Google Pay button if unsupported
            Toast.makeText(this, R.string.e_google_pay_unsupported, Toast.LENGTH_LONG).show() // Show unsupported message
        }
        if (savedInstanceState != null) {
            googlePayCall = savedInstanceState.getParcelable(K_GOOGLE_PAY_CALL)
        }
    }

```

--------------------------------

### Simple Start - Create checkout URL

Source: https://docs.flitt.com/sdk-and-mobile/sdk/php

Initialize the SDK with merchant ID and secret key, then create a checkout URL for a payment. The example sets currency to GEL and amount to 1000. The resulting URL can be used to redirect the customer to checkout.

```php
require 'vendor/autoload.php';
\Flitt\Configuration::setMerchantId(1549901);
\Flitt\Configuration::setSecretKey('test');

$checkoutData = [
    'currency' => 'GEL',
    'amount' => 1000
];
$data = \Flitt\Checkout::url($checkoutData);
$url = $data->getUrl();
//$data->toCheckout() - redirect to checkout

```

--------------------------------

### Complete MainActivity example (Java)

Source: https://docs.flitt.com/api/mobile/googlepay-android

A complete example of MainActivity code in Java, including imports and class definition. This is the full example provided in the documentation.

```java
package com.example.cloudipspAndroidSdkExampleJava;

import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;

import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;

import com.flittpayments.android.Cloudipsp;
import com.flittpayments.android.CloudipspWebView;
import com.flittpayments.android.GooglePayCall;
import com.flittpayments.android.Order;
import com.flittpayments.android.Receipt;

```

--------------------------------

### Install Python SDK with pip

Source: https://docs.flitt.com/sdk-and-mobile/sdk/python

Install the flittpayments package using pip.

```bash
pip install flittpayments

```

--------------------------------

### C# Redirect Checkout Example

Source: https://docs.flitt.com/getting-started/redirect

Use this C# example to create a checkout request and get the checkout URL using the CloudIpspSDK. It sets the merchant ID and secret key, builds a CheckoutRequest, posts it, and retrieves the checkout URL if no error occurs.

```C#
using CloudIpspSDK;
using CloudIpspSDK.Checkout;

Config.MerchantId = 1549901;
Config.SecretKey = "test";

var req = new CheckoutRequest {
  order_id = Guid.NewGuid().ToString("N"),
  amount = 100000,
  order_desc = "checkout json demo",
  currency = "GEL"
};
var resp = new Url().Post(req);
if (resp.Error == null) {
 string url = resp.checkout_url;
}
```

--------------------------------

### Composer installation

Source: https://docs.flitt.com/sdk-and-mobile/sdk/php

Install the PHP SDK using Composer with the command 'composer require flittpayments/php-sdk'.

```bash
composer require flittpayments/php-sdk

```

--------------------------------

### Clone and install Flitt Integration Skill

Source: https://docs.flitt.com/ai

Clones the repository and runs the install script from within the cloned directory. The script installs into the parent project directory when run from inside the repository.

```bash
git clone https://github.com/flittpayments/flitt-integration-skill.git
cd flitt-integration-skill
chmod +x install.sh
./install.sh

```

--------------------------------

### Basic HTML setup for payment button

Source: https://docs.flitt.com/sdk-and-mobile/sdk/wallets

Include the Flitt JS SDK via CDN and add a container div for the payment button. This is the HTML part of the basic example.

```html
<script src='https://cdn.jsdelivr.net/npm/@flittpayments/js-sdk/dist/umd/checkout.js'></script>
<div class='payment-button-container'></div>
```

--------------------------------

### Node.js SDK installation via npm

Source: https://docs.flitt.com/api/create-order

Installs the Flitt Node.js SDK using npm.

```bash
npm install @flittpayments/flitt-node-js-sdk
```

--------------------------------

### Python SDK installation via pip

Source: https://docs.flitt.com/api/create-order

Installs the Flitt Python SDK using pip.

```bash
pip install flittpayments
```

--------------------------------

### Install @flittpayments/js-sdk via npm

Source: https://docs.flitt.com/api/create-order

Command to install the Flitt JavaScript SDK using npm.

```bash
npm i --save @flittpayments/js-sdk
```

--------------------------------

### Composer installation for PHP SDK

Source: https://docs.flitt.com/api/create-order

Command to install the Flitt PHP SDK via Composer.

```bash
composer require flittpayments/php-sdk
```

--------------------------------

### Node.js SDK manual installation via git clone

Source: https://docs.flitt.com/api/create-order

Clones the Flitt Node.js SDK repository from GitHub for manual installation.

```bash
git clone -b master https://github.com/flittpayments/node-js-sdk.git
```

--------------------------------

### Install Flitt Integration Skill into a specific project

Source: https://docs.flitt.com/ai

Installs the skill into a specified project directory using the --target flag.

```bash
./install.sh --target /path/to/your/project

```

--------------------------------

### Manual installation via git clone

Source: https://docs.flitt.com/sdk-and-mobile/sdk/php

Clone the PHP SDK repository from GitHub using the master branch.

```bash
git clone -b master https://github.com/flittpayments/php-sdk.git

```

--------------------------------

### curl request to /api/3dsecure_step1

Source: https://docs.flitt.com/api/create-order-direct

Example POST request to start 3D-Secure authentication. Sends order details and card data in JSON format. The signature must be generated as per Flitt documentation.

```bash
curl -i -X POST \
-H "Content-Type:application/json" \
-d \
'
{
  "request": {
    "order_id": "test_12343242",
    "merchant_id": "1549901",
    "order_desc": "Test order",
    "amount": 1000,
    "currency": "GEL",
    "card_number": "4444555566661111",
    "cvv2": "111",
    "expiry_date": "1125",
    "client_ip": "8.8.8.8",
    "server_callback_url": "https://myserver.com/callback",
    "signature": "0c0c2374c73267e7be560d80834e4ba28ccda7aa"
  }
}
' \
'https://pay.flitt.com/api/3dsecure_step1'
```

--------------------------------

### Set up CloudipspWebView and state

Source: https://docs.flitt.com/api/mobile/googlepay-reactnative

Import CloudipspWebView and set up state and ref for the payment WebView.

```javascript
import { CloudipspWebView } from '@flittpayments/react-native-flitt';

       // State to manage the visibility of the WebView
const [webView, setWebView] = useState(0);

// Reference to the Cloudipsp WebView component
const _cloudipspWebViewRef = useRef<CloudipspWebView>(null);
```

--------------------------------

### Simple start: create checkout URL

Source: https://docs.flitt.com/sdk-and-mobile/sdk/python

Initialize the API with merchant credentials and create a checkout object to generate a payment URL.

```python
from flittpayments import Api, Checkout
api = Api(merchant_id=1549901,
          secret_key='test')
checkout = Checkout(api=api)
data = {
    "currency": "USD",
    "amount": 10000
}
url = checkout.url(data).get('checkout_url')

```

--------------------------------

### Order status response (JSON)

Source: https://docs.flitt.com/api/get-reversal-status

Example response from the Get order status request for a partially reversed order. The reversal_amount field is highlighted and is less than the actual_amount, indicating that the order was partially reversed.

```json
{
    "response": {
        "rrn": "111111111111",
        "masked_card": "444455XXXXXX6666",
        "sender_cell_phone": "",
        "sender_account": "",
        "currency": "GEL",
        "fee": "",
        "reversal_amount": "48",
        "actual_amount": "15118",
        "settlement_amount": "0",
        "response_description": "",
        "sender_email": "",
        "order_status": "approved",
        "response_status": "success",
        "order_time": "28.08.2024 21:20:02",
        "actual_currency": "GEL",
        "order_id": "test_12343242111",
        "tran_type": "purchase",
        "eci": "7",
        "settlement_date": "",
        "payment_system": "card",
        "approval_code": "123456",
        "merchant_id": 1549901,
        "settlement_currency": "",
        "payment_id": 814277784,
        "card_bin": 444455,
        "response_code": "",
        "card_type": "VISA",
        "amount": "1000",
        "signature": "8c06dd297c43833ded498b342a6225423f8494b3",
        "product_id": "",
        "merchant_data": "",
        "rectoken": "",
        "rectoken_lifetime": "",
        "verification_status": "",
        "parent_order_id": "",
        "fee_oplata": "0",
        "additional_info": "{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": null, \"transaction_id\": 2011273408, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"28.08.2024 21:20:05\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"is_test\": true}",
        "response_signature_string": "**********|15118|GEL|{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": null, \"transaction_id\": 2011273408, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"28.08.2024 21:20:05\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"is_**********\": true}|1000|123456|444455|VISA|GEL|7|0|444455XXXXXX6666|1549901|**********_12343242111|approved|28.08.2024 21:20:02|814277784|card|success|48|111111111111|0|purchase"
    }
}

```

--------------------------------

### Manual installation for PHP SDK

Source: https://docs.flitt.com/api/create-order

Command to clone the Flitt PHP SDK repository from GitHub.

```bash
git clone -b master https://github.com/flittpayments/php-sdk.git
```

--------------------------------

### Install Flitt Integration Skill for specific tools

Source: https://docs.flitt.com/ai

Installs the skill for a specific AI coding tool using the --tools flag. Each command targets one tool, and the final command installs for all tools.

```bash
./install.sh --target /path/to/your/project --tools codex
./install.sh --target /path/to/your/project --tools copilot
./install.sh --target /path/to/your/project --tools claude
./install.sh --target /path/to/your/project --tools gemini
./install.sh --target /path/to/your/project --tools cursor
./install.sh --target /path/to/your/project --tools windsurf
./install.sh --target /path/to/your/project --tools cline
./install.sh --target /path/to/your/project --tools roo
./install.sh --target /path/to/your/project --tools openclaw
./install.sh --target /path/to/your/project --tools all

```

--------------------------------

### Setup Merchant ID and WebView (Java/Kotlin)

Source: https://docs.flitt.com/api/mobile/android

Create an instance of Cloudipsp with your Merchant ID from the Flitt Merchant Portal and attach a WebView for 3DSecure redirection.

```java
webView = findViewById(R.id.web_view);
cloudipsp = new Cloudipsp(<your merchant_id>, webView);
```

--------------------------------

### Start subscription request (curl)

Source: https://docs.flitt.com/api/cancel-subscriptions

Sends a POST request to /api/subscription with action 'start' to activate a subscription. The request includes order_id, merchant_id, and signature.

```bash
curl -L 'https://pay.flitt.com/api/subscription' \
-H 'Content-Type: application/json' \
-d '{
  "request": {
    "order_id": "test_subscription11",
    "merchant_id": 1549901,
    "action": "start",
    "signature": "a7adf395dae783a4676abbafe7f2479b2f6cfbca"
  }
}'

```

--------------------------------

### Install Flitt React Native SDK

Source: https://docs.flitt.com/api/mobile/reactnative

Install the @flittpayments/react-native-flitt package using npm or yarn.

```bash
npm install @flittpayments/react-native-flitt --save
# or
yarn add @flittpayments/react-native-flitt
```

--------------------------------

### Accept purchase request example

Source: https://docs.flitt.com/api/order-parameters

Example of a request to the Accept purchase operation, showing the required parameters such as order_id, merchant_id, amount, currency, and signature.

```json
{
  "request": {
    "version": "1.0.1",
    "order_id": "TestOrder2",
    "merchant_id": 1549901,
    "order_desc": "Test payment",
    "amount": 1000,
    "currency": "GEL",
    "response_url": "http://myshop/thank_you_page",
    "server_callback_url": "http://myshop/callback/",
    "signature": "91ea7da493a8367410fe3d7f877fb5e0ed666490"
  }
}
```

--------------------------------

### Quick start with js-sdk via CDN

Source: https://docs.flitt.com/api/create-order

HTML script tag to include the Flitt JavaScript SDK from a CDN.

```html
<script src="https://cdn.jsdelivr.net/npm/@flittpayments/js-sdk"></script>
```

--------------------------------

### Implement MainActivity with callbacks

Source: https://docs.flitt.com/api/mobile/googlepay-android

Implement the Activity.java file with the required interfaces for handling button clicks and payment callbacks.

```java
import com.flittpayments.android.Cloudipsp

Public class MainActivity extends AppCompatActivity implements
        View.OnClickListener, // Implementing OnClickListener for handling button clicks
        Cloudipsp.PayCallback, // Implementing Cloudipsp.PayCallback for payment callbacks
        Cloudipsp.GooglePayCallback { // Implementing Cloudipsp.GooglePayCallback for Google Pay callbacks

}
```
Tokens:
Raw