- How do I install the laravel-duitnow-qr package with Composer?
- Install it with Composer using composer require zarulizham/laravel-duitnow-qr. Laravel's package auto-discovery should register the service provider, but if you are on an older setup you may need to add the provider to your config manually. After installing, publish any provided config file so you can set your merchant credentials. Always check the repository README for the exact installation steps for your version.
- Which Laravel versions does this DuitNow QR package support?
- The package is built as a standard Laravel package and is intended for modern Laravel applications. The exact PHP and Laravel version constraints are declared in its composer.json, so check that file or the Packagist page before installing. If your application runs an older Laravel release, confirm compatibility or test in a staging branch first.
- What is the difference between static and dynamic QR codes in this package?
- A static DuitNow QR encodes fixed merchant details and can be reused for many payments, which makes it suitable for printed or displayed codes. A dynamic QR is generated per transaction and typically carries a specific amount or reference so the payment can be matched to an order. The package exposes both flows through its API so you can pick the right one per use case.
- How do I configure merchant details for DuitNow QR generation?
- Merchant details such as the merchant identifier, name, city and related DuitNow fields are supplied through the package configuration or passed when building a QR payload. Keep these values in environment variables or a config file rather than hardcoding them in controllers. Use different configuration sets for sandbox and production so test credentials never reach live payments.
- How do I handle DuitNow payment callbacks or notifications in Laravel?
- You expose an endpoint in your Laravel routes that receives the payment notification, then pass the payload to the package or your own handler for processing. Validate the payload against your records, mark the matching order as paid, and return the acknowledgement response the payment provider expects. Because callbacks can be retried, make the handler idempotent and log every request for reconciliation.
- Do I need AmBank merchant credentials to use this package?
- Yes, generating live DuitNow QR codes and receiving payment notifications requires merchant credentials issued for the AmBank DuitNow QR service. Without them you can still explore the API and payload structure, but you will not be able to complete real transactions. Request sandbox or developer credentials from the bank before integrating in earnest.
- Can I test DuitNow QR generation without a live merchant account?
- You can unit test your own integration by mocking the package's client or service and asserting the payloads your application builds. Full end-to-end testing of QR payloads and callbacks generally depends on sandbox access from the provider. Keep those tests separate so your suite does not require network access or real credentials in CI.
- Is this package safe to use in a production Laravel application?
- The package is a thin wrapper around the DuitNow QR payment flow, so production safety depends on how you handle credentials, callbacks and reconciliation in your application. Store merchant secrets in environment variables, serve everything over HTTPS, and verify callback payloads before marking an order as paid. Pin the package version in composer.lock and review changes before upgrading.
- Does laravel-duitnow-qr work outside Laravel or with other PHP frameworks?
- It is packaged as a Laravel wrapper, so its service provider, configuration and facade-style API assume a Laravel application. Using it in plain PHP or another framework would mean instantiating the underlying classes manually, which is not the intended path. For non-Laravel projects, look at the raw DuitNow QR specification or a framework-agnostic library instead.
- What alternatives exist for generating DuitNow QR codes in PHP?
- Alternatives include building the DuitNow QR payload yourself from the published specification, using a generic EMVCo QR library, or choosing another gateway package that supports Malaysian QR payments. This package is a good fit if you specifically want AmBank DuitNow support with a Laravel-friendly API. Compare maintenance activity, callback handling and documentation before committing to one option.