Flutter支付集成插件shurjopay的使用

这是官方的shurjoPay flutter包，供商家或服务提供商将其支付系统集成到他们的Flutter应用程序中。目前，它仅支持Android和iOS。

shurjoPay flutter包通过两个方法调用使支付系统更加简单：

• makePayment()
• verifyPayment()

仅此而已！要了解更多信息，请参阅下面的详细说明。

添加包依赖到应用

1. 打开应用文件夹内的pubspec.yaml文件，并在dependencies下添加shurjopay: ^2.0.6。
2. 运行命令flutter pub get以拉取并下载依赖项。

使用

初始化shurjoPay

首先，您必须在使用之前通过调用initializeShurjopay()并传递环境类型作为参数来初始化shurjoPay。

示例：

void main() {
  initializeShurjopay(environment: "sandbox");
  runApp(const MyApp());
}

基本使用示例

创建一个shurjoPay对象。

ShurjoPay shurjoPay = ShurjoPay();

创建支付请求模型并初始化值。

// 创建ShurjopayConfigs对象并设置值，以便您可以在这里传递它。
ShurjopayRequestModel shurjopayRequestModel = ShurjopayRequestModel(
  configs: shurjopayConfigs,
  currency: "BDT",
  amount: 1000,
  // 记住在订单ID前加前缀。例如：如果前缀是'test'，则订单ID应为test123456
  orderID: "sp1ab2c3d4",
  discountAmount: 0,
  discountPercentage: 0,
  customerName: "Shajedul Islam",
  customerPhoneNumber: "01628734916",
  customerAddress: "customer address",
  customerCity: "customer city",
  customerPostcode: "1212",
  returnURL: "return_url",
  cancelURL: "cancel_url",
);

创建一个支付响应模型对象以存储makePayment()方法的结果。

ShurjopayResponseModel shurjopayResponseModel = ShurjopayResponseModel();

调用makePayment()方法以启动支付过程。

shurjopayResponseModel = await shurjoPay.makePayment(
  context: context,
  shurjopayRequestModel: shurjopayRequestModel,
);

创建一个验证响应模型对象以存储verifyPayment()方法的结果。

ShurjopayVerificationModel shurjopayVerificationModel = ShurjopayVerificationModel();

如果makePayment()方法结果的状态为true，则可以在任何时候通过调用verifyPayment()方法来验证支付。

if (shurjopayResponseModel.status == true) {
  try {
    shurjopayVerificationModel = await shurjoPay.verifyPayment(
      orderID: shurjopayResponseModel.shurjopayOrderID!,
    );
    if (shurjopayVerificationModel.spCode == "1000") {
      print("Payment Varified");
    }
  } catch (error) {
    print(error.toString());
  }
}

完整示例代码

以下是一个完整的示例代码，展示了如何在应用中集成shurjoPay。

// ignore_for_file: avoid_print

import 'package:flutter/material.dart';
import 'package:pro_widgets/pro_widgets.dart';
import 'package:shurjopay/models/config.dart';
import 'package:shurjopay/models/payment_verification_model.dart';
import 'package:shurjopay/models/shurjopay_request_model.dart';
import 'package:shurjopay/models/shurjopay_response_model.dart';
import 'package:shurjopay/shurjopay.dart';
import 'package:shurjopay/utilities/functions.dart';

void main() {
  initializeShurjopay(environment: "sandbox");
  runApp(const MyApp());
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'shurjoPay Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

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

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  ShurjoPay shurjoPay = ShurjoPay();

  ShurjopayConfigs shurjopayConfigs = ShurjopayConfigs(
    prefix: "NOK",
    userName: "sp_sandbox",
    password: "pyyk97hu&6u6",
    clientIP: "127.0.0.1",
  );

  ShurjopayResponseModel shurjopayResponseModel = ShurjopayResponseModel();
  ShurjopayVerificationModel shurjopayVerificationModel = ShurjopayVerificationModel();

  TextEditingController nameFieldController = TextEditingController();
  TextEditingController amountFieldController = TextEditingController();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('shurjoPay Demo'),
        backgroundColor: Colors.green,
      ),
      body: Center(
        child: Padding(
          padding: const EdgeInsets.all(16),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ProTextField(
                hint: "Enter Name",
                controller: nameFieldController,
                height: 45,
              ),
              const ProGap(y: 16),
              ProTextField(
                hint: "Enter Amount",
                controller: amountFieldController,
                height: 45,
              ),
              const ProGap(y: 16),
              ProButtonBasic(
                text: "Pay",
                fontSize: 18,
                backgroundColor: Colors.green,
                height: 45,
                width: double.infinity,
                onTap: () async {
                  FocusScope.of(context).unfocus();
                  ShurjopayRequestModel shurjopayRequestModel = ShurjopayRequestModel(
                    configs: shurjopayConfigs,
                    currency: "BDT",
                    amount: double.parse(amountFieldController.text),
                    orderID: "sp1ab2c3d4",
                    discountAmount: 0,
                    discountPercentage: 0,
                    customerName: nameFieldController.text,
                    customerPhoneNumber: "01711486915",
                    customerAddress: "customer address",
                    customerCity: "customer city",
                    customerPostcode: "1212",
                    // 测试：https://www.sandbox.shurjopayment.com/return_url
                    returnURL: "https://www.sandbox.shurjopayment.com/return_url",
                    // 测试：https://www.sandbox.shurjopayment.com/cancel_url
                    cancelURL: "https://www.sandbox.shurjopayment.com/cancel_url",
                  );
                  shurjopayResponseModel = await shurjoPay.makePayment(
                    context: context,
                    shurjopayRequestModel: shurjopayRequestModel,
                  );
                  if (shurjopayResponseModel.status == true) {
                    try {
                      shurjopayVerificationModel = await shurjoPay.verifyPayment(
                        orderID: shurjopayResponseModel.shurjopayOrderID!,
                      );
                      print(shurjopayVerificationModel.spCode);
                      print(shurjopayVerificationModel.spMessage);
                      if (shurjopayVerificationModel.spCode == "1000") {
                        print("Payment Varified");
                      }
                    } catch (error) {
                      print(error.toString());
                    }
                  }
                  nameFieldController.clear();
                  amountFieldController.clear();
                },
              )
            ],
          ),
        ),
      ),
    );
  }
}

以上就是所有内容！现在您可以使用我们的shurjoPay flutter包，使您的支付系统变得简单和流畅。