Flutter支付网关插件paystack_gateway_payment的使用

Flutter支付网关插件paystack_gateway_payment的使用

A Flutter package that integrates the Paystack payment gateway to facilitate online transactions. 它提供了易于使用的服务来初始化和验证支付，并且在您的Flutter应用中提供了一个可定制的支付按钮小部件。

特性

• 使用Paystack API安全地初始化支付。
• 验证交易状态。
• 可定制的Paystack支付按钮。
• WebView来处理Paystack支付流程。

安装

在你的pubspec.yaml文件中添加以下依赖：

dependencies:
  paystack_gateway_payment: ^1.0.0

然后运行：

flutter pub get

使用

1. 设置Paystack服务

要初始化Paystack服务，你需要提供你的Paystack密钥：

import 'package:paystack_gateway_payment/services/paystack_service.dart';

final paystackService = PaystackService(secretKey: 'your-paystack-secret-key');

2. 初始化交易

要初始化支付，调用带有必要参数的initializeTransaction方法：

PaystackResponse response = await paystackService.initializeTransaction(
  email: 'user@example.com',
  amount: 1000,
  callbackUrl: 'https://your-callback-url.com',
);

这将返回一个包含交易详情的PaystackResponse，包括一个完成支付的授权URL。

3. 支付按钮

使用PaystackButton小部件在你的应用中提供一个支付按钮：

import 'package:paystack_gateway_payment/widgets/paystack_button.dart';

PaystackButton(
  paystackService: paystackService,
  email: 'user@example.com',
  amount: 1000,
  callbackUrl: 'https://your-callback-url.com',
  onSuccess: (reference) {
    print('Payment successful: $reference');
  },
  onError: (error) {
    print('Payment error: $error');
  },
)

4. WebView处理支付流程

该包包含一个PaystackWebView来处理Paystack支付过程：

import 'package:paystack_gateway_payment/paystack_webview.dart';

// 导航到WebView页面并传入授权URL
Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => PaystackWebView(
      authorizationUrl: response.data['authorization_url'],
      onSuccess: () {
        print('Payment successful');
      },
      onError: (error) {
        print('Payment failed: $error');
      },
    ),
  ),
);

错误处理

该包包含自定义异常用于错误处理。如果交易失败或有无效参数，它将抛出一个带有相关信息消息的PaystackException。

例如：

try {
  // 一些与支付相关的操作
} catch (e) {
  if (e is PaystackException) {
    print('Error: ${e.message}');
  }
}

示例

以下是一个完整的示例：

import 'package:flutter/material.dart';
import 'package:paystack_gateway_payment/services/paystack_service.dart';
import 'package:paystack_gateway_payment/widgets/paystack_button.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Paystack Payment Example',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: PaymentScreen(),
    );
  }
}

class PaymentScreen extends StatelessWidget {
  // 替换为你的实际Paystack密钥
  final String paystackSecretKey = 'sk_test_xxxxxxxx';

  [@override](/user/override)
  Widget build(BuildContext context) {
    final paystackService = PaystackService(secretKey: paystackSecretKey);

    return Scaffold(
      appBar: AppBar(title: const Text('Paystack Payment Example')),
      body: Center(
        child: PaystackButton(
          paystackService: paystackService,
          email: 'testuser@example.com',
          amount: 5000, // 金额以科博为单位（例如，5000 科博 = 50 NGN）
          callbackUrl: 'https://example.com/callback',
          buttonText: const Text('Pay Now'),
          paymentScreenTitle: '完成您的支付',
          onTransactionComplete: (status, response) {
            // 处理交易完成
            debugPrint('Transaction Status: $status');
            if (response != null) {
              debugPrint('Transaction Data: ${response.toString()}');
            }
          },
        ),
      ),
    );
  }
}