Kloutit SDK

Kloutit is an AI-powered B2B SaaS that enables online merchants to effectively and efficiently defend and prevent chargebacks.

This SDK allows your organization to integrate with Kloutit, so your cases could be automatically created into our system to take profit of all the following profits.

Installation

To install Kloutit SDK you can run the following composer command.

composer require kloutit/kloutit-sdk-php

Prerequisites

To be able to use any Kloutit SDK function, your organization must be registered into our system and SDK client keys for the organization must be created. You can register your organization by following a few simple steps from https://app.kloutit.com.

Once your organization is successfully registered, you will be able to configure the SDK connection from the menu My organization > Kloutit SDK. You will need to create new client credentials.

Usage

To use the Kloutit SDK client, you will need to instantiate the KloutitLoginApi to obtain a valid accessToken (expires at 30m, then you can generate a new one). With this accessToken you will be able to instantiate the rest of the available APIs and make your actions.

Sample code Login

<?php
// Require composer autoloader
require 'vendor/autoload.php';

use Kloutit\Configuration as KloutitConfiguration;
use Kloutit\Api\KloutitLoginApi;
use Kloutit\Model\KloutitLoginBody;

$clientId = '22311cca-9951-42dd-bc9b-bd0574335b55';
$clientSecret = '6#.n3dcm-x4hc3Y0SrA/UR?DzggfM;';
$organizationId = '660055bca25e9c2da9b87944';

// If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
// This is optional, `GuzzleHttp\Client` will be used as default.
$client = new GuzzleHttp\Client();

// Configure Login http basic authorization
$loginConfig = KloutitConfiguration::getDefaultConfiguration()
              ->setUsername($clientId)
              ->setPassword($clientSecret);

$kloutitLogin = new KloutitLoginApi(
    $client,
    $loginConfig
);
$kloutitLoginBody = new KloutitLoginBody([
    'grant_type' => 'client_credentials'
]);

$accessToken;
$expiresIn;
$expiresAt;

// Login
try {
    echo "Getting Kloutit access token for organization $organizationId\n";
    $loginResponse = $kloutitLogin->login($organizationId, $kloutitLoginBody);

    $accessToken = $loginResponse->getAccessToken();
    $expiresAt = $loginResponse->getExpiresAt();
    $expiresIn = $loginResponse->getExpiresIn();

    echo "Access token successfully retrieved!\n";
} catch (Exception $e) {
    echo "Error trying to login to Kloutit SDK.\n";
    throw new Exception($e->getMessage());
}

Sample code other calls

Once you have the accessToken with the Login call, you can use it to make other calls, for instance, to create a case.

<?php
// Require composer autoloader
require 'vendor/autoload.php';

use Kloutit\Configuration as KloutitConfiguration;
use Kloutit\Api\KloutitCaseApi;
use Kloutit\Model\KloutitCaseBody;
use Kloutit\KloutitChargebackReason;
use Kloutit\KloutitOrganizationType;
use Kloutit\Currencies;

// Configure Bearer (JWT) authorization: bearer
$caseConfig = KloutitConfiguration::getDefaultConfiguration()->setAccessToken($accessToken);

$kloutitCase = new KloutitCaseApi(
    $client,
    $caseConfig
);
$kloutitCaseBody = new KloutitCaseBody([
    'organization_id' => $organizationId,
    'organization_type' => KloutitOrganizationType::TECHNOLOGY,
    'expedient_number' => 'EXPPHP0001',
    'notification_date' => '2024-09-22T11:31:22.347Z',
    'deadline' => '2027-09-22T11:31:22.347Z',
    'dispute_amount' => [
        'currency' => Currencies::EUR,
        'value' => 10,
    ],
    'chargeback_reason' => KloutitChargebackReason::PRODUCT_SERVICE_NOT_RECEIVED,
    'transaction_date' => '2024-09-22T11:31:22.347Z',
    'pan_number' => 'PAN000001',
    'transaction_id' => 'TR0000001',
    'bank_name' => 'Sample bank',
    'is3_ds_purchase' => true,
    'purchase_date' => '2024-09-22T11:31:22.347Z',
    'purchase_amount' => [
        'currency' => Currencies::EUR,
        'value' => 10,
    ],

    'product' => 'Sample product', // Product OR service should be informed
    'service' => null, // Product OR service should be informed
    'is_charge_refundable' => true,
    'shipping_city' => 'Barcelona',
    'shipping_province' => 'Barcelona',
    'shipping_postal_code' => '08000',
    'shipping_date' => '2024-09-22T11:31:22.347Z',
    'delivery_company' => 'Sample company',
    'delivery_date' => '2024-09-22T11:31:22.347Z',
    'delivery_confirmation' => true,

    'customer_name' => 'PHP SDK sample',
    'customer_email' => 'kloutit-php@example.com',
    'contact_date' => '2024-09-22T11:31:22.347Z',
    'customer_phone' => '612345678',
    'additional_info' => 'Some optional additional info',
]);

try {
    $kloutitCase->createCase($kloutitCaseBody);
    echo "Case successfully created into Kloutit!\n";
} catch (Exception $e) {
    echo "Error trying to create case into Kloutit.\n";
    throw new Exception($e->getMessage());
}

This example is made for TECHNOLOGY sector. You can find the needed body for each sector here:

• Education
• Fashion
• Food
• Gaming
• Health & beauty
• Home
• Leisure
• Phone
• Software
• Sport
• Supply
• Technology
• Travel Airline
• Travel Hotel

Documentation

In this document, you will be able to see all the available methods and all the parameters needed, so you know exactly what you need to do. If you have any doubts, please, don't hesitate to contact us so we can help you, or leave us any comment so we can improve your experience.

Autocompletion

If you use an IDE such as VSCode, you will be able to see all the autocompletion for methods and parameters, so you know exactly what the call is expecting to receive.

Security

Kloutit SDK does not store or refresh access tokens. Storing and refreshing access tokens is responsibility of the SDK consumer.

Please, if you discover any security issues, report them to support@kloutit.com as soon as possible.

License

Apache 2.0