Flutter数字支付插件digitalpaye_sdk_flutter的使用

Digitalpaye Flutter SDK

Digitalpaye Flutter SDK 允许开发者在其 Flutter 应用程序中轻松集成通过 Digitalpaye 进行的支付。它提供了一个简单的界面来配置和启动支付交易。

安装

要安装 SDK，请使用以下命令：

flutter pub add digitalpaye_sdk_flutter

启动

配置

在使用 SDK 之前，需要使用您的 API 信息进行配置。您需要提供 API 密钥、API 秘密以及其他配置参数。

final config = DigitalpayeConfig(
  apiKey: 'live_digitalpaye92223061',
  apiSecret: 'f5231e4f4-d932-4fcd-a804-51539700d60c',
  isSandbox: false,
  color: AppColors.orange,
);

// DigitalpayeConfig 构造函数
DigitalpayeConfig({required String apiKey, required String apiSecret, required bool isSandbox, Color? color, String? logo});

• apiKey: 您的 API 密钥
• apiSecret: 您的 API 秘密
• isSandbox: 布尔值，指示环境是否为沙盒模式
• color: 应用程序的主要颜色
• logo: 应用程序的标志

支付配置

定义支付交易的参数。

final payment = DigitalpayePaymentConfig(
  codeCountry: DigitalpayeEnumCountries.ivoryCoast,
  amount: 10000.0,
  transactionId: paymentId,
  designation: "Vente de télévision",
  currency: DigitalpayeEnumCurrencies.xof,
  emailUser: "elieguei225@gmail.com",
  nameUser: "HELIE GUEI",
  customerId: "0777101308",
  urlError: "https://digitalpaye.com",
  urlSuccess: "https://digitalpaye.com",
);

• codeCountry: 国家代码
• amount: 交易金额
• transactionId: 交易 ID
• designation: 交易描述
• currency: 交易货币
• emailUser: 用户电子邮件
• nameUser: 用户姓名
• customerId: 客户 ID
• urlError: 错误 URL
• urlSuccess: 成功 URL

示例用法

以下是一个完整的示例，展示了如何在 Flutter 应用程序中使用 SDK。

import 'dart:math';
import 'package:digitalpaye_sdk_flutter/digitalpaye_sdk_flutter.dart';
import 'package:digitalpaye_sdk_flutter/enum/digitalpaye_enum_countries.dart';
import 'package:digitalpaye_sdk_flutter/enum/digitalpaye_enum_currencies.dart';
import 'package:digitalpaye_sdk_flutter/models/digitalpaye_config.dart';
import 'package:digitalpaye_sdk_flutter/models/digitalpaye_payment_config.dart';
import 'package:digitalpaye_sdk_flutter/utils/app_color.dart';
import 'package:flutter/material.dart';

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: HomePage(),
    );
  }
}

String generatePaymentId({int length = 20}) {
  const characters =
      'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
  final random = Random();
  return String.fromCharCodes(Iterable.generate(
    length,
    (_) => characters.codeUnitAt(random.nextInt(characters.length)),
  ));
}

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    final config = DigitalpayeConfig(
      apiKey: 'live_digitalpaye92223061',
      apiSecret: 'f5231e4f4-d932-4fcd-a804-51539700d60c',
      isSandbox: false,
      color: AppColors.orange,
    );
    return Scaffold(
      appBar: AppBar(title: const Text('Digitalpaye Flutter SDK 示例')),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            final paymentId = generatePaymentId();
            final payment = DigitalpayePaymentConfig(
              codeCountry: DigitalpayeEnumCountries.ivoryCoast,
              amount: 10000.0,
              transactionId: paymentId,
              designation: "Vente de télévision",
              currency: DigitalpayeEnumCurrencies.xof,
              emailUser: "elieguei225@gmail.com",
              nameUser: "HELIE GUEI",
              customerId: "0777101308",
              urlError: "https://digitalpaye.com",
              urlSuccess: "https://digitalpaye.com",
            );
            Navigator.push(
              context,
              MaterialPageRoute(
                builder: (context) => DigitalpayeFlutterSDK(
                  config: config,
                  payment: payment,
                  errorBuilder: (error) {
                    return Container();
                  },
                  successBuilder: (success) {
                    return Container();
                  },
                  pendingBuilder: (pending) {
                    return Container();
                  },
                ),
              ),
            );
          },
          child: const Text('现在付款'),
        ),
      ),
    );
  }
}