PHPackages                             aliziodev/payid - 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. aliziodev/payid

ActiveLibrary[Payment Processing](/categories/payments)

aliziodev/payid
===============

Unified Laravel Payment Orchestrator for Indonesian Payment Gateways

v0.1.1(1mo ago)0261MITPHPPHP ^8.2CI failing

Since Apr 13Pushed 1mo agoCompare

[ Source](https://github.com/aliziodev/payid)[ Packagist](https://packagist.org/packages/aliziodev/payid)[ RSS](/packages/aliziodev-payid/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (12)Versions (3)Used By (1)

PayID
=====

[](#payid)

> Unified Laravel Payment Orchestrator for Indonesian Payment Gateways

PayID adalah package Laravel yang menyatukan berbagai payment gateway Indonesia dalam satu API yang konsisten dan extensible. Integrasikan sekali, gunakan provider mana saja melalui model driver.

Tujuan, Cakupan, dan Batasan
----------------------------

[](#tujuan-cakupan-dan-batasan)

### Tujuan

[](#tujuan)

- Menyediakan API pembayaran yang konsisten lintas provider untuk use case umum aplikasi.
- Mengurangi vendor lock-in dengan pendekatan driver dan capability-based contracts.
- Menstandarkan lifecycle pembayaran (charge, status, webhook, dsb.) agar mudah diuji dan dipelihara.

### Cakupan

[](#cakupan)

- Orkestrasi pembayaran pada layer aplikasi Laravel melalui facade/manager PayID.
- Standardisasi DTO, enum status, dan webhook normalization lintas driver.
- Ekstensi provider-specific melalui package driver terpisah (mis. Midtrans, Xendit, iPaymu, Nicepay).
- Integrasi opsional dengan stack transaksi/ledger lewat package pendamping.

### Batasan

[](#batasan)

- PayID bukan payment gateway; eksekusi transaksi tetap dilakukan oleh provider masing-masing.
- Fitur provider-specific yang sangat khusus tidak selalu tersedia di API generic manager, dan diakses via extension method pada driver.
- Compliance, legal, settlement, rekonsiliasi bank, dan dispute handling tetap menjadi tanggung jawab aplikasi/operasional bisnis.
- Konfigurasi kredensial, endpoint, serta kebijakan retry/queue production harus ditetapkan di aplikasi host sesuai kebutuhan domain.

---

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 11.x, 12.x, atau 13.x

---

Instalasi
---------

[](#instalasi)

Install PayID core:

```
composer require aliziodev/payid
```

Install driver provider yang diinginkan:

```
composer require aliziodev/payid-midtrans
composer require aliziodev/payid-xendit
```

Publish konfigurasi:

```
php artisan vendor:publish --tag=payid-config
```

Opsional, gunakan installer interaktif:

```
php artisan payid:install
```

Installer akan memandu:

- pemilihan driver gateway
- pemilihan transaction stack: `payid-transactions` atau `manual`

---

Konfigurasi
-----------

[](#konfigurasi)

Tambahkan ke `.env`:

```
PAYID_DEFAULT_DRIVER=midtrans

MIDTRANS_ENV=sandbox
MIDTRANS_SERVER_KEY=SB-Mid-server-xxxx
MIDTRANS_CLIENT_KEY=SB-Mid-client-xxxx
```

---

Penggunaan Dasar
----------------

[](#penggunaan-dasar)

### Membuat Transaksi

[](#membuat-transaksi)

```
use Aliziodev\PayId\DTO\ChargeRequest;
use Aliziodev\PayId\Enums\PaymentChannel;
use Illuminate\Support\Facades\PayId;

$response = PayId::charge(ChargeRequest::make([
    'merchant_order_id' => 'ORDER-001',
    'amount'            => 150000,
    'currency'          => 'IDR',
    'channel'           => PaymentChannel::Qris,
    'customer'          => [
        'name'  => 'Alizio',
        'email' => 'budi@example.com',
    ],
]));

return redirect($response->paymentUrl);
```

### Cek Status Transaksi

[](#cek-status-transaksi)

```
$status = PayId::status('ORDER-001');

if ($status->status->isSuccessful()) {
    // Tandai order sebagai dibayar
}
```

### Ganti Driver Saat Runtime

[](#ganti-driver-saat-runtime)

```
$response = PayId::driver('xendit')->charge($request);
```

### Operasi Lain yang Tersedia

[](#operasi-lain-yang-tersedia)

PayID manager/facade juga menyediakan:

- `directCharge(ChargeRequest $request)`
- `refund(RefundRequest $request)`
- `cancel(string $merchantOrderId)`
- `expire(string $merchantOrderId)`
- `approve(string $merchantOrderId)`
- `deny(string $merchantOrderId)`
- `createSubscription(SubscriptionRequest $request)`
- `getSubscription(string $providerSubscriptionId)`
- `updateSubscription(UpdateSubscriptionRequest $request)`
- `pauseSubscription(string $providerSubscriptionId)`
- `resumeSubscription(string $providerSubscriptionId)`
- `cancelSubscription(string $providerSubscriptionId)`
- `supports(Capability $capability)`

### Menangani Webhook

[](#menangani-webhook)

Daftarkan URL webhook ke dashboard provider: `https://yourdomain.com/payid/webhook/midtrans`

Tangkap event di listener:

```
use Aliziodev\PayId\Events\WebhookReceived;
use Aliziodev\PayId\Enums\PaymentStatus;

Event::listen(WebhookReceived::class, function (WebhookReceived $event) {
    $webhook = $event->webhook;

    if ($webhook->status === PaymentStatus::Paid) {
        Order::markAsPaid($webhook->merchantOrderId);
    }
});
```

---

Testing
-------

[](#testing)

```
$fake = PayId::fake();

$fake->fakeCharge(ChargeResponse::make([
    'provider_name'           => 'midtrans',
    'provider_transaction_id' => 'TRX-001',
    'merchant_order_id'       => 'ORDER-001',
    'status'                  => PaymentStatus::Pending,
    'payment_url'             => 'https://example.com/pay',
    'raw_response'            => [],
]));

// Jalankan kode yang memanggil PayId::charge(...)

$fake->assertCharged();
```

Fake helper lain yang tersedia termasuk:

- `fakeDirectCharge`, `fakeStatus`, `fakeRefund`, `fakeCancel`, `fakeExpire`
- `fakeApprove`, `fakeDeny`, `fakeSubscription`
- assertion seperti `assertDirectCharged`, `assertStatusChecked`, `assertRefunded`, `assertNothingRecorded`

---

Driver yang Tersedia
--------------------

[](#driver-yang-tersedia)

DriverPackageStatusMidtrans`aliziodev/payid-midtrans`StableXendit`aliziodev/payid-xendit`StableiPaymu`aliziodev/payid-ipaymu`BetaNicepay`aliziodev/payid-nicepay`StableDOKU`aliziodev/payid-doku`Coming Soon---

Dokumentasi
-----------

[](#dokumentasi)

- [R&D Document](docs/01-rnd-document.md)
- [Technical Architecture](docs/02-technical-architecture.md)
- [Package Blueprint](docs/03-package-blueprint.md)
- [Implementation Roadmap](docs/04-implementation-roadmap.md)
- [README and Docs Structure Draft](docs/05-readme-and-docs-structure.md)
- [Production Readiness Checklist](docs/06-production-readiness.md)
- [Driver Authoring Guide](docs/07-driver-authoring-guide.md)
- [Driver Acceptance Checklist](docs/08-driver-acceptance-checklist.md)
- [Midtrans Complete Usage Guide](docs/09-midtrans-complete-usage.md)
- [Xendit Complete Usage Guide](docs/10-xendit-complete-usage.md)
- [Driver Feature Matrix (Midtrans vs Xendit vs iPaymu vs Nicepay)](docs/11-driver-feature-matrix.md)
- [Xendit Extension API Quick Reference](docs/12-xendit-extension-api-quick-reference.md)
- [Midtrans Extension API Quick Reference](docs/13-midtrans-extension-api-quick-reference.md)
- [iPaymu Complete Usage Guide](docs/14-ipaymu-complete-usage.md)
- [iPaymu Extension API Quick Reference](docs/15-ipaymu-extension-api-quick-reference.md)
- [Nicepay Complete Usage Guide](docs/16-nicepay-complete-usage.md)
- [Nicepay Extension API Quick Reference](docs/17-nicepay-extension-api-quick-reference.md)
- [Diagram Index](docs/diagram/README.md)
- [PayID Complete System Flow Diagram](docs/diagram/01-payid-complete-system-flow.md)
- [Checkout and Payment Lifecycle Flow](docs/diagram/02-checkout-and-lifecycle-flow.md)
- [Webhook Processing Flow](docs/diagram/03-webhook-processing-flow.md)
- [Subscription Flow](docs/diagram/04-subscription-flow.md)
- [Driver Extension Flow](docs/diagram/05-driver-extension-flow.md)
- [ADR: Core and Driver Separation](docs/internals/adr/001-core-driver-separation.md)
- [ADR: Capability-based Contracts](docs/internals/adr/002-capability-based-contracts.md)
- [ADR: Immutable DTO](docs/internals/adr/003-immutable-dto.md)
- [ADR: Webhook Pipeline](docs/internals/adr/004-webhook-pipeline.md)

---

Status Kesiapan
---------------

[](#status-kesiapan)

- Test suite: passing
- Static analysis (PHPStan): passing
- Coverage report: butuh coverage driver (Xdebug/PCOV/phpdbg-compatible) di environment

Known Limitations
-----------------

[](#known-limitations)

- Coverage report belum dapat dijalankan jika environment belum memuat driver coverage.
- Driver iPaymu sudah tersedia pada level beta dan dapat dipakai untuk flow charge/status/webhook.
- Driver Nicepay sudah final dan berstatus stable, mencakup fitur SNAP + V2 melalui extension method.
- Fitur queue processing webhook disiapkan pada konfigurasi, tetapi implementasi orchestration async tetap perlu ditangani di aplikasi host.

---

Kontribusi
----------

[](#kontribusi)

Lihat [CONTRIBUTING.md](CONTRIBUTING.md) untuk panduan berkontribusi.

Security
--------

[](#security)

Untuk pelaporan vulnerability, lihat [SECURITY.md](SECURITY.md).

Upgrade
-------

[](#upgrade)

Panduan upgrade antar versi tersedia di [UPGRADE.md](UPGRADE.md).

Changelog
---------

[](#changelog)

Riwayat perubahan tersedia di [CHANGELOG.md](CHANGELOG.md).

---

Lisensi
-------

[](#lisensi)

MIT License.

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance89

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

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

Total

2

Last Release

57d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/187039973?v=4)[Alizio](/maintainers/aliziodev)[@aliziodev](https://github.com/aliziodev)

---

Top Contributors

[![aliziodev](https://avatars.githubusercontent.com/u/187039973?v=4)](https://github.com/aliziodev "aliziodev (12 commits)")

---

Tags

laravelpaymentgatewayindonesiaipaymuorchestratormidtransxenditDoku

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/aliziodev-payid/health.svg)

```
[![Health](https://phpackages.com/badges/aliziodev-payid/health.svg)](https://phpackages.com/packages/aliziodev-payid)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k14.1M120](/packages/laravel-pulse)[laravel/cashier

Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services.

2.5k28.4M134](/packages/laravel-cashier)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

76318.2M110](/packages/laravel-mcp)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9732.3M121](/packages/roots-acorn)[laravel/cashier-paddle

Cashier Paddle provides an expressive, fluent interface to Paddle's subscription billing services.

268880.7k3](/packages/laravel-cashier-paddle)

PHPackages © 2026

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