buzapay_sdk 0.2.0

Flutter SDK for Buzapay Payment Gateway. Accept payments with Card, Bank Transfer and Stablecoins (USDT/USDC).

Changelog

All notable changes to this project will be documented in this file.

0.2.0 - 2026-02-13

Breaking Changes

• Replaced onSuccess, onError, onCancel with single onComplete callback - The SDK is not the source of truth for payment status. onComplete(reference) fires when the checkout flow ends; the user must verify the transaction server-side via the API or webhooks
• Removed BuzapayCancelledException - No longer applicable with the new dismiss-based flow

Changed

• Buzapay.checkout() now throws exceptions directly instead of swallowing them into an onError callback

0.1.1 - 2026-02-12

Breaking Changes

• Removed clientId and clientSecret - Authentication now uses only your Merchant ID; no secret keys are needed client-side
• Removed AuthService - Token fetch/refresh logic has been removed
• Removed BuzapaySignatureException - 403 errors now throw BuzapayAuthException

Added

• Timeout error handling - Timeout errors now report a clear message with duration instead of a generic network error

Changed

• ApiClient now sends a MerchantId header instead of Authorization, Reference, and Signature headers
• BuzapayConfig only requires merchantId (simplified constructor)
• Removed crypto package dependency

0.1.0 - 2026-01-07

Added

• Initial release of Buzapay Flutter SDK
• Authentication: OAuth2 token management with automatic refresh
• Signature Generation: SHA1-based request signing for API security
• Payment Links: Generate checkout URLs via generatePaymentLink()
• Checkout Flow: One-liner checkout() method with WebView integration
• Pre-built UI: BuzapayCheckoutButton widget for drop-in integration
• WebView Component: BuzapayWebView for checkout display
• Error Handling: Typed exceptions (BuzapayAuthException, BuzapayPaymentException, etc.)
• Multi-currency Support: NGN, USD, USDT, USDC
• Environment Support: Sandbox and Production environments
• Logging: Optional debug logging for development