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