payracle_sdk 0.0.2

Official Flutter SDK for Payracle - integrating payment links, virtual accounts, and checkout interfaces easily.

Payracle SDK for Flutter

[Payracle Checkout Sheet]

A modern, type-safe Flutter SDK to integrate Payracle payment links, virtual accounts, and checkout interfaces easily into your Flutter mobile and web applications.

Features

• Instant Checkout Widget: Launch a premium centered payment modal featuring automated background transfer polling and countdown timers.
• Virtual Account Provisioning: Generate persistent virtual bank accounts for your customers directly from your backend or server-side Dart services.
• Sandbox Simulation: Test complete checkout success and failure flows inside sandbox mode using simulated payments.
• Robust API Client: Complete type-safe network mapping for virtual accounts, checkouts, and transactional queries.

Getting Started

Add payracle_sdk as a dependency in your pubspec.yaml:

dependencies:
  payracle_sdk: ^0.0.1

Then run:

flutter pub get

Usage

1. Initialize the Client

Configure the PayracleClient using your public key and business ID (or secret key for server-side code):

import 'package:payracle_sdk/payracle_sdk.dart';

final client = PayracleClient(
  apiKey: 'pk_live_your_public_key',
  businessId: 'biz_your_business_id',
);

2. Display the Payment Sheet

To launch the built-in, centered payment dialog with backdrop blur:

// Initialize checkout session details
final checkout = await client.initializeCheckout(
  CheckoutRequest(
    amount: 1500.0,
    email: '[e-mail]',
    title: 'Order #9928',
    description: 'Payment for running shoes',
  ),
);

// Show the centered payment modal sheet
await PayracleCheckoutSheet.show(
  context: context,
  client: client,
  checkoutData: checkout.data,
  onSuccess: (verifyResponse) {
    print('Payment completed: ${verifyResponse.data.reference}');
  },
  onCancelled: () {
    print('User closed checkout sheet');
  },
);

Additional Information

For more detailed documentation on integrating the Payracle APIs, webhooks, and gateway endpoints, visit Payracle Developer Docs.