rohama / koin-idpay

2.2.1 2026-10-23 08:09 UTC

Requires

• php: ^8.0
• rohama/koin-core: ^2.2.1

Requires (Dev)

• phpunit/phpunit: ^9.6 || ^10.5 || ^11.5 || ^12.0

MIT

• Rohama

Published on Packagist.org on 2026-10-23 08:10 UTC

README

Docs site · Docs on GitHub

The IDPay gateway driver for the Koin package — built on IDPay's REST API v1.1.

Install

composer require rohama/koin-idpay

Features

• Payment request — returns id + StartPay redirect URL
• Verify
• Inquiry
• Transaction list
• Callback parsing
• Sandbox

Configuration

Field	Description
apiKey	36-char API key
sandbox	IDPay's official test mode

Usage

use Rohama\Koin\IDPay\IDPayGateway;
use Rohama\Koin\Support\PaymentStatus;

$gateway = new IDPayGateway('api-key-36-chars', 'https://example.com/callback');

$payment = $gateway->request(150000, 'ORDER-1', 'Subscription purchase');

if ($payment->isSuccessful()) {
    header('Location: ' . $payment->redirectUrl);
    exit;
}

// In the callback page — parseCallback runs verify() before reporting success
$callback = $gateway->parseCallback($_GET, $_POST);
if ($callback->status === PaymentStatus::SUCCESS) {
    // Verified
}

refund() (in gateways that offer Refund) is available only when the developer-only 5th constructor parameter (refundable) is enabled.

Full documentation: https://rohamaa.github.io/Koin-Core/