Flutter在线支付插件zarinpal的使用

Flutter在线支付插件Zarinpal的使用

插件简介

Zarinpal Package 是一个用于Flutter应用的在线支付插件，支持Android和iOS平台。它可以帮助开发者轻松集成Zarinpal支付网关，实现安全、便捷的支付功能。

使用方法

1. 初始化支付请求

首先，我们需要导入zarinpal包，并创建一个PaymentRequest对象来设置支付请求的参数。以下是一个简单的示例：

import 'package:zarinpal/zarinpal.dart';

void main() {
  // 初始化支付请求
  PaymentRequest _paymentRequest = PaymentRequest();

  // 设置是否为沙盒环境（开发模式）
  _paymentRequest.setIsSandBox(true); // 如果应用处于开发模式，请设置为true，否则设置为false

  // 设置商户ID
  _paymentRequest.setMerchantID("Zarinpal MerchantID"); // 替换为你的Zarinpal商户ID

  // 设置回调URL
  _paymentRequest.setCallbackURL("CallBack URL"); // 回调可以是Android Scheme或网站URL，你可以通过回调传递任何数据

  // 设置支付金额
  _paymentRequest.setAmount(1000); // 支付金额为整数

  // 设置支付描述
  _paymentRequest.setDescription("Payment Description");

  // 保存支付URL
  String? _paymentUrl;

  // 调用开始支付
  ZarinPal().startPayment(_paymentRequest, (int? status, String? paymentGatewayUri, data) {
    if (status == 100) {
      _paymentUrl = paymentGatewayUri; // 在浏览器中打开支付URL
      print("支付网关URL: $_paymentUrl");
    } else {
      print("启动支付失败，状态码: $status");
    }
  });
}

2. 验证支付结果

在用户完成支付后，你需要验证支付结果。根据你设置的回调方式（Scheme或网站URL），你可以获取支付的状态和授权码（Authority）。以下是验证支付的代码示例：

// 验证支付
ZarinPal().verificationPayment("Status", "Authority Call back", _paymentRequest, (bool isPaymentSuccess, String refID, PaymentRequest paymentRequest, data) {
  if (isPaymentSuccess) {
    // 支付成功
    print("支付成功，参考号: $refID");
  } else {
    // 支付失败
    print("支付失败，错误信息: $data");
  }
});

3. 注意事项

• 沙盒环境：在开发和测试阶段，建议将setIsSandBox(true)设置为true，以避免真实的资金交易。
• 回调URL：如果你使用的是Scheme回调（例如uni_links包），你需要在应用中处理Scheme回调，并从中提取Status和Authority参数。如果你使用的是网站URL回调，则不需要调用verificationPayment函数。
• 支付金额：支付金额必须为整数，单位为里亚尔（Rial）。

完整示例Demo

以下是一个完整的Flutter应用示例，展示了如何使用Zarinpal插件进行支付并验证支付结果：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: PaymentPage(),
    );
  }
}

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

class _PaymentPageState extends State<PaymentPage> {
  String? _paymentUrl;
  bool _isPaymentInProgress = false;
  String _paymentResult = "";

  void startPayment() async {
    setState(() {
      _isPaymentInProgress = true;
      _paymentResult = "";
    });

    // 初始化支付请求
    PaymentRequest _paymentRequest = PaymentRequest();

    // 设置是否为沙盒环境
    _paymentRequest.setIsSandBox(true);

    // 设置商户ID
    _paymentRequest.setMerchantID("Zarinpal MerchantID"); // 替换为你的Zarinpal商户ID

    // 设置回调URL
    _paymentRequest.setCallbackURL("CallBack URL"); // 替换为你的回调URL

    // 设置支付金额
    _paymentRequest.setAmount(1000); // 支付金额为1000里亚尔

    // 设置支付描述
    _paymentRequest.setDescription("Payment Description");

    // 调用开始支付
    ZarinPal().startPayment(_paymentRequest, (int? status, String? paymentGatewayUri, data) {
      if (status == 100) {
        setState(() {
          _paymentUrl = paymentGatewayUri;
          _isPaymentInProgress = false;
        });
      } else {
        setState(() {
          _isPaymentInProgress = false;
          _paymentResult = "启动支付失败，状态码: $status";
        });
      }
    });
  }

  void verifyPayment(String status, String authority) {
    ZarinPal().verificationPayment(status, authority, _paymentRequest, (bool isPaymentSuccess, String refID, PaymentRequest paymentRequest, data) {
      setState(() {
        if (isPaymentSuccess) {
          _paymentResult = "支付成功，参考号: $refID";
        } else {
          _paymentResult = "支付失败，错误信息: $data";
        }
      });
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("Zarinpal支付示例"),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: _isPaymentInProgress ? null : startPayment,
              child: _isPaymentInProgress
                  ? CircularProgressIndicator()
                  : Text("开始支付"),
            ),
            SizedBox(height: 20),
            if (_paymentUrl != null)
              TextButton(
                onPressed: () {
                  // 打开支付URL（可以使用url_launcher包）
                  // launch(_paymentUrl!);
                },
                child: Text("点击这里完成支付"),
              ),
            SizedBox(height: 20),
            if (_paymentResult.isNotEmpty) Text(_paymentResult),
          ],
        ),
      ),
    );
  }
}