Flutter支付集成插件sb_payment_sdk的使用

特性

此文档介绍了如何在Flutter应用中使用sb_payment_sdk插件进行支付集成。

开始使用

导入必要的包

首先，需要在项目中导入以下依赖包：

import 'package:sb_payment_sdk/sb_payment_sdk.dart';
import 'package:sb_payment_sdk/models/charge_model.dart';
import 'package:sb_payment_sdk/models/api_response.dart';

初始化插件

在使用插件之前，需要调用initialize方法进行初始化。参数包括是否为生产环境（isLive）和公钥（publicKey）。

StartButtonPlugin _paymentPlugin = StartButtonPlugin();
_paymentPlugin.initialize(isLive: false, publicKey: "sb_e73bc345*************2bc08442957****8db719f*******12c0");

说明：

• isLive: 如果设置为true，表示当前环境为生产环境；如果设置为false，表示测试环境。
• publicKey: 从支付服务提供商获取的公钥。

执行支付操作

通过调用makePayment方法发起支付请求。以下是示例代码：

const _reference = ""; // 生成一个随机字符串作为交易参考号
num _amount = 2000; // 支付金额（单位为分）
APIResponse response = await _paymentPlugin.makePayment(
  context, // 当前上下文
  charge: Payment( 
    amount: _amount, // 支付金额
    email: "example@gmail.com", // 用户邮箱
    currencyType: CurrencyType.NGN, // 货币类型
    reference: _reference // 交易参考号
  )
);

说明：

• _reference: 随机生成的交易参考号，用于标识该笔交易。
• _amount: 支付金额，单位通常为“分”。例如，2000表示20.00。
• CurrencyType.NGN: 表示货币类型为尼日利亚奈拉（NGN），可根据实际需求替换为其他货币类型。

处理支付结果

支付完成后，插件会返回一个APIResponse对象。根据支付状态处理不同的逻辑。

成功支付示例

成功支付后，响应数据可能如下所示：

var data = {
  "reference": "reference",
  "amount": 2000,
  "email": "example@gmail.com",
  "currency": "NGN",
  "bankName": "",
  "accountName": "",
  "accountNumber": "",
  "paymentStatus": "successful",
  "paymentType": "Paystack",
  "paymentDate": "2024-03-19T18:42:51.757Z"
};

错误支付示例

如果支付失败，插件会返回错误信息。例如：

var data = {
  "error": "Invalid email address",
  "message": "Please check your email and try again."
};

完整示例代码

以下是一个完整的示例代码，展示了如何在Flutter中集成sb_payment_sdk插件并完成支付流程：

import 'package:flutter/material.dart';
import 'package:sb_payment_sdk/sb_payment_sdk.dart';
import 'package:sb_payment_sdk/models/charge_model.dart';
import 'package:sb_payment_sdk/models/api_response.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: PaymentScreen(),
    );
  }
}

class PaymentScreen extends StatefulWidget {
  [@override](/user/override)
  _PaymentScreenState createState() => _PaymentScreenState();
}

class _PaymentScreenState extends State<PaymentScreen> {
  final StartButtonPlugin _paymentPlugin = StartButtonPlugin();

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化插件
    _paymentPlugin.initialize(isLive: false, publicKey: "sb_e73bc345*************2bc08442957****8db719f*******12c0");
  }

  Future<void> makePayment() async {
    const _reference = "random_reference_123"; // 随机生成的参考号
    num _amount = 2000; // 支付金额（单位为分）

    try {
      APIResponse response = await _paymentPlugin.makePayment(
        context,
        charge: Payment(
          amount: _amount,
          email: "example@gmail.com",
          currencyType: CurrencyType.NGN,
          reference: _reference
        )
      );

      if (response.success) {
        // 成功支付后的处理逻辑
        print("Payment Successful: ${response.data}");
      } else {
        // 支付失败后的处理逻辑
        print("Payment Failed: ${response.error}");
      }
    } catch (e) {
      print("Error during payment: $e");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SB Payment SDK Example'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: makePayment,
          child: Text('Make Payment'),
        ),
      ),
    );
  }
}