Download the PHP package ade-ridwan/pay-relay-php without Composer
On this page you can find all versions of the php package ade-ridwan/pay-relay-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ade-ridwan/pay-relay-php
More information about ade-ridwan/pay-relay-php
Files in ade-ridwan/pay-relay-php
Package pay-relay-php
Short Description Relay QRIS Statis menjadi Dinamis dengan kode unik dan webhook custom Android notification listener
License MIT
Informations about the package pay-relay-php
pay-relay-php
Relay QRIS Statis menjadi QRIS Dinamis dengan kode unik di nominal. Verifikasi pembayaran via webhook custom dari aplikasi Android Notification Listener yang menangkap notifikasi mutasi masuk (BCA, BRI, Mandiri, DANA, GoPay Merchant, dll).
Cocok untuk UMKM / warung yang cuma punya 1 QRIS cetak tapi ingin checkout otomatis di web.
[]()
[
]()
[
]()
Fitur
- QRIS Relay — Parse TLV EMVCo, inject Tag
54(amount) + ubah01jadi12(dinamis), hitung ulang CRC16-CCITT6304. - Kode Unik Nominal —
final = original + 100..999(3 digit suffix). Contoh100.000→100.123. Anti-tabrakan untuk transaksipending. - Storage Database —
pay_relay_payments(reference_idULID,payable_type/idmorph,amount_finalindexed,status: pending|paid|expired|cancelled). ModelPayRelayPayment(aliasPaymentdeprecated). - Payable Morph — Hubungkan ke
Donation/TransactionviaHasPayRelayPaymentstrait +PayRelay::createFor($model, amount). - Webhook Android —
POST /api/pay-relay/webhookHMAC header customizable,verify_signaturebisa di-bypass untuk test, parserWebhookParserInterface+AmountExtractorfield-agnostic (title/text/tickerapapun). - Cek Status —
GET /api/pay-relay/payments/{referenceId}/statusuntuk polling FE. - Expiry —
php artisan pay-relay:expire+ eventsPaymentCreated/PaymentPaid/PaymentExpired. - Secret Generator —
php artisan pay-relay:secret.
Instalasi
Isi .env:
Lalu:
Scheduler (disarankan):
Konfigurasi
config/pay-relay.php:
PayRelayPaymentsengaja tidak pakai namaPaymentagar tidak bentrokApp\Models\Payment.webhook.signature_headerbisa dikustom (mis.X-Custom-Signature).
Penggunaan Dasar
Low-level (tanpa DB)
Ambil PayRelay dari Donation
Pasang trait di model:
Integrasi transactions / Donation
Opsi A — Simple (reference_id sebagai FK)
Opsi B — Payable Morph (Recommended)
Rambu: reference_id tetap unique — jangan create() 2x untuk id sama sebelum expired.
Webhook Android
Test tanpa signature (bypass):
Payload fleksibel (field title/text/ticker apapun, di-scan rekursif):
Aturan controller:
amountdiekstrak viaAmountExtractor(RpregexRp\.?[\s_]*([\d\._]+)) — tahanRp 1.000,Rp_1_000,Rp1.000,00, plusgetContent()fallback jikaall()kosong.- Cari
pay_relay_paymentsdenganamount_final = amount+status=pending+expires_at > now()→ updatepaid. - Jika sudah
paid→200 {already_paid:true}(idempotent). - Jika tidak ketemu →
404(Android bisa retry). - Jika
amounttidak ter-parse →422.
Custom parsing di project:
API Routes
| Method | URL | Keterangan |
|---|---|---|
POST |
/api/pay-relay/webhook |
Webhook Android (HMAC) |
GET |
/api/pay-relay/payments/{referenceId}/status |
Cek status polling |
Response status:
Events & Command
Event PaymentPaid listener daftar di AppServiceProvider::boot() atau bootstrap/app.php ->withEvents(discover: [...]) dengan #[Listen].
Alur Lengkap
Keamanan
PAY_RELAY_WEBHOOK_SECRETminimal 32 karakter (generate viapay-relay:secret), jangan commit.- Header signature customizable via
PAY_RELAY_SIGNATURE_HEADER. - Webhook wajib HMAC
hash_equals, middlewareVerifyWebhookSignature. - Rate limit
throttle:60,1default. - Jangan expose
qris_staticke response publik.
Roadmap
- V1.0 — Relay QRIS, kode unik, DB payable morph, webhook parser + AmountExtractor, status, expire, secret command.
- V1.1 —
pay_relay_logs, dashboard Filament. - V1.2 — Multi-merchant, notifikasi WA/Telegram.
Lisensi
MIT — Ade Ridwan.
All versions of pay-relay-php with dependencies
illuminate/support Version ^10.0|^11.0|^12.0|^13.0
illuminate/database Version ^10.0|^11.0|^12.0|^13.0
illuminate/events Version ^10.0|^11.0|^12.0|^13.0
illuminate/http Version ^10.0|^11.0|^12.0|^13.0
illuminate/routing Version ^10.0|^11.0|^12.0|^13.0