bayarcash

Releases

1. ▸▾1.0.022 Jul 2026

   Initial release of the Bayarcash Dart SDK — a feature-parity, idiomatic port of the official PHP SDK. Pure Dart, usable from Flutter apps and server-s

   Added

   • Initial release of the Bayarcash Dart SDK — a feature-parity, idiomatic port of the official PHP SDK. Pure Dart, usable from Flutter apps and server-side Dart.
   • Bayarcash client with named-parameter configuration (token, secretKey, sandbox, apiVersion, timeout) and an injectable http.Client for testing. Fluent useSandbox(), setApiVersion(), setTimeout(), setToken() setters are also provided.
   • API v2 (default) and v3 support, with automatic base-URI selection per version and environment.
   • Checksum generation (HMAC-SHA256): createChecksumValue, createPaymentIntentChecksumValue (plus the misspelled createPaymentIntenChecksumValue alias), createFpxDirectDebitEnrolmentChecksumValue, and createFpxDirectDebitMaintenanceChecksumValue. Byte-compatible with the gateway and the PHP SDK.
   • Callback verification for every callback type — pre-transaction, transaction, return-url, Direct Debit bank approval, Direct Debit authorization (including application_type), and Direct Debit transaction — using constant-time checksum comparison.
   • Operations: createPaymentIntent, getTransaction, getPaymentIntent (v3), cancelPaymentIntent (v3), getAllTransactions and the v3 transaction queries (getTransactionByOrderNumber, getTransactionsByPayerEmail, getTransactionsByStatus, getTransactionsByPaymentChannel, getTransactionByReferenceNumber), getPortals, getChannels, fpxBanksList, FPX Direct Debit enrol/maintain/terminate + getFpxDirectDebit
     • getFpxDirectDebitTransaction, and manual bank transfer create (multipart file upload) + update-status.
   • Payment-channel constants (all channels, with the id-20 gap and ShopeePay at 21), status enums (Fpx, FpxDirectDebit, Dobw) with status-text helpers, and payer-id-type / frequency-mode constants.
   • Typed exceptions mapping HTTP status codes: ValidationException (422), NotFoundException (404), FailedActionException (400), RateLimitException (429), and BayarcashApiException (other), all subclassing BayarcashException.
   • Tolerant response resources for payment intents, transactions, portals, FPX banks, and mandates, with typed fields, raw/operator[] access, and toMap().