PHP code example of ade-ridwan / pay-relay-php

1. Go to this page and download the library: Download ade-ridwan/pay-relay-php library. Choose the download type require.

2. Extract the ZIP file and open the index.php.

3. Add this code to the index.php.
    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

ade-ridwan / pay-relay-php example snippets


// app/Console/Kernel.php atau routes/console.php
$schedule->command('pay-relay:expire')->everyMinute();

return [
    'qris_static'    => env('PAY_RELAY_QRIS_STATIC', ''),
    'webhook_secret' => env('PAY_RELAY_WEBHOOK_SECRET', ''),
    'unique_code'    => ['length'=>3, 'min'=>100, 'max'=>999, 'max_retry'=>10],
    'expiry_minutes' => 15,
    'route' => [
        'enabled'      => true,
        'prefix'       => 'api/pay-relay',
        'middleware'   => ['api', 'throttle:60,1'],
        'webhook_path' => 'webhook',
        'status_path'  => 'payments/{referenceId}/status',
    ],
    'webhook' => [
        'parser' => \AdeRidwan\PayRelayPhp\Support\DefaultWebhookParser::class,
        'verify_signature' => env('PAY_RELAY_VERIFY_SIGNATURE', true),
        'signature_header' => env('PAY_RELAY_SIGNATURE_HEADER', 'X-Pay-Relay-Signature'),
    ],
    'model' => \AdeRidwan\PayRelayPhp\Models\PayRelayPayment::class,
    'table' => 'pay_relay_payments',
];

use AdeRidwan\PayRelayPhp\Laravel\Facades\PayRelay;

// 1. Buat pembayaran (tanpa payable)
$payment = PayRelay::create(amount: 100000);
// $payment->reference_id  => "01H..." (ULID, untuk polling)
// $payment->amount_original => 100000
// $payment->unique_code   => "123"
// $payment->amount_final  => 100123
// $payment->qris_dynamic  => "000201010212..." (string QR siap render)
// $payment->expires_at    => Carbon +15 menit

// 1b. Dengan Donation/Transaction (payable morph)
use App\Models\Donation;
$donation = Donation::find(1);
$payment = PayRelay::createFor($donation, 50000);
// $payment->payable_type => "App\Models\Donation", payable_id => 1
// $payment->payable => Donation model

// Ambil qris untuk FE
$qris = $payment->qris_dynamic;

// 2. Tampilkan ke FE
return response()->json([
    'reference_id' => $payment->reference_id,
    'amount_final' => $payment->amount_final,
    'qris'         => $payment->qris_dynamic, // render jadi QR image di FE
]);

// 3. Polling status
$status = PayRelay::check($payment->reference_id); // PaymentStatus enum
// atau HTTP: GET /api/pay-relay/payments/{referenceId}/status

// 4. Listen event
use AdeRidwan\PayRelayPhp\Events\PaymentPaid;
Event::listen(PaymentPaid::class, fn(PaymentPaid $e) => logger("paid: ".$e->payment->reference_id));

use AdeRidwan\PayRelayPhp\Qris\QrisRelay;
use AdeRidwan\PayRelayPhp\Support\Crc16;

$qrisDinamis = QrisRelay::toDynamic($staticQris, 100123);
Crc16::verify($qrisDinamis); // true

use App\Models\Donation;

$donation = Donation::find(1);
$latest = $donation->latestPayRelayPayment(); // helper trait
$qris = $latest?->qris_dynamic;

$all = $donation->payRelayPayments; // Collection
$pending = $donation->payRelayPayments()->where('status','pending')->first();

use AdeRidwan\PayRelayPhp\Concerns\HasPayRelayPayments;

class Donation extends Model { use HasPayRelayPayments; }

$tx = Transaction::create(['amount' => 100000, 'status' => 'pending']);
$pay = PayRelay::create(amount: $tx->amount, referenceId: (string) $tx->id);
// GET /api/pay-relay/payments/123/status

Event::listen(PaymentPaid::class, function (PaymentPaid $e) {
    Transaction::where('id', $e->payment->reference_id)->update([
        'status'  => 'paid',
        'paid_at' => $e->payment->paid_at,
    ]);
});

$donation = Donation::create(['title'=>'Donasi Masjid','amount'=>50000]);
$pay = PayRelay::createFor($donation, $donation->amount);

// listener generik
Event::listen(PaymentPaid::class, function (PaymentPaid $e) {
    if ($e->payment->payable instanceof \App\Models\Donation) {
        $e->payment->payable->update(['status'=>'paid','paid_at'=>$e->payment->paid_at]);
    }
});

// app/Parsers/MyQrisParser.php
use AdeRidwan\PayRelayPhp\Contracts\WebhookParserInterface;
use AdeRidwan\PayRelayPhp\Support\AmountExtractor;
use Illuminate\Http\Request;

class MyQrisParser implements WebhookParserInterface {
    public function parseAmount(Request $request): ?int {
        return AmountExtractor::fromAnyPayload($request->all());
        // atau: AmountExtractor::fromText($request->input('custom.sms'))
    }
    public function parsePayload(Request $request): array {
        return $request->all();
    }
}
// config/pay-relay.php
'webhook' => ['parser' => \App\Parsers\MyQrisParser::class],

use AdeRidwan\PayRelayPhp\Events\{PaymentCreated, PaymentPaid, PaymentExpired};
Event::listen(PaymentPaid::class, fn($e) => SendWa::dispatch($e->payment));
bash
composer  vendor:publish --tag=pay-relay-config
php artisan vendor:publish --tag=pay-relay-migrations
# untuk payable morph di DB lama:
php artisan vendor:publish --tag=pay-relay-payable
bash
php artisan migrate
bash
php artisan pay-relay:expire                # expire overdue
php artisan pay-relay:secret                # generate PAY_RELAY_WEBHOOK_SECRET
php artisan pay-relay:secret --show         # tampilkan saja
php artisan pay-relay:secret --length=32 --force