README

SDK Laravel ringan untuk integrasi pembayaran digital Indonesia pakasir.com. Dukung QRIS, Virtual Account multi-bank & PayPal dengan kalkulasi fee otomatis.

Installation · Quick Start · Configuration · Payment Methods · API Reference · Documentation

📚 Documentation

• Panduan Integrasi Lengkap (Tutorial)
• Panduan Development & Kontribusi

📦 Installation

Requires PHP 8.1+

Install fadhila36/pakasir-sdk using composer:

composer require fadhila36/pakasir-sdk

⚡ Quick Start

Using Enum (Recommended)

use Fadhila36\Pakasir\Enums\PaymentMethod;
use Fadhila36\Pakasir\Facades\Pakasir;

// Create QRIS Payment
$transaction = Pakasir::createPayment(
    PaymentMethod::QRIS, 
    'ORDER-' . time(), 
    10000, 
    'https://yourwebsite.com/callback' // Optional Redirect URL
);

print_r($transaction);

Using String

$transaction = Pakasir::createPayment('qris', 'ORDER-123', 10000);

🛠️ Configuration

Publish the config file:

php artisan vendor:publish --provider="Fadhila36\Pakasir\PakasirServiceProvider" --tag="config"

Then add your configuration to .env:

PAKASIR_PROJECT=your-slug
PAKASIR_API_KEY=your-api-key

💰 Payment Methods

Supported methods in Fadhila36\Pakasir\Enums\PaymentMethod:

See PaymentMethod Enum for full list.

📖 API Reference

1. Create Payment

Trigger API request to create a transaction.

Pakasir::createPayment(
    string|PaymentMethod $method, 
    string $orderId, 
    int|float $amount, 
    ?string $redirectUrl = null
): array

2. Get Payment Data

Get full payment details locally (fee calculation, expiration, URL) without calling the API (except for createPayment usage).

Pakasir::getPaymentData(
    string|PaymentMethod $method, 
    string $orderId, 
    int|float $amount,
    ?string $redirectUrl = null
): array

3. Get Payment URL

Shortcut to get just the payment URL.

$url = Pakasir::getPaymentUrl(PaymentMethod::QRIS, 'ORD-01', 50000);

4. Check Status

Check payment status from API.

$status = Pakasir::detailPayment('ORD-01', 50000);

5. Simulation (Sandbox)

Simulate logic for testing.

Pakasir::simulationPayment('ORD-01', 50000);

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create new branch: git checkout -b feature/my-feature.
3. Commit your changes: git commit -m 'Add some feature'.
4. Push to the branch: git push origin feature/my-feature.
5. Open Pull Request.

📜 License

Distributed under the MIT License. See LICENSE for details.