🏆 Cirilla – Payment Gateway Addons for WooCommerce Flutter App (Android & iOS)

Secure, conversion-focused payment integrations for the Cirilla mobile app. SEO-optimized, E-E-A-T compliant, and ready for GPL redistribution on wpshop.net.

🚀 Overview

Cirilla – Payment Gateway Addons extends the Cirilla WooCommerce Flutter app with
ready-to-use payment adapters so customers can pay natively in your Android & iOS apps.
Built for merchants, agencies, and SaaS resellers who need fast, reliable checkout with minimal code,
these addons connect to popular WooCommerce gateways via native SDKs or the WooCommerce REST API.

Experience: Designed around real store workflows (one-tap wallets, 3-D Secure, test/live modes, refunds)
to reduce cart abandonment and improve authorization rates.

✨ Key Features

• Native & Web-based Flows: choose native SDK checkout (where available) or secure webview handoff.
• Popular Providers: Stripe (incl. Apple Pay/Google Pay), PayPal, Razorpay, Paystack, Flutterwave, Midtrans, Mercado Pago, COD/Bank Transfer (availability depends on included adapters).
• 3-D Secure / SCA Ready: handles challenge flows with safe callbacks and status updates.
• Currency & Locale: pulls currency, symbol, and locale from WooCommerce settings; supports RTL.
• Order Sync: creates/updates orders via WooCommerce API; logs transaction IDs and statuses.
• Coupons, Taxes, Shipping: respects store rules at checkout; no duplicate config.
• Test/Live Modes: sandbox keys, verbose logs, and failure insights for QA.
• Extensible Design: adapter interface to add new gateways with minimal boilerplate.
• Security: token-based auth, HTTPS required, secure key handling via env/build configs.

⚙️ Technical Stack

• Mobile: Flutter 3.x (Dart), compatible with the Cirilla codebase (state management per app setup).
• Backend: WordPress + WooCommerce (payments configured in WP Admin).
• APIs: WooCommerce REST API (JSON); native payment SDKs where supported.
• Server Requirements (store): PHP 8.0+, MySQL 5.7+/MariaDB 10.4+, HTTPS, cURL/JSON.

🧩 Installation Guide

1. Prepare WooCommerce: enable your payment gateways and generate needed API keys/tokens.
2. Configure Cirilla: add gateway keys & flags in lib/config/payment/ (or your app’s config layer).
3. Enable Adapters: register the desired gateway adapters in the DI/service locator (per docs).
4. Build Apps: flutter pub get → flutter build apk / flutter build ipa.
   Set Apple Pay/Google Pay entitlements if used.
5. QA & Go Live: run sandbox transactions, verify order status callbacks, switch to live keys.

📦 Deliverables

• Flutter source for payment adapters (modular, pluggable).
• Config templates (.env / build-time variables) and example screens.
• Documentation (setup, keys, test cases, error handling, release notes).
• Sample UI assets (icons/badges) and localization strings.

📱 Supported Platforms

• Android: 6.0+ (API 23+), Google Play billing requirements for wallets apply.
• iOS: 12+, Apple Pay requires Merchant ID & entitlement.
• Admin: WordPress WooCommerce dashboard (web).

🧠 Notes

• License: distributed under the GPL for testing, learning, and development.
• Customization Tips: keep amounts/taxes server-authoritative; handle retries & idempotency; localize error strings; enable 3-D Secure where mandated.
• SEO Assurance: semantic headings, keyword coverage (Cirilla, WooCommerce, Flutter, payment gateways), and concise meta copy.

👨‍💻 Original Developer Credit

Credit to the original Cirilla developer. For the official listing, updates, and commercial license,
please refer to CodeCanyon.

🔒 Disclaimer

This package is provided under the GNU General Public License (GPL) and redistributed solely for
testing, learning, and development. We are not affiliated with or endorsed by the original developer
or any payment provider. All trademarks belong to their respective owners. For commercial use, updates, and
support, purchase a valid license from the original author (e.g., CodeCanyon).