PHP Myanmar Payments

PHP SDK for Myanmar payment gateways: KBZ Pay, Wave Money, AYA Pay, Yoma MMQR and CyberSource. Typed requests and results, exact amounts, works with any PSR-18 HTTP client.

$composer require laranex/php-myanmar-payments

Get started View on GitHub

Requirements

• PHP ^8.1
• Any PSR-18 HTTP client and PSR-17 factories (e.g. Guzzle)
• Any PSR-16 cache (optional, for Yoma MMQR tokens)

Why PHP Myanmar Payments

Every Myanmar payment gateway signs its requests and callbacks its own way, reports its own status codes and has its own rules for amounts. PHP Myanmar Payments handles all of that behind one typed API for plain PHP and any framework: build the payment data, start the payment, then verify the callback the gateway sends back.

• Five gateways, one pattern. KBZ Pay (PWA, QR and in-app), Wave Money, AYA Pay, Yoma MMQR and CyberSource, each with its own class and the same three steps.
• One typed result per flow. RedirectPayment, FormPayment, QrPayment or AppPayment holds exactly what the next step needs: a URL to redirect to, an auto-submitting form, a QR code or the signed order for the KBZ Pay mobile SDK. See Payment Flows.
• Exact amounts, checked against each gateway's rules. Amounts are kept as decimal text and never pass through a float. Decimals, currency and limits follow each gateway's official documentation and are checked before any request is sent. See Amounts.
• Verified callbacks. handleCallback() checks the gateway's signature without a network call, maps its status onto one PaymentStatus enum and gives you the acknowledgement the gateway expects. When a callback is late, ask KBZ Pay, AYA Pay or Yoma MMQR with status(). See Callbacks & Status.
• Errors that say what went wrong. A missing setting, an invalid field, a gateway error and a bad signature each throw their own exception, with a message that names the setting, the field or the gateway's code.
• Any PSR-18 client, any PSR-16 cache. The HTTP client is discovered automatically (Guzzle, Symfony HttpClient, …) or passed in, and Yoma MMQR tokens go in the cache you choose. Use it in plain PHP, Symfony, Slim or any PSR-15 framework; Laravel apps use Laravel Myanmar Payments, which wraps this package.
• Same behavior in every language. The PHP, Go, Node.js and Python SDKs pass one shared set of test vectors for signing and callback verification, and read the same environment variables, so one .env file and one Yoma MMQR token cache serve them all.
• Nothing stored for you. The package keeps no tables and no webhook log. Handling Webhooks shows the recommended flow as code you copy: verify, store, acknowledge, then process each call once.
• Easy to test. Every gateway call goes through the client you pass, so your tests fake the responses, replay signed callbacks and never touch the network. See Testing.