flutter_akurateco

A Flutter package that provides integration with the Akurateco Payment Platform via WebView. It supports full-cycle operations including payment initialization, redirect handling, status checking, refunding, and voiding.

---

Features

• Seamless checkout experience using WebView
• Support for Purchase, Refund, Void, and Status Check operations
• Easy-to-use API for building custom payment flows
• Full control over redirect and error handling via callbacks

---

Getting Started

1. Install the package

Add this to your pubspec.yaml:

dependencies:
  flutter_akurateco: ^1.0.0

Then run:

flutter pub get

---

2. Initialize the SDK

Akurateco().initialize(
  backendUrl: 'backend-url',
  merchantKey: 'your-merchant-key',
  password: 'your-api-password',
);

---

Full Example

import 'package:flutter/material.dart';
import 'package:flutter_akurateco/akurateco_flutter.dart';

void main() => runApp(const AkuratecoExampleApp());

class AkuratecoExampleApp extends StatelessWidget {
  const AkuratecoExampleApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Akurateco Flutter Example',
      home: Scaffold(
        appBar: AppBar(title: const Text('Akurateco Example')),
        body: const Center(child: AkuratecoDemo()),
      ),
    );
  }
}

Inside AkuratecoDemo:

@override
void initState() {
  super.initState();

  Akurateco().initialize(
    backendUrl: 'https://checkout.transakcia.com',
    merchantKey: 'your-merchant-key',
    password: 'your-password',
  );

  var request = AkuratecoRequest(
    operation: AkuratecoOperation.purchase,
    successUrl: "https://example.com/success",
    cancelUrl: "https://example.com/cancel",
    errorUrl: "https://example.com/error",
    expiryUrl: "https://example.com/expiry",
    order: AkuratecoOrder(
      number: "order-1234",
      amount: "100.00",
      currency: "USD",
      description: "Example purchase",
    ),
    customer: Customer(name: "John Doe", email: "[email protected]"),
    billingAddress: BillingAddress(
      country: "US",
      state: "CA",
      city: "Los Angeles",
      district: "Beverlywood",
      address: "Moor Building",
      houseNumber: "17/2",
      zip: "123456",
      phone: "347771112233",
    ),
  );

  _controller = CheckoutController(
    paymentRequest: request,
    onSuccessRedirect: (url) => print("Success: $url"),
    onCancelRedirect: (url) => print("Cancelled: $url"),
    onErrorRedirect: (url) => print("Error: $url"),
    onRedirectCallback: (url) => print("Redirect: $url"),
    onError: (e) => print("Error: ${e.message}"),
  );
}

To open the payment screen:

showDialog(
  context: context,
  builder: (_) => Dialog(
    child: SizedBox(
      width: 400,
      height: 600,
      child: AkuratecoCheckout(controller: _controller),
    ),
  ),
);

---

API Methods

Check Payment Status

final status = await Akurateco().checkStatus(paymentId: '123');
print('Status: ${status.status}');

Refund Payment

final result = await Akurateco().refundPayment(
  paymentId: '123',
  amount: '100.00',
);

Void Payment

final result = await Akurateco().voidPayment(paymentId: '123');

---

Redirect Callbacks

Callback	Description
onSuccessRedirect	Called on success URL redirect
onCancelRedirect	Called on cancel URL redirect
onErrorRedirect	Called on error URL redirect
onRedirectCallback	Called on any redirect URL
onError	Called on WebView or initialization error