Flutter埃塞俄比亚货币转换插件flutter_telebirr的使用

Flutter埃塞俄比亚货币转换插件flutter_telebirr的使用

1. 插件简介

flutter_telebirr 是一个用于集成Telebirr支付API的Flutter SDK。通过这个插件，你可以轻松地在Flutter应用中实现Telebirr支付功能。

2. 功能特性

• 获取支付URL：通过Telebirr SDK API获取支付URL (toPayUrl)，用户可以通过该URL完成支付。

3. 入门指南

3.1 必要的密钥

为了使用此插件，你需要从Telebirr获取以下密钥：

• appId: 应用ID
• appKey: 应用密钥
• publicKey: 公钥
• test url: 测试模式下的URL（可选）

3.2 添加依赖

在你的 pubspec.yaml 文件中添加 flutter_telebirr 依赖：

dependencies:
  flutter_telebirr: ^0.0.4

3.3 配置网络权限

为了让应用能够访问Telebirr API，你需要为Android和iOS配置网络权限。

3.3.1 Android

在 AndroidManifest.xml 文件中添加以下权限：

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

如果你需要使用Telebirr的测试URL，请确保在 application 标签中添加以下属性：

<application ... android:usesCleartextTraffic="true">

3.3.2 iOS

在 Info.plist 文件中添加以下内容：

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

4. 使用方法

4.1 配置Telebirr支付

在使用Telebirr支付之前，你需要先进行配置。如果使用测试模式，请确保传递Telebirr提供的测试URL，并且不要在URL末尾包含 /toTradeSDKPay，而是使用如下格式：http://<IP>:<PORT>/service-openup。

import 'package:flutter_telebirr/flutter_telebirr.dart';

void configureTelebirr() {
  TelebirrPayment.instance.configure(
    publicKey: 'your_public_key',
    appId: '<appId>',
    appKey: "<appKey>",
    notifyUrl: "https://localhost/notifyUrl", // 回调URL
    shortCode: "<shortCode>", // 商户短码
    merchantDisplayName: "Organization name", // 商户显示名称
    mode: Mode.test, // 设置为测试模式
    testUrl: 'http://<IP>:<PORT>/service-openup', // 测试URL
  );
}

4.2 发起支付

配置完成后，你可以通过调用 startPayment 方法发起支付请求，并传递商品名称和总金额。

Future<void> startPayment() async {
  try {
    final response = await TelebirrPayment.instance.startPayment(
      itemName: "Goods name", // 商品名称
      totalAmount: "10", // 总金额
    );

    if (response != null && response.isSuccess) {
      // 支付成功，获取支付URL
      String toPayUrl = response.data?.toPayUrl ?? '';
      print('支付URL: $toPayUrl');

      // 你可以使用WebView或其他方式加载支付URL
      // 例如：
      // launchUrl(Uri.parse(toPayUrl));
    } else {
      print('支付失败: ${response.message}');
    }
  } catch (e) {
    print('支付过程中发生错误: $e');
  }
}

4.3 完整示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中集成Telebirr支付功能。

import 'package:flutter/material.dart';
import 'package:flutter_telebirr/flutter_telebirr.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Telebirr Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: Home(),
    );
  }
}

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

class _HomeState extends State<Home> {
  [@override](/user/override)
  void initState() {
    super.initState();
    // 配置Telebirr支付
    configureTelebirr();
  }

  void configureTelebirr() {
    TelebirrPayment.instance.configure(
      publicKey: 'your_public_key',
      appId: '<appId>',
      appKey: "<appKey>",
      notifyUrl: "https://localhost/notifyUrl",
      shortCode: "<shortCode>",
      merchantDisplayName: "Organization name",
      mode: Mode.test,
      testUrl: 'http://<IP>:<PORT>/service-openup',
    );
  }

  Future<void> startPayment() async {
    try {
      final response = await TelebirrPayment.instance.startPayment(
        itemName: "Goods name",
        totalAmount: "10",
      );

      if (response != null && response.isSuccess) {
        String toPayUrl = response.data?.toPayUrl ?? '';
        print('支付URL: $toPayUrl');

        // 你可以使用WebView或其他方式加载支付URL
        // 例如：
        // launchUrl(Uri.parse(toPayUrl));
      } else {
        print('支付失败: ${response.message}');
      }
    } catch (e) {
      print('支付过程中发生错误: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Telebirr支付示例'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: startPayment,
          child: Text('发起支付'),
        ),
      ),
    );
  }
}