README

Payment service provider

A payment service provider (PSP) offers shops online services for accepting electronic payments by a variety of payment methods including credit card, bank-based payments such as direct debit, bank transfer, and real-time bank transfer based on online banking. Typically, they use a software as a service model and form a single payment gateway for their clients (merchants) to multiple payment methods. read more

Installation

This SDK uses composer.

Composer is a tool for dependency management in PHP. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you.

For more information on how to use/install composer, please visit https://github.com/composer/composer

Composer installation

composer require flittpayments/php-sdk

Manual installation

git clone https://github.com/flittpayments/php-sdk.git

<?php
require '/path-to-sdk/autoload.php';

Version 2.0 removed legacy XML content-type support - only json and form request types are supported now. See CHANGELOG.md for details.

Simple Start

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

Get order status

$orderData = \Flitt\Order::status(['order_id' => $order_id]);
$order = $orderData->getData();
echo $order['order_status']; // e.g. 'approved', 'declined', 'processing'
$orderData->isValid();       // verifies the response signature

See examples/Order/status.php for a full example, and docs.flitt.com/api/order-status for the API reference.

IBAN withdrawal

\Flitt\Configuration::setCreditKey('testcredit'); // payout requests use the credit key, not the secret key
$data = \Flitt\IbanCredit::credit([
    'currency' => 'GEL',
    'amount' => 1000,
    'receiver_iban' => 'GE00TB0000000000000003'
]);

See examples/IbanCredit/credit.php and docs.flitt.com/api/create-order-ibancredit.

P2P credit (card payout) using a rectoken

A payout can target a card that was previously used for a purchase, by using the rectoken obtained from that purchase instead of a raw receiver_card_number:

\Flitt\Configuration::setSecretKey('test');
$purchase = \Flitt\Pcidss::start([
    'currency' => 'GEL',
    'amount' => 1000,
    'client_ip' => '127.2.2.1',
    'card_number' => '4444555511116666',
    'cvv2' => '333',
    'expiry_date' => '1222',
    'required_rectoken' => 'Y'
]);
$rectoken = $purchase->getData()['rectoken'];

\Flitt\Configuration::setCreditKey('testcredit'); // payout requests use the credit key, not the secret key
$data = \Flitt\P2pcredit::start([
    'currency' => 'GEL',
    'amount' => 500,
    'receiver_rectoken' => $rectoken
]);

See examples/P2pcredit/p2pcredit_rectoken.php and docs.flitt.com/api/create-order-p2pcredit.

Company reports

Reports authenticate with a merchant-specific application_id and application private key — not the merchant_id/secret_key used everywhere else in this SDK. For your own reports, contact Flitt support to obtain your own application_id/key. A shared sandbox reports application (application_id: '1019', key 'test', merchant 1549902) is used by tests/CompanyReportsTest.php to cover this endpoint end-to-end.

\Flitt\Configuration::setReportsApplicationId('%your_application_id%');
\Flitt\Configuration::setReportsApplicationKey('%your_application_private_key%');

$reports = \Flitt\CompanyReports::get([
    'report_id' => 745, // see the report list at docs.flitt.com/api/reports/
    'on_page' => 10,
    'page' => 1,
    'filters' => [
        ['s' => 'order_timestart_from', 'm' => 'dateis', 'v' => '2026-08-01'],
        ['s' => 'order_timestart_to', 'm' => 'dateis', 'v' => '2026-08-31'],
    ]
]);

See examples/CompanyReports/report.php and docs.flitt.com/api/reports.

Payment::reports() still works as a deprecated alias for CompanyReports::get().

Open Banking / Installments deeplinks

$data = \Flitt\Checkout::deeplink([
    'currency' => 'GEL',
    'amount' => 1000,
    'payment_systems' => 'opb',      // or 'installments'
    'payment_method' => 'tbc'        // a single bank; 'x' is the sandbox Demo Bank
]);
$deeplinkUrl = $data->getUrl();

See examples/Checkout/deeplink.php and docs.flitt.com/api/bank-app-deeplinks.

Api

See php-docs

Examples

To check it you can use build-in php server

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

Checkout examples

Author

Flitt

flittpayments / php-sdk

Maintainers

Package info

Statistics

Security