🐘 PunyaKios PHP SDK

Library PHP resmi untuk integrasi Merchant API PunyaKios. Solusi termudah untuk menerima pembayaran QRIS di website PHP Anda.

🛠️ Instalasi

Cukup download file PunyaKios.php dan sertakan di dalam project Anda:

require_once 'PunyaKios.php';

🚀 Cara Penggunaan

use PunyaKios\PunyaKios;

$sdk = new PunyaKios('YOUR_API_KEY');

// 1. Membuat Request Pembayaran
$response = $sdk->createPaymentRequest([
    'external_id' => 'ORDER-202',
    'amount' => 25000,
    'description' => 'Topup Saldo Merchant',
    'callback_url' => 'https://websitemu.com/callback.php'
]);

if ($response['status_code'] === 200) {
    $checkoutUrl = $response['data']['data']['checkout_url'];
    header("Location: $checkoutUrl"); // Redirect ke halaman pembayaran
}

// 2. Cek Riwayat Transaksi
$history = $sdk->getTransactions();
print_r($history['data']);

🔔 Menangani Callback

Gunakan static method parseCallback() untuk menerima data notifikasi lunas:

// Di file callback.php
require_once 'PunyaKios.php';
use PunyaKios\PunyaKios;

$data = PunyaKios::parseCallback();

if ($data && $data['status'] === 'PAID') {
    $orderId = $data['external_id'];
    // Update status di database Anda
    
    http_response_code(200);
    echo json_encode(['message' => 'Success']);
}

📋 Persyaratan

• PHP >= 7.4
• php-curl extension enabled
• php-json extension enabled

📄 Lisensi

Distributed under the MIT License. Lihat LICENSE untuk informasi lebih lanjut.