openpaymentplatform_flutter 1.0.0+1

A simple OpenPaymentPlatform API wrapper

openpaymentplatform_flutter

A Flutter package that provides integration with the OpenPaymentPlatform 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:
  openpaymentplatform_flutter: ^1.0.0

Then run:

flutter pub get

---

2. Initialize the SDK

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

---

Full Example

import 'package:flutter/material.dart';
import 'package:openpaymentplatform_flutter/openpaymentplatform_flutter.dart';

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

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

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

Inside OpenPaymentPlatformDemo:

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

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

  var request = OpenPaymentPlatformRequest(
    operation: OpenPaymentPlatformOperation.purchase,
    successUrl: "https://example.com/success",
    cancelUrl: "https://example.com/cancel",
    errorUrl: "https://example.com/error",
    expiryUrl: "https://example.com/expiry",
    order: OpenPaymentPlatformOrder(
      number: "order-1234",
      amount: "100.00",
      currency: "USD",
      description: "Example purchase",
    ),
    customer: Customer(name: "John Doe", email: "[e-mail]"),
    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: OpenPaymentPlatformCheckout(controller: _controller),
    ),
  ),
);

---

API Methods

Check Payment Status

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

Refund Payment

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

Void Payment

final result = await OpenPaymentPlatform().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