Flutter支付插件idpay的使用

idpay 是一个用于集成 IDPay 支付网关的 Flutter 插件。IDPay 是一个伊朗的在线支付网关，允许用户通过多种方式进行支付，包括银行卡、电子钱包等。

以下是如何在 Flutter 项目中使用 idpay 插件的步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 idpay 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  idpay: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在你的 Dart 文件中导入 idpay 插件：

import 'package:idpay/idpay.dart';

3. 初始化 IDPay

在使用 IDPay 进行支付之前，你需要初始化插件。通常你需要在应用的某个地方（例如 main.dart 或支付页面的 initState 方法中）进行初始化。

void initState() {
  super.initState();
  IdPay.initialize(
    apiKey: 'YOUR_API_KEY',  // 你的 IDPay API Key
    sandbox: true,  // 是否使用沙盒环境，测试时设置为 true，生产环境设置为 false
  );
}

4. 发起支付请求

你可以使用 IdPay.startPayment 方法来发起支付请求。这个方法需要传入 IdPayRequest 对象，该对象包含支付所需的信息。

Future<void> startPayment() async {
  final request = IdPayRequest(
    orderId: 'ORDER_ID',  // 你的订单 ID
    amount: 10000,  // 支付金额（以 IRR 为单位）
    name: 'John Doe',  // 用户姓名
    phone: '09123456789',  // 用户手机号
    mail: 'john.doe@example.com',  // 用户邮箱
    desc: 'Payment for order #123',  // 订单描述
    callback: 'https://your-callback-url.com',  // 回调 URL
  );

  try {
    final response = await IdPay.startPayment(request);
    if (response.status == 'success') {
      // 支付成功
      print('Payment successful: ${response.trackId}');
    } else {
      // 支付失败
      print('Payment failed: ${response.message}');
    }
  } catch (e) {
    // 处理异常
    print('Error: $e');
  }
}

5. 处理回调

支付完成后，IDPay 会将用户重定向到你指定的回调 URL。你需要在服务器端处理回调并验证支付结果。

6. 检查支付状态

你可以使用 IdPay.getPaymentStatus 方法来检查支付状态：

Future<void> checkPaymentStatus(String trackId) async {
  try {
    final status = await IdPay.getPaymentStatus(trackId);
    if (status == 'paid') {
      // 支付成功
      print('Payment is successful');
    } else {
      // 支付未完成或失败
      print('Payment status: $status');
    }
  } catch (e) {
    // 处理异常
    print('Error: $e');
  }
}

7. 处理错误

在使用 idpay 插件时，可能会遇到各种错误。你需要在代码中妥善处理这些错误，例如网络错误、支付失败等。

8. 测试与上线

在开发过程中，确保使用沙盒环境进行测试。在准备上线时，将 sandbox 参数设置为 false，并确保使用正确的 API Key 和回调 URL。

示例代码

以下是一个简单的完整示例：

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

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

class _PaymentPageState extends State<PaymentPage> {
  [@override](/user/override)
  void initState() {
    super.initState();
    IdPay.initialize(
      apiKey: 'YOUR_API_KEY',
      sandbox: true,
    );
  }

  Future<void> startPayment() async {
    final request = IdPayRequest(
      orderId: 'ORDER_ID',
      amount: 10000,
      name: 'John Doe',
      phone: '09123456789',
      mail: 'john.doe@example.com',
      desc: 'Payment for order #123',
      callback: 'https://your-callback-url.com',
    );

    try {
      final response = await IdPay.startPayment(request);
      if (response.status == 'success') {
        print('Payment successful: ${response.trackId}');
      } else {
        print('Payment failed: ${response.message}');
      }
    } catch (e) {
      print('Error: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('IDPay Payment'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: startPayment,
          child: Text('Pay with IDPay'),
        ),
      ),
    );
  }
}