Flutter支付集成插件CinetPay的使用

🚀 CinetPay支付集成 👋

该包允许您调用 CinetPay支付网关，执行支付并等待支付完成后的状态。

🔗 使用步骤

使用此包非常简单，只需调用它，并提供以下内容：

• 初始化网关所需的参数
• 支付相关信息
• 支付结果回调
• 错误处理回调

🛠 预备条件

Android

在 android/app/src/main/AndroidManifest.xml 文件中添加权限：

<application
    ...
    android:usesCleartextTraffic="true">
    ...
</application>
...
<uses-permission android:name="android.permission.INTERNET"/>

修改 minSdkVersion 和 compileSdk 版本（在 android/app/build.gradle 文件中）：

minSdkVersion >= 19
compileSdk >= 34

iOS

在 ios/Runner/Info.plist 文件中添加权限：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

初始化网关

网关需要接收以下数据才能正常工作：

• apikey: 商户ID (必填)
• site_id: 服务ID (必填)
• notify_url: 有效的支付通知URL (必填)

支付信息

为准备支付网关，需提交以下数据：

• amount: 支付金额 (>100 XOF) (必填)
• currency: 支付货币 (XOF, XAF, CDN, GNF, USD) (必填)
• transaction_id: 唯一交易ID (必填)
• description: 支付描述 (必填)
• channels: 支付渠道 (可选，默认为’ALL’)
• metadata: 元数据 (可选)

支付结果回调

当支付完成后，将返回以下格式的结果：

• amount: 支付金额
• currency: 支付货币
• status: 支付状态 (ACCEPTED 或 REFUSED)
• payment_method: 支付方式
• description: 支付描述
• metadata: 元数据
• operator_id: 操作员支付ID
• payment_date: 支付日期

错误处理回调

错误处理将返回以下格式的结果：

• message: 错误消息
• description: 错误描述

👩‍💻 包的使用示例

以下是一个完整的Flutter应用程序示例，演示了如何使用CinetPay进行支付：

import 'dart:async';
import 'dart:math';

import 'package:cinetpay/cinetpay.dart';
import 'package:flutter/material.dart';
import 'package:get/get.dart';

Future main() async {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  TextEditingController amountController = TextEditingController();
  Map<String, dynamic>? response;
  Color? color;
  IconData? icon;
  String? message;
  bool show = false;

  @override
  Widget build(BuildContext context) {
    const String title = 'CinetPay Demo';
    return GetMaterialApp(
      title: title,
      theme: ThemeData(
        primarySwatch: Colors.green,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: Scaffold(
        appBar: AppBar(
          title: const Text(title),
          centerTitle: true,
        ),
        body: SafeArea(
          child: Center(
            child: ListView(
              shrinkWrap: true,
              children: [
                Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    if (show) Icon(icon, color: color, size: 150),
                    if (show) Text(message!),
                    if (show) const SizedBox(height: 50.0),
                    const Text(
                      "Example integration Package for Flutter",
                      style: TextStyle(fontSize: 30, fontWeight: FontWeight.bold),
                      textAlign: TextAlign.center,
                    ),
                    const SizedBox(height: 50.0),
                    const Text(
                      "Cart informations.",
                      style: TextStyle(fontSize: 24, fontWeight: FontWeight.bold),
                    ),
                    const SizedBox(height: 50.0),
                    Container(
                      padding: const EdgeInsets.symmetric(horizontal: 20.0),
                      margin: const EdgeInsets.symmetric(horizontal: 50.0),
                      decoration: BoxDecoration(
                        borderRadius: BorderRadius.circular(12.0),
                        border: Border.all(color: Colors.green),
                      ),
                      child: TextField(
                        controller: amountController,
                        decoration: const InputDecoration(
                          hintText: "Amount",
                          border: InputBorder.none,
                        ),
                        keyboardType: TextInputType.number,
                      ),
                    ),
                    const SizedBox(height: 40.0),
                    ElevatedButton(
                      child: const Text("Pay with CinetPay"),
                      onPressed: () async {
                        final String amount = amountController.text.trim();
                        if (amount.isEmpty) {
                          // 显示警告
                          return;
                        }

                        try {
                          double _amount = double.parse(amount);

                          if (_amount < 100 || _amount > 1500000) {
                            // 显示警告
                            return;
                          }
                        } catch (_) {
                          return;
                        }

                        amountController.clear();

                        final String transactionId = Random().nextInt(100000000).toString();

                        await Get.to(CinetPayCheckout(
                          title: 'Payment Checkout',
                          titleStyle: const TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
                          titleBackgroundColor: Colors.green,
                          configData: {
                            'apikey': 'YOUR_API_KEY',
                            'site_id': int.parse("YOUR_SITE_ID"),
                            'notify_url': 'YOUR_NOTIFY_URL'
                          },
                          paymentData: {
                            'transaction_id': transactionId,
                            'amount': double.parse(amount),
                            'currency': 'XOF',
                            'channels': 'ALL',
                            'description': 'Payment test',
                          },
                          waitResponse: (data) {
                            if (mounted) {
                              setState(() {
                                response = data;
                                print(response);
                                icon = data['status'] == 'ACCEPTED'
                                    ? Icons.check_circle
                                    : Icons.mood_bad_rounded;
                                color = data['status'] == 'ACCEPTED'
                                    ? Colors.green
                                    : Colors.redAccent;
                                show = true;
                                Get.back();
                              });
                            }
                          },
                          onError: (data) {
                            if (mounted) {
                              setState(() {
                                response = data;
                                message = response!['description'];
                                print(response);
                                icon = Icons.warning_rounded;
                                color = Colors.yellowAccent;
                                show = true;
                                Get.back();
                              });
                            }
                          },
                        ));
                      },
                    )
                  ],
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

😄 作者

AGBETOGOR Germain (Germinator)

如需更多信息，请联系支持团队。