PHPackages                             rublex/laravel-ipaymu-gateway - 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. rublex/laravel-ipaymu-gateway

ActiveLibrary[Payment Processing](/categories/payments)

rublex/laravel-ipaymu-gateway
=============================

A Laravel payment gateway package for iPaymu

1.0.0(1mo ago)027↓50%MITPHP

Since Jul 11Pushed 3w agoCompare

[ Source](https://github.com/rublexgit/laravel-ipaymu-gateway)[ Packagist](https://packagist.org/packages/rublex/laravel-ipaymu-gateway)[ RSS](/packages/rublex-laravel-ipaymu-gateway/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependencies (10)Versions (3)Used By (0)

Laravel iPaymu Gateway
======================

[](#laravel-ipaymu-gateway)

[![Latest Version](https://camo.githubusercontent.com/34e695c6016bc2a934a96bed696e29b2f2ab562a7134d65a55d00653cd506bea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e302d626c75652e737667)](https://packagist.org/packages/rublex/laravel-ipaymu-gateway)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

A Laravel payment gateway package for iPaymu Public API v2 integration.

Features
--------

[](#features)

- Payment initiation (hosted **Redirect** flow)
- Independent transaction verification via the Check Transaction API
- Secure callback route with single-use keys and idempotent forwarding
- Configurable via environment variables
- Built on `rublex/laravel-core-gateway` contracts

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

[](#installation)

```
composer require rublex/laravel-ipaymu-gateway
```

Configuration
-------------

[](#configuration)

Publish the configuration file:

```
php artisan vendor:publish --provider="Ipaymu\IpaymuServiceProvider" --tag="ipaymu-config"
```

Add credentials to your `.env` file:

```
IPAYMU_BASE_URL=https://sandbox.ipaymu.com
IPAYMU_VA=
IPAYMU_API_KEY=
```

> Use `https://my.ipaymu.com` for production. The `VA` and `API Key` are found in the Integration menu of your iPaymu dashboard and differ between sandbox and production.

Quick Start
-----------

[](#quick-start)

```
use Ipaymu\Services\IpaymuGatewayService;
use Rublex\CoreGateway\Data\DynamicDataBag;
use Rublex\CoreGateway\Data\PaymentRequestData;

$gateway = app(IpaymuGatewayService::class);

$result = $gateway->initiate(new PaymentRequestData(
    gatewayCode: $gateway->code(),
    orderId: 'INV-1774369486',
    amount: '150000',
    currency: 'IDR',
    callbackUrl: 'https://example.com/payment/final-callback',
    meta: new DynamicDataBag([
        'return_url' => 'https://example.com/thank-you',
        'cancel_url' => 'https://example.com/cancelled',
        'buyer_name' => 'Putu Made',
        'buyer_email' => 'buyer@example.com',
        'buyer_phone' => '081234567890',
    ])
));

// PaymentInitResultData:
//   status()           => PaymentStatus::PENDING
//   transactionId()    => iPaymu SessionID
//   redirectUrl()      => hosted payment page URL (redirect the payer here)
//   gatewayReference() => provider reference, when present
//   meta()             => responseCode / responseMessage
//   raw()              => full provider payload
```

Redirect the payer to `redirectUrl()`. iPaymu notifies the package callback route when the payment completes; the verified outcome is then forwarded to your `callbackUrl`.

Currency
--------

[](#currency)

iPaymu settles in **IDR only**. `initiate()` throws a `ValidationException` for any other currency. The amount is expected to already be denominated in IDR and is rounded to a whole rupiah (IDR has no minor units).

Signatures
----------

[](#signatures)

Two distinct mechanisms are involved — do not confuse them:

- **Request** — `HMAC-SHA256(stringToSign, API_KEY)` where `stringToSign = "METHOD:VA:lower(sha256(jsonBody)):API_KEY"`. The exact JSON string that is signed is the body that is sent.
- **Callback** — `HMAC-SHA256(json(ksort(payload)), VA)`. Verified opportunistically; the authoritative check is a server-to-server call to the Check Transaction API (`POST /api/v2/transaction`).

Backward Compatibility
----------------------

[](#backward-compatibility)

- `verifyPayment()` and `getPaymentStatus()` are explicit package methods and still throw not-implemented exceptions — status is confirmed internally via the Check Transaction API during callback handling.

Documentation
-------------

[](#documentation)

For installation and usage instructions, see [USAGE.md](USAGE.md).

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance95

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

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

Unknown

Total

1

Last Release

32d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a30955dfb5812ce62591802375eae1fe89123b20ae34bbed85aa29701f919ae4?d=identicon)[rublex](/maintainers/rublex)

---

Tags

laravelpaymentgatewayipaymurublex

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/rublex-laravel-ipaymu-gateway/health.svg)

```
[![Health](https://phpackages.com/badges/rublex-laravel-ipaymu-gateway/health.svg)](https://phpackages.com/packages/rublex-laravel-ipaymu-gateway)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.4M354](/packages/psalm-plugin-laravel)[api-platform/laravel

API Platform support for Laravel

58190.1k21](/packages/api-platform-laravel)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

79227.1M218](/packages/laravel-mcp)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9922.4M146](/packages/roots-acorn)[mike-bronner/laravel-model-caching

Automatic caching for Eloquent models.

2.4k161.4k2](/packages/mike-bronner-laravel-model-caching)[laravel/cashier

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

2.6k31.8M158](/packages/laravel-cashier)

PHPackages © 2026

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