PHPackages                             vnpost/postpay-php - 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. [API Development](/categories/api)
4. /
5. vnpost/postpay-php

ActiveLibrary[API Development](/categories/api)

vnpost/postpay-php
==================

Postpay API PHP client for multiple frameworks including Laravel

1.0.0.4(1y ago)0521Apache-2.0PHPPHP ^8.0

Since Aug 30Pushed 1y agoCompare

[ Source](https://github.com/Vietnam-Post/PostPayQR-PHP)[ Packagist](https://packagist.org/packages/vnpost/postpay-php)[ RSS](/packages/vnpost-postpay-php/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (5)Dependencies (1)Versions (6)Used By (0)

Postpay API PHP Client
======================

[](#postpay-api-php-client)

Postpay API PHP Client là một thư viện PHP dùng để tích hợp với Postpay API, cho phép bạn quản lý tài khoản chuyên thu và thực hiện các thao tác liên quan như tạo tài khoản, đóng tài khoản, truy vấn giao dịch, và xử lý callback. Thư viện này có thể sử dụng với nhiều framework PHP khác nhau, bao gồm Laravel và này nọ.

Tính năng
---------

[](#tính-năng)

- Tạo tài khoản chuyên thu
- Đóng tài khoản không sử dụng
- Xem chi tiết thông tin tài khoản
- Truy vấn giao dịch tài khoản chuyên thu
- Xử lý callback từ Postpay API
- Hỗ trợ mã lỗi và mô tả lỗi chi tiết

Cài đặt
-------

[](#cài-đặt)

```
composer require vnpost/postpay-php
```

Cấu hình
--------

[](#cấu-hình)

Trước khi sử dụng, bạn cần cấu hình một số thông tin cần thiết như chế độ hoạt động (dev/prod), đường dẫn đến file chứng chỉ API (.cer), và mã đối tác.

### Laravel

[](#laravel)

Nếu bạn sử dụng Laravel, bạn có thể thêm các biến cấu hình vào file .env:

```
POSTPAY_API_URL=postpay_api_url # https://postpay.vn/url
POSTPAY_API_KEY_PATH=/path/to/key.cer
POSTPAY_PARTNER_CODE=your_partner_code
POSTPAY_PARTNER_PRIVATE_KEY_PATH=/path/to/partner_private_key_path.pem
POSTPAY_PROXY_URL= # optional
```

### Framework php khác

[](#framework-php-khác)

```
[POSTPAY]
API_URL=postpay_api_url # https://postpay.vn/url
API_KEY_PATH=/path/to/key.cer
PARTNER_CODE=your_partner_code
PARTNER_PRIVATE_KEY_PATH=/path/to/partner_private_key_path.pem
PROXY_URL= # optional
```

Sau đó, trong mã của bạn, khởi tạo client như sau (dùng chung cả Laravel và Framework khác):

```
use Postpay\PostpayClient;

class PostpayController extends Controller
{
    public function createAccount(PostpayClient $postpayClient)
    {
        $data = input('post.'); // Thay chỗ này phù hợp với từng Framework
        $response = $postpayClient->createAccount($data);

        if ($response->getErrorCode()) {
            return json(['error' => $response->getErrorMessage()], 400);
        }

        return json($response->getData());
    }
}
```

###  Health Score

27

—

LowBetter than 46% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~15 days

Total

5

Last Release

657d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3dbf47b879684e141e3b81a02cbed9cebdbfb8b32bdcfbb86ebab83954d71946?d=identicon)[tkien](/maintainers/tkien)

---

Top Contributors

[![tkien](https://avatars.githubusercontent.com/u/2233345?v=4)](https://github.com/tkien "tkien (37 commits)")

### Embed Badge

![Health badge](/badges/vnpost-postpay-php/health.svg)

```
[![Health](https://phpackages.com/badges/vnpost-postpay-php/health.svg)](https://phpackages.com/packages/vnpost-postpay-php)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.3M49](/packages/tencentcloud-tencentcloud-sdk-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k832.6k55](/packages/neuron-core-neuron-ai)[files.com/files-php-sdk

Files.com PHP SDK

2482.9k](/packages/filescom-files-php-sdk)[volcengine/volcengine-php-sdk

119.5k](/packages/volcengine-volcengine-php-sdk)

PHPackages © 2026

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