transfi/payment-sdk

TransFi Payment API SDK for PHP

Maintainers

Package info

github.com/Trans-Fi/transfi-chekout-php-sdk

pkg:composer/transfi/payment-sdk

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.0.0 2026-04-20 11:55 UTC

Requires

MIT e2b8dbb0be8c99506f3f49a6dc5d95d26727ed21

apipaymentcheckoutsdktransfi

This package is not auto-updated.

Last update: 2026-04-21 10:45:52 UTC

README

PHP SDK for the TransFi Payment API.

Installation

composer require transfi/payment-sdk

Quick start

<?php

require_once __DIR__ . '/vendor/autoload.php';

use TransFi\TransFiPaymentAPI;
use TransFi\TransFiError;
use TransFi\PaymentInvoiceRequest;
use TransFi\Individual;
use TransFi\ProductDetails;

$api = new TransFiPaymentAPI([
    'publicKey' => 'YOUR_PUBLIC_KEY',
    'secretKey' => 'YOUR_SECRET_KEY',
]);

$product = new ProductDetails('Premium Plan');
$product->description = 'Monthly subscription';

$individual = new Individual('John', 'Doe', 'john@example.com');
$individual->phone     = '1234567890';
$individual->phoneCode = '+1';
$individual->country   = 'US';

$paymentData = new PaymentInvoiceRequest(
    'LINK_ID',
    '100',
    'USD',
    'https://example.com/success',
    'https://example.com/failure'
);
$paymentData->productDetails  = $product;
$paymentData->individual      = $individual;
$paymentData->customerOrderId = 'order-001';

try {
    $paymentUrl = $api->createPaymentInvoice($paymentData);
    echo 'Checkout URL: ' . $paymentUrl . PHP_EOL;
} catch (TransFiError $e) {
    echo 'API Error   : ' . $e->getMessage() . PHP_EOL;
    echo 'Status Code : ' . $e->getStatusCode() . PHP_EOL;
    echo 'Response    : ' . json_encode($e->getResponseData(), JSON_PRETTY_PRINT) . PHP_EOL;
}

You can also pass a plain array instead of PaymentInvoiceRequest (keys match the JSON API: camelCase):

$paymentUrl = $api->createPaymentInvoice([
    'paymentLinkId'      => 'LINK_ID',
    'amount'             => '100',
    'currency'           => 'USD',
    'productDetails'     => [
        'name'        => 'Premium Plan',
        'description' => 'Monthly subscription',
    ],
    'individual'         => [
        'firstName' => 'John',
        'lastName'  => 'Doe',
        'email'     => 'john@example.com',
        'phone'     => '1234567890',
        'phoneCode' => '+1',
        'country'   => 'US',
    ],
    'successRedirectUrl' => 'https://example.com/success',
    'failureRedirectUrl' => 'https://example.com/failure',
    'customerOrderId'    => 'order-001',
]);

Types reference

PHP class Properties
PaymentInvoiceRequest paymentLinkId, amount, currency, successRedirectUrl, failureRedirectUrl, optional productDetails, individual, customerOrderId
ProductDetails name, optional description, imageUrl
Individual firstName, lastName, email, optional phone, phoneCode, country, address
Address optional city, state, street, postalCode