Flutter支付集成插件stone_payments的使用

本插件是一个为Flutter开发提供的集成包，用于与Stone公司的支付机器进行交互。通过该插件，您可以轻松地在您的Flutter应用中处理支付事务。

安装

要使用此插件，您需要将stone_payments作为依赖项添加到您的pubspec.yaml文件中：

dependencies:
  stone_payments: ^0.1.7

然后运行flutter pub get以安装插件。

在项目的根目录下的local.properties文件中添加以下变量，并替换为您自己的token：

packageCloudReadToken=您的Token

确保您的minSdkVersion设置为23或更高：

minSdkVersion=23

注意！

支持的设备

• Positivo - L400
• Positivo - L300
• Ingenico - APOS A8
• Sunmi - P2
• Gertec - GPOS700X

使用

要在您的Flutter应用中使用Stone支付机器的集成，您需要遵循以下步骤：

1. 激活支付机器

await StonePayments.activateStone(
  appName: '我的应用',
  stoneCode: '12345678', // 从Stone团队获取的代码
  qrCodeProviderId: 'PROVIDER_ID', // 如果您将使用PIX，请提供由Stone集成团队提供的QR_CODE_PROVIDER_ID
  qrCodeAuthentication: 'TOKEN', // 如果您将使用PIX，请提供由Stone集成团队提供的QR_CODE_AUTHENTICATION
);

2. 开始支付交易

final transactionResult = await StonePayments.transaction(
  valor: 5,
  typeTransaction: TypeTransactionEnum.debit,
  parcelas: 1, // 可选参数
  printReceipt: false, // 可选参数：打印商户收据
  onPixQrCode: (value) {
    setState(() {
      image = base64Decode(value);
    });
  }, // 可选参数：接收PIX二维码的回调函数
);

transaction方法返回一个包含交易结果的Future<Transaction>对象，其中Transaction是一个具有以下属性的对象：

class Transaction {
  final String? acquirerTransactionKey;
  final String? actionCode;
  final String? aid;
  final String? amount;
  final String? appLabel;
  final String? arcq;
  final String? authorizationCode;
  final bool? capture;
  final String? cardBrand;
  final int? cardBrandId;
  final String? cardBrandName;
  final String? cardExpireDate;
  final String? cardHolderName;
  final String? cardHolderNumber;
  final String? cardSequenceNumber;
  final String? commandActionCode;
  final String? date;
  final String? entryMode;
  final String? iccRelatedData;
  final int? idFromBase;
  final String? initiatorTransactionKey;
  final String? instalmentTransaction;
  final String? instalmentType;
  final bool? isFallbackTransaction;
  final List<String>? qualifiers;
  final String? saleAffiliationKey;
  final String? serviceCode;
  final String? time;
  final String? timeToPassTransaction;
  final TransAppSelectedInfo? transAppSelectedInfo;
  final String? transactionReference;
  final String? transactionStatus;
  final String? typeOfTransactionEnum;
}

class TransAppSelectedInfo {
  final String? aid;
  final int? brandId;
  final String? brandName;
  final String? cardAppLabel;
  final String? paymentBusinessModel;
  final TransactionTypeInfo? transactionTypeInfo;
}

class TransactionTypeInfo {
  final String? appLabel;
  final int? id;
  final String? transTypeEnum;
}

3. 获取交易状态

StonePayments.onMessageListener((mensagem) {
  setState(() {
    texto = mensagem;
  });
});

4. 打印文本和图像

需要传递一个包含ItemPrintModel的列表给print方法，其中列表中的每个项目都是收据的一行，可以是文本或base64编码的图像。 base64编码的图像只能有最大尺寸为380x595像素，如Stone文档所述。

await StonePayments.print([
  const ItemPrintModel(
    type: ItemPrintTypeEnum.text,
    data: '测试标题',
  ),
  const ItemPrintModel(
    type: ItemPrintTypeEnum.text,
    data: '测试副标题',
  ),
  ItemPrintModel(
    type: ItemPrintTypeEnum.image,
    data: imgBase64,
  ),
]);

示例

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await StonePayments.activateStone(
    appName: '我的应用',
    stoneCode: '12345678',
    qrCodeAuthorization: 'TOKEN',
    qrCodeProviderId: 'PROVIDER_ID',
  );

  runApp(const MyApp());
}

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String text = '正在运行';
  late StreamSubscription<String> listen;
  Uint8List? image;

  [@override](/user/override)
  void initState() {
    listen = StonePayments.onMessageListener((message) {
      setState(() {
        text = message;
      });
    });

    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: SizedBox(
          width: double.infinity,
          child: SingleChildScrollView(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              crossAxisAlignment: CrossAxisAlignment.center,
              children: [
                Text(text),
                ElevatedButton(
                  onPressed: () async {
                    if (listen.isPaused) {
                      listen.resume();
                    }
                    try {
                      final result = await StonePayments.transaction(
                        value: 5,
                        typeTransaction: TypeTransactionEnum.pix,
                        onPixQrCode: (value) {
                          setState(() {
                            image = base64Decode(value);
                          });
                        },
                      );
                      print(result);
                    } catch (e) {
                      listen.pause();
                      setState(() {
                        text = "支付失败";
                      });
                    }
                  },
                  child: const Text('购买 R$5.00'),
                ),
                if (image != null)
                  Image.memory(
                    image!,
                    height: 200,
                  ),
                Image.asset('assets/flutter5786.png'),
                ElevatedButton(
                  onPressed: () async {
                    try {
                      var byteData = await rootBundle.load('assets/flutter5786.png');
                      var imgBase64 = base64Encode(byteData.buffer.asUint8List());

                      var items = [
                        const ItemPrintModel(
                          type: ItemPrintTypeEnum.text,
                          data: '测试标题',
                        ),
                        const ItemPrintModel(
                          type: ItemPrintTypeEnum.text,
                          data: '测试副标题',
                        ),
                        ItemPrintModel(
                          type: ItemPrintTypeEnum.image,
                          data: imgBase64,
                        ),
                      ];

                      await StonePayments.print(items);
                    } catch (e) {
                      setState(() {
                        text = "打印失败";
                      });
                    }
                  },
                  child: const Text('打印'),
                ),
                ElevatedButton(
                  onPressed: () async {
                    try {
                      await StonePayments.printReceipt(TypeOwnerPrintEnum.merchant);
                    } catch (e) {
                      setState(() {
                        text = "打印失败";
                      });
                    }
                  },
                  child: const Text('打印商户副本'),
                ),
                ElevatedButton(
                  onPressed: () async {
                    try {
                      await StonePayments.printReceipt(TypeOwnerPrintEnum.client);
                    } catch (e) {
                      setState(() {
                        text = "打印失败";
                      });
                    }
                  },
                  child: const Text('打印客户副本'),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}