PHPackages                             reefki/laravel-flip - 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. reefki/laravel-flip

ActiveLibrary[Payment Processing](/categories/payments)

reefki/laravel-flip
===================

Fluent Laravel SDK for the Flip for Business (flip.id) payment API.

v0.5.0(3mo ago)02MITPHPPHP ^8.2CI passing

Since Apr 22Pushed 3mo agoCompare

[ Source](https://github.com/reefki/laravel-flip)[ Packagist](https://packagist.org/packages/reefki/laravel-flip)[ RSS](/packages/reefki-laravel-flip/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (8)Versions (7)Used By (0)

Laravel Flip
============

[](#laravel-flip)

[![Latest Version on Packagist](https://camo.githubusercontent.com/18e1b8def5de7281d50583aebaa2d16e7c57e6ba53c2a15fef3e17fdcd95cca6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726565666b692f6c61726176656c2d666c69702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/reefki/laravel-flip)[![Tests](https://camo.githubusercontent.com/78fdee6338eb080d129b48b3bfa4b4fc10d7d4132aad3d10da1040ce8b840e5c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f726565666b692f6c61726176656c2d666c69702f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/reefki/laravel-flip/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/5455c4614067a2f1cb5fad1c4dceee48f87bb3f42bdf252565266cd24694dec0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726565666b692f6c61726176656c2d666c69702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/reefki/laravel-flip)[![License](https://camo.githubusercontent.com/41580c4c86fa0429610acd529609c17034e09feffd139945eacd4f7789ecbc7c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f726565666b692f6c61726176656c2d666c69702e7376673f7374796c653d666c61742d737175617265)](LICENSE)

A fluent, fully-tested Laravel SDK for the [Flip for Business](https://docs.flip.id/docs/api/flip-for-business-api-documentation) payment API.

Covers everything Flip publishes:

- **General** — balance, supported banks, maintenance probe
- **Disbursement** (v2 + v3) — money transfer, list, lookup by id / idempotency key, bank account inquiry, special money transfer (PJP)
- **Reference data** (v2-only) — city, country, combined lists
- **Accept Payment** (v3-only) — create / list / read / edit bill, list payments per bill, list all payments, settlement report
- **International Disbursement** (v2-only) — exchange rates, form data, list, find, C2C/C2B + B2C/B2B create
- **Webhook signature validation**

Accept Payment v2 is deprecated; bill/payment/settlement-report resources are pinned to v3 and ignore `FLIP_VERSION`. Multi-version resources (disbursement, special disbursement) follow the configured default and can be overridden per call.

Install
-------

[](#install)

```
composer require reefki/laravel-flip
```

The service provider and `Flip` facade are auto-discovered.

Publish the config (optional):

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

Configure
---------

[](#configure)

Set these in your `.env`:

```
FLIP_SECRET_KEY=your-secret-key
FLIP_VALIDATION_TOKEN=your-callback-validation-token
FLIP_ENVIRONMENT=sandbox      # or production
FLIP_VERSION=v3               # default API version: v2 or v3
```

`config/flip.php` exposes everything (timeout, retries, base URLs).

> The default version applies to the disbursement family (money transfer, special money transfer). Everything else is pinned because Flip only ships each endpoint on one version: bank account inquiry, city/country lists, exchange rates and the international transfer family are v2-only; accept payment (bill, payment listing, settlement report) is v3-only. Pinned resources ignore the config default — see "Versioning" below.

Quickstart
----------

[](#quickstart)

```
use Reefki\Flip\Facades\Flip;

// Always check the deposit balance first
$balance = Flip::balance()->get();              // ['balance' => 49656053]

// Find a recipient bank
$bca = Flip::banks()->find('bca');              // operational status, fee, queue

// Verify the account holder name (cached → sync; uncached → callback)
$inquiry = Flip::disbursement()->inquiry('5465327020', 'bca');

// Create a disbursement (idempotency key is required by Flip)
$tx = Flip::disbursement()->create(
    payload: [
        'account_number' => '1122333300',
        'bank_code'      => 'bni',
        'amount'         => 10000,
        'remark'         => 'Salary - April',
    ],
    idempotencyKey: 'salary-april-user-123',
);
```

Resources
---------

[](#resources)

### Balance

[](#balance)

```
Flip::balance()->get();          // ['balance' => int]
```

### Banks

[](#banks)

```
Flip::banks()->list();           // all banks
Flip::banks()->list('bca');      // filter by code
Flip::banks()->find('bca');      // single entry, or null
```

### Maintenance

[](#maintenance)

```
Flip::maintenance()->check();              // ['maintenance' => bool]
Flip::maintenance()->isUnderMaintenance(); // bool
```

### Disbursement (Money Transfer)

[](#disbursement-money-transfer)

```
$tx = Flip::disbursement()->create(
    payload: [
        'account_number'   => '1122333300',
        'bank_code'        => 'bni',
        'amount'           => 10000,
        'remark'           => 'Refund',
        'recipient_city'   => 391,
        'beneficiary_email'=> 'user@example.com',
    ],
    idempotencyKey: 'refund-order-987',
    timestamp: now()->toIso8601String(), // optional X-TIMESTAMP
);

Flip::disbursement()->list(['pagination' => 50, 'page' => 2, 'status' => 'DONE']);
Flip::disbursement()->find('1234567890123456800');
Flip::disbursement()->findByIdempotencyKey('refund-order-987');
```

### Bank Account Inquiry

[](#bank-account-inquiry)

`inquiry()` is pinned to `v2` — Flip has not shipped a v3 of this endpoint.

```
$inquiry = Flip::disbursement()->inquiry(
    accountNumber: '5465327020',
    bankCode: 'bca',
    inquiryKey: 'order-987',  // optional, for matching async callbacks
);
```

If the result isn't cached, `status` will be `PENDING` and Flip will hit your configured callback URL with the final result.

### Special Money Transfer (PJP)

[](#special-money-transfer-pjp)

```
Flip::specialDisbursement()->create(
    payload: [
        'account_number' => '1122333300',
        'bank_code'      => 'bni',
        'amount'         => 10000,
        'sender_name'    => 'John Doe',
        'sender_address' => 'Jl. Example 123',
        'sender_country' => 100252,
        'sender_job'     => 'entrepreneur',
        'direction'      => 'DOMESTIC_SPECIAL_TRANSFER',
    ],
    idempotencyKey: 'special-1',
);
```

### Accept Payment (Bills)

[](#accept-payment-bills)

```
$bill = Flip::bill()->create([
    'title'        => 'Coffee Table',
    'type'         => 'SINGLE',
    'amount'       => 30000,
    'expired_date' => '2026-12-30 15:50',
    'step'         => 'checkout',          // checkout | checkout_seamless | direct_api
    'reference_id' => 'order-1234',
]);

Flip::bill()->list();
Flip::bill()->find($billId);
Flip::bill()->update($billId, ['status' => 'INACTIVE']);
```

### Payments

[](#payments)

```
Flip::payment()->forBill($billId, ['start_date' => '2026-01-01']);
Flip::payment()->list(['reference_id' => 'order-1234']);
```

### Settlement Report

[](#settlement-report)

```
$report = Flip::settlementReport()->generate('2026-01-01', '2026-01-09');
$status = Flip::settlementReport()->checkStatus($report['request_id']);
```

### International Disbursement (v2)

[](#international-disbursement-v2)

```
$rates = Flip::internationalDisbursement()->exchangeRates('C2C', 'USA');
$form  = Flip::internationalDisbursement()->formData('C2C', 'USA');

Flip::internationalDisbursement()->createConsumer($payload, 'idem-c2c-1');
Flip::internationalDisbursement()->createBusiness($payload, 'idem-b2b-1');

Flip::internationalDisbursement()->find($transactionId);
Flip::internationalDisbursement()->list(['pagination' => 25]);
```

### Reference Data

[](#reference-data)

```
Flip::reference()->cities();              // ['102' => 'Kab. Bekasi', ...]
Flip::reference()->countries();           // ['100000' => 'Afghanistan', ...]
Flip::reference()->citiesAndCountries();  // both, merged
```

Versioning
----------

[](#versioning)

Flip ships some endpoints on both v2 and v3, others on only one. The package handles that for you:

- **Configurable default**: `config('flip.version')` (default `v3`) applies to all multi-version resources.
- **Per-call override**: `Flip::disbursement()->withVersion('v2')->list()` returns a clone with the version forced.
- **Global override**: `Flip::useVersion('v2')->disbursement()->list()` for a one-off facade chain.
- **Pinned endpoints**: these endpoints ignore the configured default:
    - **v2-only** (Flip does not publish v3): bank account inquiry, city/country lists, exchange rates, form data, every international-disbursement endpoint.
    - **v3-only** (v2 is deprecated): accept-payment bills, payment listings, settlement report.

```
// Force a v2 disbursement create even if FLIP_VERSION=v3
Flip::disbursement()->withVersion('v2')->create($payload, 'idem-1');

// Or for an entire facade chain
Flip::useVersion('v2')->disbursement()->list();
```

Webhooks
--------

[](#webhooks)

Every Flip callback POSTs `application/x-www-form-urlencoded` with two fields: `data` (JSON-encoded payload) and `token` (your validation token). Verify it with one call:

```
use Illuminate\Http\Request;
use Reefki\Flip\Facades\Flip;
use Reefki\Flip\Exceptions\InvalidWebhookSignatureException;

Route::post('/webhooks/flip/disbursement', function (Request $request) {
    try {
        $payload = Flip::webhook()->verify($request);
    } catch (InvalidWebhookSignatureException) {
        abort(403);
    }

    // $payload is the decoded `data` array
    // ['id' => '1234567890123456789', 'status' => 'DONE', 'amount' => '10000', ...]

    Disbursement::where('flip_id', $payload['id'])->update([
        'status'      => $payload['status'],
        'reason'      => $payload['reason'] ?? null,
        'time_served' => $payload['time_served'] ?? null,
    ]);

    return response()->noContent();   // Flip retries non-200s 5x at 2-min intervals
});
```

Or just check whether a token is valid:

```
if (Flip::webhook()->isValid($request->input('token'))) {
    // ...
}
```

Errors
------

[](#errors)

Flip's documented error responses map to typed exceptions:

HTTP / CauseException401`Reefki\Flip\Exceptions\AuthenticationException`404`Reefki\Flip\Exceptions\NotFoundException`422`Reefki\Flip\Exceptions\ValidationException`503`Reefki\Flip\Exceptions\MaintenanceException`Network / DNS`Reefki\Flip\Exceptions\ConnectionException`★ any other`Reefki\Flip\Exceptions\FlipException` (base class)Webhook verification raises its own pair:

CauseExceptionValidation token mismatch`Reefki\Flip\Exceptions\InvalidWebhookSignatureException`Signature OK but `data` field isn't valid JSON`Reefki\Flip\Exceptions\MalformedWebhookPayloadException`All inherit from `FlipException`, which exposes the response body and Flip's `errors[]` array:

```
use Reefki\Flip\Exceptions\ValidationException;

try {
    Flip::disbursement()->create($payload, 'idem-1');
} catch (ValidationException $e) {
    foreach ($e->errors() as $err) {
        logger()->warning('flip.validation', $err); // ['attribute' => ..., 'code' => ..., 'message' => ...]
    }
    throw $e;
}
```

Testing your code
-----------------

[](#testing-your-code)

The package uses Laravel's HTTP client under the hood, so you can fake requests in your own tests with `Http::fake()`:

```
use Illuminate\Support\Facades\Http;
use Reefki\Flip\Facades\Flip;

Http::fake([
    'bigflip.id/big_sandbox_api/v3/disbursement' => Http::response([
        'id' => 1234567890123456800,
        'status' => 'PENDING',
    ], 200),
]);

$result = Flip::disbursement()->create($payload, 'idem-1');
```

Running the package's own test suite
------------------------------------

[](#running-the-packages-own-test-suite)

```
composer install
vendor/bin/pest
```

Pest covers every resource, both versions, error mapping, and webhook signature validation.

License
-------

[](#license)

MIT.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance82

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

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

Total

6

Last Release

92d ago

PHP version history (2 changes)v0.1.0PHP ^8.1

v0.4.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/10998084?v=4)[Rifki Aria Gumelar](/maintainers/reefki)[@reefki](https://github.com/reefki)

---

Top Contributors

[![reefki](https://avatars.githubusercontent.com/u/10998084?v=4)](https://github.com/reefki "reefki (1 commits)")

---

Tags

laravelpaymentflipindonesiadisbursementremittanceflip.id

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/reefki-laravel-flip/health.svg)

```
[![Health](https://phpackages.com/badges/reefki-laravel-flip/health.svg)](https://phpackages.com/packages/reefki-laravel-flip)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[laravel/socialite

Laravel wrapper around OAuth 1 & OAuth 2 libraries.

5.7k108.5M925](/packages/laravel-socialite)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M133](/packages/roots-acorn)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

77922.3M186](/packages/laravel-mcp)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5022.6k](/packages/simplestats-io-laravel-client)

PHPackages © 2026

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