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 #