Flutter支付集成插件sberbank_acquiring的使用

概述

Sberbank Acquiring SDK允许您将Sberbank互联网收单功能集成到iOS和Android平台的移动应用中。该SDK提供了多种支付方式，包括普通支付、重复支付以及通过Apple Pay或Google Pay进行支付等。

安装

在您的pubspec.yaml文件中添加以下依赖项：

dependencies:
  sberbank_acquiring: <latest_version>

请确保替换<latest_version>为实际的最新版本号。

使用前准备

在开始使用SDK之前，您需要获取以下信息：

• userName: 商户服务账户的登录名。
• password: 商户账户的密码。
• token: 用于验证商户发送请求到支付网关时的身份令牌（如果使用token则不需要提供userName和password）。

这些值可以在您的个人账户中连接到Sberbank互联网收单后获得。

配置示例

使用用户名和密码配置

final SberbankAcquiring acquiring = SberbankAcquiring(
  SberbankAcquiringConfig.credential(
    userName: 'your_username',
    password: 'your_password',
    isDebugMode: false,
  ),
);

使用Token配置

final SberbankAcquiring acquiring = SberbankAcquiring(
  SberbankAcquiringConfig.token(
    token: 'your_token',
    isDebugMode: false,
  ),
);

使用代理配置

final SberbankAcquiring acquiring = SberbankAcquiring(
  SberbankAcquiringConfig.proxy(
    proxyDomain: 'server.com',
    proxyPath: 'api/v1/',
    globalHeaders: <String, String>{'auth': 'test'},
    mapping: (AcquiringRequest request, bool isDebugMode) {
      if(request is RegisterRequest) return ProxyMapping(path: '/register');
      return;
    }
  ),
);

示例代码

以下是一个完整的Flutter应用程序示例，展示了如何使用sberbank_acquiring插件进行支付操作。

import 'dart:io';
import 'package:flutter/material.dart';
import 'package:sberbank_acquiring/sberbank_acquiring_core.dart';
import 'package:sberbank_acquiring/sberbank_acquiring_ui.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final List<PaymentItem> items = [
    PaymentItem(name: 'T-Shirt', price: 2000),
    PaymentItem(name: 'Trousers', price: 1600),
  ];
  SberbankAcquiring acquiring = SberbankAcquiring(
    SberbankAcquiringConfig.token(token: 'YRF3C5RFICWISEWFR6GJ'),
  );

  OrderStatus? orderStatus;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Status: $orderStatus'),
            ElevatedButton(
              onPressed: () async {
                await webviewPayment();
              },
              child: const Text('Webview Buy'),
            ),
            ElevatedButton(
              onPressed: () async {
                await tokenPayment();
              },
              child: const Text('Apple/Google Buy'),
            ),
          ],
        ),
      ),
    );
  }

  Future<void> webviewPayment() async {
    final RegisterResponse register = await acquiring.register(
      RegisterRequest(
        amount: 1000,
        returnUrl: 'https://test.ru/return.html',
        failUrl: 'https://test.ru/fail.html',
        orderNumber: 'test',
        pageView: 'MOBILE',
      ),
    );

    final String? formUrl = register.formUrl;

    if (!register.hasError && formUrl != null) {
      Navigator.of(context).push(
        MaterialPageRoute<void>(
          builder: (BuildContext context) => Scaffold(
            body: WebViewPayment(
              logger: acquiring.logger,
              formUrl: formUrl,
              returnUrl: 'https://test.ru/return.html',
              failUrl: 'https://test.ru/fail.html',
              onLoad: (bool v) {
                debugPrint('WebView load: $v');
              },
              onError: () {
                debugPrint('WebView Error');
              },
              onFinished: (String? v) async {
                final GetOrderStatusExtendedResponse status =
                    await acquiring.getOrderStatusExtended(
                  GetOrderStatusExtendedRequest(orderId: v),
                );

                orderStatus = status.orderStatus;
                setState(() {});
                Navigator.of(context).pop();
              },
            ),
          ),
        ),
      );
    }
  }

  Future<void> tokenPayment() async {
    // 假设madPay已经正确初始化
    final String? token = 'your_payment_token'; // 获取支付令牌

    if (token != null) {
      String orderId = '';

      if (Platform.isIOS) {
        final ApplePayResponse applePay = await acquiring.applePay(
          ApplePayRequest(
            merchant: 'test',
            language: 'ru',
            paymentToken: token,
          ),
        );

        if (applePay.success == true) {
          orderId = applePay.data?.orderId ?? '';
        }
      }

      if (Platform.isAndroid) {
        final GooglePayResponse googlePay = await acquiring.googlePay(
          GooglePayRequest(
            orderNumber: '',
            merchant: 'test',
            language: 'ru',
            amount: items.map((PaymentItem v) => v.price).reduce((double i1, double i2) => i1 + i2).toInt(),
            paymentToken: token,
            failUrl: 'https://test.ru/fail',
            returnUrl: 'https://test.ru/return',
          ),
        );

        if (googlePay.success == true) {
          orderId = googlePay.data?.orderId ?? '';
        }
      }

      if (orderId.isNotEmpty) {
        final GetOrderStatusExtendedResponse status =
            await acquiring.getOrderStatusExtended(
          GetOrderStatusExtendedRequest(
            orderId: orderId,
            language: 'ru',
          ),
        );

        orderStatus = status.orderStatus;
        setState(() {});
      }
    }
  }
}

以上示例展示了如何通过WebView和Apple/Google Pay进行支付，并获取支付状态。请根据实际需求调整代码中的参数和逻辑。