Flutter支付集成插件sagepay的使用

Getting started（开始使用）

要使用此插件，请在pubspec.yaml文件中将sagepay作为依赖项添加。

dependencies:
  sagepay: ^版本号

运行以下命令以获取依赖项：

flutter pub get

How to Use（如何使用）

该插件使用两个API：

1. 创建SagePay实例

通过调用构造函数SagePay创建SagePay实例。构造函数接受以下必需参数：

• context
• business
• reference
• callbackUrl
• amount
• token

它返回一个SagePay实例，然后我们可以在其上调用异步方法.chargeTransaction()。

import 'package:sagepay/sagepay.dart';

final sagePay = SagePay(
  context: context,
  amount: 100, // 支付金额
  reference: "随机生成的字符串", // 唯一标识符
  callbackUrl: "回调URL", // 回调地址
  token: "秘钥", // 商户秘钥
  business: Business(
    name: "商户名称", // 商户名称
    email: "商户邮箱" // 商户邮箱
  ),
  paymentMethod: 'card,transfer', // 支付方式，支持信用卡和转账
  metadata: {
    "name": "John Doe", // 用户姓名
    "email": "johndoe@example.com" // 用户邮箱
  }
);

// 调用支付接口
PaymentResponse? response = await sagePay.chargeTransaction();

2. 处理响应

调用.chargeTransaction()方法返回一个Future<PaymentResponse>，我们可以等待实际的响应。

PaymentResponse? response = await sagePay.chargeTransaction();

if (response != null) {
  if (response.success!) {
    // 处理成功响应
    print("支付成功");
  } else {
    // 处理未成功的响应
    print("支付失败");
  }
} else {
  // 用户取消了结账
  print("用户取消了支付");
}

Additional information（其他信息）

完整示例代码

以下是完整的示例代码，展示如何在Flutter应用中集成SagePay支付插件。

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

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'SagePay Example',
      theme: ThemeData(
        primarySwatch: Colors.red,
      ),
      home: const MyHomePage(),
    );
  }
}

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

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

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("SagePay Example"),
      ),
      body: Center(
        child: SizedBox(
          width: 200,
          child: ElevatedButton(
            onPressed: () => gotoPaymentGateway(),
            child: const Text('Go to SagePay Checkout'),
          ),
        ),
      ),
    );
  }

  gotoPaymentGateway() async {
    final sagePay = SagePay(
      context: context,
      amount: 100, // 支付金额
      reference: "随机生成的字符串", // 唯一标识符
      callbackUrl: "回调URL", // 回调地址
      token: "秘钥", // 商户秘钥
      business: Business(
        name: "商户名称", // 商户名称
        email: "商户邮箱" // 商户邮箱
      ),
      paymentMethod: 'card,transfer', // 支付方式，支持信用卡和转账
      metadata: {
        "name": "John Doe", // 用户姓名
        "email": "johndoe@example.com" // 用户邮箱
      }
    );

    PaymentResponse? response = await sagePay.chargeTransaction();

    if (response != null) {
      if (response.success!) {
        // 处理成功响应
        print("支付成功");
      } else {
        // 处理未成功的响应
        print("支付失败");
      }
    } else {
      // 用户取消了结账
      print("用户取消了支付");
    }
  }
}