Flutter支付集成插件sadadpay_flutter的使用

Flutter支付集成插件sadadpay_flutter的使用

特性

Sadad SDK用于简化与Sadad REST API在移动应用中的集成。

• 生成刷新令牌
• 生成访问令牌
• 创建发票
• 通过ID获取发票
• 提供一个Web视图进行支付流程

安装

要使用此包，请将其添加到您的项目中。

使用命令行安装

运行以下命令：

$ flutter pub add sadadpay_flutter

这将在您的项目的pubspec.yaml文件中添加如下依赖项（并运行隐式的flutter pub get）：

dependencies:
  sadadpay_flutter: ^0.0.3

在Dart代码中导入

在Dart代码中，可以这样导入：

import 'package:sadadpay_flutter/config/env.dart';
import 'package:sadadpay_flutter/interceptors/authorization_interceptor.dart';
import 'package:sadadpay_flutter/sadadpay.dart';
import 'package:sadadpay_flutter/service/payment_status.dart';
import 'package:sadadpay_flutter/service/sadad_service.dart';
import 'package:sadadpay_flutter/widgets/web_view.dart';

代码片段详情

生成刷新令牌

使用generateRefreshToken方法生成刷新令牌。该方法返回JSON对象。

sadadPay.generateRefreshToken(clientKey: _clientKey, clientSecret: _clientSecret).then(
    (value) => _refreshToken = value['response']['refreshToken']);

生成访问令牌

使用generateAccessToken方法生成访问令牌。该方法返回JSON对象。

sadadPay.generateAccessToken(refreshToken: _refreshToken).then(
    (value) => _accessToken = value['response']['accessToken']);

创建发票

使用createInvoice方法创建发票。该方法返回JSON对象。

final invoices = {
    "Invoices": [
      {
        "amount": "10",
        "customer_Name": "customer",
        "customer_Email": "customer@example.com",
        "lang": "en",
        "currency_Code": "KWD",
        "items": [
          {"name": "x", "quantity": 2, "amount": 2},
          {"name": "y", "quantity": 6, "amount": 1}
        ]
      }
    ]
  };

sadadPay.createInvoice(invoices: invoices, token: _accessToken).then(
        (value) => setState(() => _invoiceId = value['response']['invoiceId']));

获取发票

使用getInvoice方法通过ID获取发票。该方法返回JSON对象。

sadadPay.getInvoice(invoiceId: _invoiceId, token: _accessToken).then(
        (value) => setState(() => _invoiceKey = value['response']['key']));

使用Sadad Web视图

使用SadadWebView来展示支付页面。该方法返回一个Widget。

[@override](/user/override)
Widget build(BuildContext context) {
  if (_invoiceKey != '') {
    return SadadWebView(
      invoiceKey: _invoiceKey,
      onSuccess: () {
        Navigator.push(
          context,
          MaterialPageRoute(builder: (context) => const SuccessPage()),
        );
      },
      onFail: () {
        Navigator.push(
          context,
          MaterialPageRoute(builder: (context) => const FailPage()),
        );
      },
      appBar: AppBar(
        title: const Text('App Bar'),
      ),
    );
  } else {
    return const CircularProgressIndicator();
  }
}

完整示例

以下是一个完整的示例，展示了如何使用sadadpay_flutter插件进行支付集成。

import 'package:flutter/material.dart';
import 'package:sadadpay_flutter/config/env.dart';
import 'package:sadadpay_flutter/sadadpay.dart';
import 'package:sadadpay_flutter/widgets/web_view.dart';

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

class SadadDemo extends StatelessWidget {
  const SadadDemo({super.key});
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Sadad Demo',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Sadad Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});
  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  // 设置您的clientKey和clientSecret，它们必须存储在一个安全的地方，例如数据库。
  final String _clientKey = "xxxxxxxxxxxx";
  final String _clientSecret = "xxxxxxxxxxxx";
  late String _refreshToken;
  late String _accessToken;
  late String _invoiceId;
  late String _invoiceUrl = "";
  final invoices = {
    "Invoices": [
      {
        "amount": "10",
        "customer_Name": "Bondok",
        "customer_Email": "bondok@sadadkw.com",
        "lang": "en",
        "currency_Code": "KWD",
        "items": [
          {"name": "Orange", "quantity": 2, "amount": 2},
          {"name": "Apple", "quantity": 6, "amount": 1}
        ]
      }
    ]
  };

  SadadPay sadadPay = SadadPay(env: Environment.stage);

  Future<void> initPaymentProcess() async {
    await sadadPay
        .generateRefreshToken(
            clientKey: _clientKey, clientSecret: _clientSecret)
        .then((value) => _refreshToken = value['response']['refreshToken']);
    await sadadPay
        .generateAccessToken(refreshToken: _refreshToken)
        .then((value) => _accessToken = value['response']['accessToken']);
    await sadadPay.createInvoice(invoices: invoices, token: _accessToken).then(
        (value) => setState(() => _invoiceId = value['response']['invoiceId']));
    await sadadPay.getInvoice(invoiceId: _invoiceId, token: _accessToken).then(
        (value) => setState(() => _invoiceUrl = value['response']['url']));
  }

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    if (_invoiceUrl != '') {
      return SadadWebView(
        url: _invoiceUrl,
        onSuccess: () {
          Navigator.push(
            context,
            MaterialPageRoute(builder: (context) => const SuccessPage()),
          );
        },
        onFail: () {
          Navigator.push(
            context,
            MaterialPageRoute(builder: (context) => const FailPage()),
          );
        },
        appBar: AppBar(
          title: const Text('App Bar'),
        ),
      );
    } else {
      return const CircularProgressIndicator();
    }
  }
}

class SuccessPage extends StatelessWidget {
  const SuccessPage({super.key});
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('App Bar'),
      ),
      body: const Center(
        child: Text('On Success page'),
      ),
    );
  }
}

class FailPage extends StatelessWidget {
  const FailPage({super.key});
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('App Bar'),
      ),
      body: const Center(
        child: Text('On Fail page'),
      ),
    );
  }
}