Flutter支付集成插件flutter_onpay_sdk的使用

Flutter支付集成插件flutter_onpay_sdk的使用

该插件用于将Flutter应用程序与支付服务onpay.ru进行集成。

通过此插件，用户可以在应用内使用银行卡和其他支持的支付方式（如银行快速支付系统）完成支付，而无需离开应用程序。

重要信息

此插件仅能在已拥有onpay.ru商户账户的情况下使用。

功能

• 在应用程序内支付商品和服务费用
• 支持Visa/Mastercard支付
• 支持俄罗斯央行的银行快速支付系统（СБП）
• 支持所有可用的支付方式
• 生成二维码以支持线下支付通过СБП

开始使用

对于接受Visa/Mastercard/МИР卡支付

1. 注册并登录到 https://onpay.ru
2. 填写接收信用卡支付的申请（支付方式为"CRD" / “UNR” / “CRW”）
3. 请求OnPay的技术支持激活支付表单API (https://wiki.onpay.ru/doku.php?id=api-for-pay-form)

安装

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

dependencies:
  flutter_onpay_sdk: any # 或者使用最新版本

Android 配置

确保在<项目根目录>/android/app/src/main/AndroidManifest.xml文件中添加了以下权限：

<uses-permission android:name="android.permission.INTERNET"/>

使用示例

默认支付方法

import 'package:flutter_onpay_sdk/flutter_onpay_sdk.dart';

// 1. 创建支付对象
OnPayOrder order = OnPayOrder(
    reference: "SOMEUNIQ", // 唯一标识符
    payAmount: 100, // 价格（单位：分）
    payFor: '产品1', // 商品描述
    payMode: 'fix', // 固定价格模式
    recipient: 'cloud_sciencejet_net', // 商户在onpay的代码
    userEmail: 'some@mail.ru', // 用户邮箱
    note: "商品备注", // 可选。购买商品的额外描述
    interfaceTicker:  "CRW", // 指定商户可用的支付方式
    additionalParams: { // 额外参数。将在check和pay请求中通过API传递
      "someid": "1"
    },
);

// 2. 在当前上下文中打开支付表单。这将打开一个新屏幕，展示支付表单。结果是一个包含支付状态的OnPayResult对象
OnPayResult result = await OnPaySdk.openPaymentForm(context, order); 

// 3. 处理支付结果
switch (result.status) {
  case OnPayResultCode.success:
    // "支付成功";
    break;
  case OnPayResultCode.fail:
    // "支付失败";
    break;
  case OnPayResultCode.notCompleted:
    // "支付未完成";
    break;
}

通过银行快速支付系统（СБП）进行支付

import 'package:flutter_onpay_sdk/flutter_onpay_sdk.dart';

// 1. 创建支付对象
OnPayOrder order = OnPayOrder(
    reference: "SOMEUNIQ", // 唯一标识符
    payAmount: 100, // 价格（单位：分）
    payFor: '产品1', // 商品描述
    payMode: 'fix', // 固定价格模式
    recipient: 'onpay', // 商户在onpay的代码
    userEmail: 'some@mail.ru', // 用户邮箱
    note: "商品备注", // 可选。购买商品的额外描述
    interfaceTicker:  "QRW", // 指定支付方式为СБП
);

// 2. 在当前上下文中打开支付表单。这将打开一个新屏幕，展示支付表单。结果是一个包含支付状态的OnPayResult对象
OnPayResult result = await OnPaySdk.openPaymentForm(context, order, method: OnPayMethod.sbp); 

示例代码

// 忽略_for_file: avoid_print, use_build_context_synchronously

import 'package:flutter/material.dart';
import 'package:flutter_onpay_sdk/data_models/pay_method.dart';
import 'package:flutter_onpay_sdk/data_models/pay_order.dart';
import 'package:flutter_onpay_sdk/data_models/pay_result.dart';
import 'package:flutter_onpay_sdk/sdk/onpay.dart';

class ExampleAppMyHomePage extends StatefulWidget {
  const ExampleAppMyHomePage({Key? key, required this.title}) : super(key: key);
  final String title;

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

class _MyHomePageState extends State<ExampleAppMyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            _apiPayment(),
            _apiFailedPayment(),
            _sbpPayment(),
            _qrCodePayment(),
          ],
        ),
      ),
    );
  }

  Widget _apiFailedPayment() {
    OnPayOrder order = OnPayOrder(
      reference: "SALE1",
      amount: 0.99,
      payFor: '信用卡支付',
      payMode: 'fix',
      recipient: 'cloud_sciencejet_net',
      userEmail: 'some@mail.ru',
      interfaceTicker: 'UNR',
      note: "会返回错误",
    );
    return _saleItem(order, () => _openPaymentForm(order));
  }

  Widget _apiPayment() {
    OnPayOrder order = OnPayOrder(
      reference: "SALE2",
      payFor: '产品2',
      amount: 10,
      recipient: 'onpay',
      userEmail: 'some@mail.ru',
      interfaceTicker: 'UNR',
      note: "商品备注。可以支付",
    );
    return _saleItem(order, () => _openPaymentForm(order));
  }

  Widget _sbpPayment() {
    OnPayOrder order = OnPayOrder(
      reference: "SALE3",
      payFor: 'СБП支付',
      amount: 20,
      recipient: 'onpay',
      userEmail: 'some@mail.ru',
      interfaceTicker: 'QRW',
      note: "通过СБП系统支付",
    );
    return _saleItem(order, () => _openPaymentForm(order, method: OnPayMethod.sbp));
  }

  Widget _qrCodePayment() {
    OnPayOrder order = OnPayOrder(
      reference: "SALE3",
      payFor: '生成二维码支付',
      amount: 20,
      recipient: 'onpay',
      userEmail: 'some@mail.ru',
      interfaceTicker: '',
      note: "生成二维码支付",
    );
    return _saleItem(order, () => _openPaymentForm(order, method: OnPayMethod.qrCode));
  }

  Widget _saleItem(OnPayOrder order, void Function() onPressed) {
    return Padding(
      padding: const EdgeInsets.fromLTRB(20, 5, 20, 5),
      child: Card(
          child: Row(
        crossAxisAlignment: CrossAxisAlignment.center,
        children: [
          const Expanded(flex: 1, child: Icon(Icons.card_giftcard, size: 30)),
          Expanded(
            flex: 3,
            child: Column(
              children: [
                Text(order.payFor),
                Text(order.note ?? ""),
                Text("${order.amount} ${order.ticker}"),
                OutlinedButton(
                  onPressed: onPressed,
                  child: const Text("购买"),
                )
              ],
            ),
          ),
        ],
      )),
    );
  }

  void _openPaymentForm(OnPayOrder order, {OnPayMethod method = OnPayMethod.api}) async {
    OnPayResult result = await OnPaySdk.openPaymentForm(context, order, method: method);
    print("_openPaymentForm RESULT: ${result.status.toString()}");
    print("_openPaymentForm RESULT: ${result.message}");

    String msg;
    switch (result.status) {
      case OnPayResultCode.success:
        msg = "支付成功";
        break;
      case OnPayResultCode.fail:
        msg = "支付失败";
        break;
      case OnPayResultCode.notCompleted:
        msg = "支付未完成";
        break;
    }

    ScaffoldMessenger.of(context)
      ..removeCurrentSnackBar()
      ..showSnackBar(SnackBar(content: Text('${result.order.payFor}: $msg [${result.message}]')));
  }
}