Flutter支付插件kkiapay的使用

kkiapay_flutter_sdk 是一个开发友好的解决方案，允许你在应用或网站中接受移动货币和信用卡支付。

在使用此SDK之前，请确保你已经在 Kkiapay 上有一个正确的商户账户，否则请前往并免费创建你的账户。

安装

要使用此包，请在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  flutter:
    sdk: flutter
  kkiapay_flutter_sdk:

对于 Web 端，你需要在 index.html 文件中添加以下脚本：

<script src="https://cdn.kkiapay.me/k.js"></script>

使用

首先，引入 kkiapay_flutter_sdk 包：

import 'package:kkiapay_flutter_sdk/kkiapay_flutter_sdk.dart';

初始化 Kkiapay 实例

final kkiapay = KKiaPay(
    callback: Function(Map<String, dynamic> response, BuildContext context),
    amount: int, // 例如：1000
    apikey: String, // 例如：XXXX_public_api_key_XXX
    sandbox: bool, // 例如：true
    data: String, // 例如：'Big data'
    phone: String, // 例如："22961000000"
    name: String, // 例如："John Doe"
    reason: String, // 例如："交易原因"
    email: String, // 例如："email@mail.com"
    callbackUrl: String, // 例如："http://kkiapay.me"
    theme: String, // 例如："#222F5A"
    countries: List<String>, // 例如：["CI","BJ"]
    partnerId: String, // 例如：'AxXxXXxId'
    paymentMethods: List<String> // 例如：["momo","card"]
);

创建支付 WebView 实例

移动端：

Navigator.push(context, MaterialPageRoute(builder: (context) => kkiapay));

Web端：

kkiapayWeb.pay(kkiapay, (response){});

示例

以下是一个完整的示例代码：

import 'package:flutter/material.dart';
import 'package:kkiapay_flutter_sdk/kkiapay_flutter_sdk.dart';
import './successScreen.dart';

void main() => runApp(App());

void callback(response, context) {
  switch (response['status']) {
    case PAYMENT_CANCELLED:
      Navigator.pop(context);
      debugPrint(PAYMENT_CANCELLED);
      break;

    case PAYMENT_INIT:
      debugPrint(PAYMENT_INIT);
      break;

    case PENDING_PAYMENT:
      debugPrint(PENDING_PAYMENT);
      break;

    case PAYMENT_SUCCESS:
      Navigator.pop(context);
      Navigator.push(
        context,
        MaterialPageRoute(
          builder: (context) => SuccessScreen(
            amount: response['requestData']['amount'],
            transactionId: response['transactionId'],
          ),
        ),
      );
      break;

    default:
      debugPrint(UNKNOWN_EVENT);
      break;
  }
}

final kkiapay = KKiaPay(
    amount: 1000, // 金额
    countries: ["BJ","CI","SN","TG"], // 国家
    phone: "22961000000", // 手机号码
    name: "John Doe", // 姓名
    email: "email@mail.com", // 邮箱
    reason: 'Transaction reason', // 交易原因
    data: 'Fake data', // 数据
    sandbox: true, // 测试模式
    apikey: public_api_key, // API密钥
    callback: callback, // 回调函数
    theme: defaultTheme, // 主题颜色
    partnerId: 'AxXxXXxId', // 合作伙伴ID
    paymentMethods: ["momo","card"] // 支付方式
);

class App extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          backgroundColor: nColorPrimary,
          title: Text('Kkiapay Sample'),
          centerTitle: true,
        ),
        body: KkiapaySample(),
      ),
    );
  }
}

class KkiapaySample extends StatelessWidget {
  const KkiapaySample({
    Key? key,
  }) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Center(
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.center,
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ButtonTheme(
              minWidth: 500.0,
              height: 100.0,
              child: TextButton(
                style: ButtonStyle(
                  backgroundColor: MaterialStateProperty.all(Color(0xff222F5A)),
                  foregroundColor: MaterialStateProperty.all(Colors.white),
                ),
                child: const Text(
                  'Pay Now',
                  style: TextStyle(color: Colors.white),
                ),
                onPressed: () {
                  Navigator.push(
                    context,
                    MaterialPageRoute(builder: (context) => kkiapay),
                  );
                },
              ),
            ),
            const SizedBox(height: 50,),
            ButtonTheme(
              minWidth: 500.0,
              height: 100.0,
              child: TextButton(
                style: ButtonStyle(
                  backgroundColor: MaterialStateProperty.all(const Color(0xff222F5A)),
                  foregroundColor: MaterialStateProperty.all(Colors.white),
                ),
                child: const Text(
                  'Pay Now ( WEB )',
                  style: TextStyle(color: Colors.white),
                ),
                onPressed: () {
                  kkiapayWeb.pay(kkiapay, (response){});
                },
              ),
            )
          ],
        )
    );
  }
}

参考

successCallback 函数接受两个参数，顺序如下：

• 包含交易信息的 Map<String,dynamic>：

  {
    'requestData': {
      'amount': int,
      'phone': String,
      'reason': String,
      'data': String,
      'partnerId': String,
      'sandbox': bool,
      'name': String,
      'email': String
    },
    'transactionId': String, 
    'status': String 
  }