Flutter支付集成插件pesepay的使用

Pesepay

Pesepay 帮助非洲的企业从任何地方收款。

这个插件还在开发中！你可以尝试并贡献你的一份力量。

安装 💻

❗ 要开始使用 Pesepay，必须在你的机器上安装 Dart SDK。

在 pubspec.yaml 文件中添加 pesepay：

dependencies:
  pesepay:

安装它：

dart pub get

使用 🔥

导入包

import 'package:pesepay/pesepay.dart';

声明和初始化

final pesepay = Pesepay(
  integrationKey: '', // 你的集成密钥
  encryptionKey: '', // 加密密钥
  resultUrl: '', // 结果 URL
  returnUrl: '', // 返回 URL
);

获取活动货币列表

final List<Currency> currencies = await Pesepay.getActiveCurrencies();

示例货币：

Currency(
    name: "Zimbabwe Dollar", 
    description: "Zimbabwe Dollar", 
    code: "ZWL", 
    defaultCurrency: false,
    rateToDefault: 604.25,
    active: true
)

获取选定货币的支付方法列表

final List<PaymentMethod> methods = await Pesepay.getPaymentMethodsByCurrency(currency);

示例支付方法：

PaymentMethod(
  active: true,
  code: "PZW201",
  currencies: ["ZWL"], 
  description: "Make payment directly from your mobile phone.",
  id: 1,
  maximumAmount: 50000.0,
  minimumAmount: 2.0, 
  name: "Ecocash", 
  processingPaymentMessage: "Please enter PIN on the phone that is making the payment.",
  redirectRequired: false, 
  redirectURL: null, 
  requiredFields: [
    RequiredField(
      displayName: "Phone Number", 
      fieldType: "TEXT", 
      name: "customerPhoneNumber", 
      optional: false
    )
  ]
)

执行 Web 交易

这依赖于返回的 Web redirectUrl，客户可以使用该 URL 完成交易。

首先创建交易：

final Transaction transaction = pesepay.createTransaction(
  amount: 1,
  currencyCode: 'ZWL',
  transactionDescription: 'Bag of potatoes',
  transactionReference: '111-222-333'
);

然后处理交易：

final TransactionResponse response = await pesepay.initiateWebTransaction(transaction);

如果上述执行过程中出现任何错误（无论是包本身还是 Pesepay 服务器端），你应该会收到一个 PesepayException。因此，处理这种情况会很有帮助。

执行无缝交易

首先创建交易：

final SeamlessTransaction seamlessTransaction = pesepay.createSeamlessTransaction(
  customerName: 'Cool Name',
  customerEmail: 'yourmail@email.com',
  customerPhone: '0777111111',
  amount: 1,
  currencyCode: 'ZWL',
  transactionDescription: 'Banana Peel',
  transactionReference: '111-222-333',
  paymentMethodCode: paymentMethodCode,
);

处理无缝交易：

final TransactionResponse response = await pesepay.initiateSeamlessTransaction(seamlessTransaction);

检查交易状态

final TransactionResponse response = await pesepay.checkTransactionStatus(pollUrl);

无服务器结账？

与其使用延迟来检查交易状态，你还可以使用 stream 来获取 TransactionResponse 使用 pollUrl。

• pesepay.streamTransactionResponse(..) 接受一个必需的 pollUrl 字符串和可选的 streamInterval（以秒为单位），这是轮询 URL 的间隔，默认为 20 秒。
• 你可以使用 StreamBuilder 在 UI 上向用户显示当前的交易状态：

final String pollUrl = response.pollUrl;

// 在 Widget build(..) 方法中
// 你可以这样做
StreamBuilder(
  stream: pesepay.streamTransactionResponse(pollUrl),
  builder: (context, AsyncSnapshot<TransactionResponse> snapshot) {
    if(snapshot.hasData) {
      final TransactionResponse response = snapshot.data!;
      return response.paid ? SuccessWidget() : OtherWidgetsForErrorOrWaiting();
    } else {
      return CircularProgressIndicator();
    }
  }
)

完整使用示例

void main() async {
  try {
    final pesepay = Pesepay(
      integrationKey: '',
      encryptionKey: '',
      resultUrl: '',
      returnUrl: '',
    );

    final Transaction transaction = pesepay.createTransaction(
      amount: 1,
      currencyCode: 'ZWL',
      transactionDescription: 'Bag of potatoes',
      transactionReference: '111-222-333'
    );

    final TransactionResponse response = await pesepay.initiateWebTransaction(transaction);

    // 添加延迟以检查状态，可能 20-30 秒
    await Future.delayed(const Duration(seconds: 30));

    // 检查状态
    final TransactionResponse pollResponse = await pesepay.checkTransactionStatus(response.pollUrl);

    if (pollResponse.paid) {
      // 好吧，你成功了
      print('I deserve drinks 🍻');
    } else {
      // 不行啊，伙计
      print('👎🏿');
    }

  } on PesepayException catch (e) {
    print(e.message);
  } catch (e) {
    // 哎呀
  }
}