Flutter集成Sadad支付插件sadad_flutter_sdk的使用

Flutter集成Sadad支付插件sadad_flutter_sdk的使用

一个用于将Sadad支付SDK集成到你的Flutter应用中的插件。
该插件为原生的Sadad支付SDK提供了一个封装，使你能够在Flutter项目中使用它们。

开始使用

要在一个项目中使用Sadad Flutter插件，你需要创建一个Sadad账户并将其后端集成到系统中。以下是步骤：

1. 创建一个Sadad账户，并获取merchantId和secretKey。
2. 按照Sadad提供的集成指南将Sadad后端集成到你的系统中。
3. 通过调用后端的适当API端点从Sadad服务器获取交易令牌。

一旦你获得了交易令牌，你就可以开始使用了。

使用方法

1. 在pubspec.yaml文件中添加sadad_flutter_sdk依赖：

dependencies:
  sadad_flutter_sdk: ^0.0.5

1. 在代码中导入包：

import 'package:sadad_flutter_sdk/sadad_flutter_sdk.dart';

1. 创建一个包含必要参数的SadadTransaction对象：

var transaction = SadadTransaction(
  email: "a3bd2llah@gmail.com",
  mobileNumber: "97431487378",
  customerId: "123456789",
  clientToken: "put the obtained token here", // 请替换为获取到的令牌
  transactionAmount: "10000.0",
  orderItems: [const SadadOrderItem(name: "top up", quantity: 1, amount: 10000)],
  orderId: "123456789",
);

注意：clientToken是从Sadad获取的令牌。

1. 调用createTransaction方法以启动支付过程：

String result;

final sadadFlutterSdkPlugin = SadadFlutterSdk();
try {
  result = await _sadadFlutterSdkPlugin.createTransaction(transaction) ?? 'null';
} on PlatformException {
  result = 'Platform Exception';
}

结果应包含事务编号（如果事务成功或失败）。然而，在某些情况下，结果可能是空的：

• 如果API调用出现错误，结果可能为空。
• 如果事务数据格式不正确，结果可能为空。
• 如果用户取消了交易，结果可能为空。

现在，你已经在Flutter应用中集成了Sadad SDK。

注意事项

请注意，由于Sadad SDK的限制，Sadad Flutter SDK插件在iOS模拟器上无法运行。如果你需要在iOS模拟器上测试你的应用，可以使用sadad_flutter_ios_simulator插件，它提供了在iOS模拟器上进行Sadad支付集成的模拟环境。

要使用sadad_flutter_ios_simulator插件，可以使用与这里提供的相同示例代码，但需要导入以下内容：

import 'package:sadad_flutter_ios_simulator/sadad_flutter_ios_simulator.dart';

注意：如果你在同一时间在应用中同时使用sadad_flutter_sdk和sadad_flutter_ios_simulator两个包，可能会导致iOS上的包命名冲突错误。因此，根据你的测试和部署需求，只能选择其中一个包来使用。

示例代码

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

import 'package:flutter/services.dart';
import 'package:sadad_flutter_sdk/sadad_flutter_sdk.dart';

void main() {
  runApp(const MyApp());
}

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

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

class _MyAppState extends State<MyApp> {
  String _sadadResponse = 'did not start yet';

  [@override](/user/override)
  void initState() {
    super.initState();
    startSadadTransaction();
  }

  Future<void> startSadadTransaction() async {
    String result;

    final _sadadFlutterSdkPlugin = SadadFlutterSdk();
    var transaction = SadadTransaction(
      email: "a3bd2llah@gmail.com",
      mobileNumber: "97431487378",
      customerId: "123456789",
      clientToken: "put your token here", // 请替换为获取到的令牌
      transactionAmount: "10000.0",
      orderItems: [const SadadOrderItem(name: "top up", quantity: 1, amount: 10000)],
      orderId: "123456789",
    );
    try {
      result = await _sadadFlutterSdkPlugin.createTransaction(transaction) ?? 'null';
    } on PlatformException {
      result = 'Platform Exception';
    }

    if (!mounted) return;

    setState(() {
      _sadadResponse = result;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Text('Sadad结果是: $_sadadResponse\n'),
        ),
      ),
    );
  }
}