flutter_wing_checkout

Flutter checkout for Wing Bank online payment, built on dart_wing, which it re-exports.

dependencies:
  flutter_wing_checkout: ^1.0.0

Paying in a web view

Authorize the payment on your server, not in the app: the Wing REST API key and password are secrets and must not ship inside an app. Your server calls authorize with dart_wing (or the PHP, Kotlin or Node.js SDK) and returns confirmUrl to the app, which opens Wing's payment page:

import 'package:flutter_wing_checkout/flutter_wing_checkout.dart';

final result = await WingCheckoutView.open(
  context,
  confirmUrl: confirmUrl, // from your server
  returnUrl: 'https://your-domain.com/wing/return', // as authorized
  cancelUrl: 'https://your-domain.com/wing/cancel',
);
switch (result?.status) {
  case WingCheckoutStatus.success:
    // ask your server to confirm with WingService.inquiry and the price
  case WingCheckoutStatus.failed:
  case WingCheckoutStatus.cancelled:
  case null: // back button
}

WingCheckoutView stops at the return or cancel URL without loading it. Use the widget directly to embed it in your own page, or WingCheckoutResult.match if you open Wing's page another way.

A redirect with status=success is not a proof of payment: confirm on your server with inquiry (or the callback) before delivering.

Platforms: Android, iOS, macOS, Windows and web, as supported by flutter_inappwebview. Follow its setup for each platform; on macOS, the app needs the com.apple.security.network.client entitlement.

onWebViewCreated gives the InAppWebViewController, for example to read the page or its cookies.

Example

example/ is a complete checkout: cart, authorization, Wing's page, confirmation with inquiry, and a receipt. It reads Wing UAT credentials from example/.env (flutter run --dart-define-from-file=.env) and keeps the server's part behind a PaymentBackend interface. Its live tests open Wing's real payment page:

cd example
flutter test integration_test -d macos --dart-define-from-file=.env

Paying in the Wing Bank app

For WingIntegrationType.mobileApp payments, Wing opens the deep link you registered with Wing after payment. Handle that link with your app's deep link setup (for example app_links), then confirm on your server.