whagency/finova-pay-php-sdk

Finova Pay SDK

v1.0.0 2026-04-01 10:47 UTC

Requires

• php: >=8.0

MIT

• Finova

• payment
• checkout
• pay
• sdk
• finova

README

A PHP SDK for interacting with the Finova Pay API.

Installation

The preferred way to install this package is via composer.

Either run

composer require whagency/finova-pay-php-sdk

or add to your composer.json file

"require": {
    "whagency/finova-pay-php-sdk": "^1.0"
},

Configuration

You need API credentials to use this SDK:

• API Public Key
• API Private Key

You can obtain them from your Finova merchant dashboard.

Examples

use Finova\Pay\FinovaPay;

$client = new FinovaPay('API_PUBLIC_KEY', 'API_PRIVATE_KEY');

// Create a new merchant order
$response = $client->createOrder([
    'externalOrderId' => '51',
    'assetCode' => 'USDT',
    'amount' => '125.50',
    'title' => 'Demo order',
    'description' => 'Order created from PHP SDK',
    'expiresInSeconds' => 900,
    'successUrl' => 'https://merchant.example/success',
    'pendingUrl' => 'https://merchant.example/pending',
    'failUrl' => 'https://merchant.example/fail',
]);

// Get an existing order by ID
$response = $client->getOrder('MERCHANT_ORDER_ID');

License

This project is licensed under the MIT License.