PHPackages                             whagency/finova-pay-php-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. whagency/finova-pay-php-sdk

ActiveLibrary[Payment Processing](/categories/payments)

whagency/finova-pay-php-sdk
===========================

Finova Pay SDK

v1.0.2(1mo ago)19↓91.7%MITPHPPHP >=8.0

Since Apr 1Pushed 1mo agoCompare

[ Source](https://github.com/whagency/finova-pay-php-sdk)[ Packagist](https://packagist.org/packages/whagency/finova-pay-php-sdk)[ Docs](https://github.com/whagency/finova-pay-php-sdk)[ RSS](/packages/whagency-finova-pay-php-sdk/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (1)DependenciesVersions (4)Used By (0)

Finova Pay SDK
==============

[](#finova-pay-sdk)

A PHP SDK for interacting with the Finova Pay API.

[![Latest Stable Version](https://camo.githubusercontent.com/e9e235084a698bff29e1cf5b84d346697aaf0500fd18229f59a5efd9b09017cc/68747470733a2f2f706f7365722e707567782e6f72672f77686167656e63792f66696e6f76612d7061792d7068702d73646b2f762f737461626c65)](https://packagist.org/packages/whagency/finova-pay-php-sdk)[![License](https://camo.githubusercontent.com/c216e61f1d144a88fa69c46c2f318361dbed104c3af437c41dce6267a993e73e/68747470733a2f2f706f7365722e707567782e6f72672f77686167656e63792f66696e6f76612d7061792d7068702d73646b2f6c6963656e7365)](https://packagist.org/packages/whagency/finova-pay-php-sdk)

Installation
------------

[](#installation)

The preferred way to install this package is via [composer](https://getcomposer.org/download/).

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
-------------

[](#configuration)

You need API credentials to use this SDK:

- API Public Key
- API Private Key
- API Webhook Key

You can obtain them from your Finova merchant dashboard.

Examples
--------

[](#examples)

### `Get started`

[](#get-started)

```
use Finova\Pay\FinovaPay;

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

### `Create a new merchant order`

[](#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`

[](#get-an-existing-order-by-id)

```
$response = $client->getOrder('MERCHANT_ORDER_ID');
```

### `Cancel an existing active order by ID`

[](#cancel-an-existing-active-order-by-id)

```
$response = $client->cancelOrder('MERCHANT_ORDER_ID');
```

### `Receiving a POST callback`

[](#receiving-a-post-callback)

#### Checks the validity of the received request signature

[](#checks-the-validity-of-the-received-request-signature)

```
if (FinovaPay::isValidWebhookSignature($body, $headers, 'API_WEBHOOK_KEY')) {

}
```

#### Callback BODY data example

[](#callback-body-data-example)

```
{
    "id": "17",
    "event": "payment.succeeded",
    "createdAt": "2026-05-02T09:47:16Z",
    "data": {
        "settlementReleasedAt": "2026-05-02T09:47:16Z",
        "amount": 10,
        "status": "succeeded",
        "feeAmount": 1.4285714,
        "merchantId": "3a5bcad9-dc38-4565-9286-33925351b16e",
        "occurredAt": "2026-05-02T09:47:16Z",
        "merchantOrderId": "19",
        "settlementStatus": "released",
        "settlementHoldDays": 0,
        "orderId": "23f1beae-7ab5-4ace-8df9-76f1cb9fdbc5",
        "assetCode": "USDT",
        "externalOrderId": "19",
        "settlementReleaseAt": "2026-05-02T09:47:16Z"
    }
}
```

#### Callback HEADERS data example

[](#callback-headers-data-example)

```
{
    "Content-Type": "application/json",
    "X-Webhook-Id": "17",
    "X-Webhook-Event": "payment.succeeded",
    "X-Webhook-Timestamp": "1777715236",
    "X-Webhook-Signature": "sha256=bfa9fca98b83104d284f2bfa27ab531f4ec66d073c4cab7e0afd9fcc151db601",
}
```

License
-------

[](#license)

This project is licensed under the MIT License.

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance88

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~16 days

Total

3

Last Release

59d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/40386084?v=4)[WebHeads](/maintainers/whagency)[@whagency](https://github.com/whagency)

---

Tags

sdkpaymentpaycheckoutfinova

### Embed Badge

![Health badge](/badges/whagency-finova-pay-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/whagency-finova-pay-php-sdk/health.svg)](https://phpackages.com/packages/whagency-finova-pay-php-sdk)
```

###  Alternatives

[liqpay/liqpay

SDK for Liqpay

111712.0k9](/packages/liqpay-liqpay)[lokielse/omnipay-wechatpay

Wechat gateway for Omnipay payment processing library

314225.4k7](/packages/lokielse-omnipay-wechatpay)[pixidos/gpwebpay-core

GPWepPay core php library for http api GPWebPay service

11167.6k1](/packages/pixidos-gpwebpay-core)[enupal/stripe

Allows customers sign up for recurring and one-time payments with Stripe, perfect for orders, donations, subscriptions, and events. Create simple payment forms in seconds easily without coding. For Craft CMS 3.x

3416.6k1](/packages/enupal-stripe)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)