Flutter支付集成插件flutter_paxful_pay的使用

Flutter支付集成插件flutter_paxful_pay的使用

此插件帮助您生成带有参数的PaxFul支付URL，并且可以打开一个WebView以进行支付。

特性

• 可以生成带有参数的PaxFul支付URL。详情请参阅PaxFul支付文档。
• 打开一个WebView以进行支付。

开始使用

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

dependencies:
  flutter_paxful_pay: ^0.0.5

并导入插件：

import 'package:flutter_paxful_pay/flutter_paxful_pay.dart';

使用方法

要直接通过参数打开支付WebView，请使用以下代码：

import 'package:flutter_paxful_pay/flutter_paxful_pay.dart';

String paymentURL = FlutterPAXFulPay.openWebView(
    context: context, // 构建上下文。
    apiKey: "ABCDEFGHIJKLMNOPQRSTUVWXYZ", // 更改。
    merchantId: "abc", // 更改。
    to: "BTC_ADDRESS", // 更改。
    secret: "secret", // 更改。
    trackId: "uuid", // 所有交易的唯一ID...用于跟踪后端事务...
    saveAddress: true,
    amount: 0.005, // BTC金额。
);

注意： 您可以选择提示支付BTC或法币。对于BTC，上述示例已足够。对于法币，您需要省略amount参数，并提供fiatAmount和fiatCurrency参数。如果您同时提供了amount、fiatAmount和fiatCurrency，则amount将被忽略。

您的应用将导航到一个新的页面/路由，该页面包含一个WebView，如下所示：

要生成BTC支付URL，请使用以下代码：

import 'package:flutter_paxful_pay/flutter_paxful_pay.dart';

String paymentURL = FlutterPAXFulPay.generatePaymentURL(
    apiKey: "ABCDEFGHIJKLMNOPQRSTUVWXYZ", // 更改。
    merchantId: "abc", // 更改。
    to: "BTC_ADDRESS", // 更改。
    secret: "secret", // 更改。
    trackId: "uuid", // 所有交易的唯一ID...用于跟踪后端事务...
    saveAddress: true,
    amount: 0.005, // BTC金额。PaxFul最小值为0.0004。
);

要生成法币支付URL，请使用以下代码：

import 'package:flutter_paxful_pay/flutter_paxful_pay.dart';

String paymentURL = FlutterPAXFulPay.generatePaymentURL(
    apiKey: "ABCDEFGHIJKLMNOPQRSTUVWXYZ", // 更改。
    merchantId: "abc", // 更改。
    to: "BTC_ADDRESS", // 更改。
    secret: "secret", // 更改。
    trackId: "uuid", // 所有交易的唯一ID...用于跟踪后端事务...
    saveAddress: true,
    fiatAmount: 70, // 法币金额。
    fiatCurrency: "USD", // 法币货币。
);

其他信息

有关实际示例，请参阅包示例部分。

贡献

欢迎提交拉取请求。

请将拉取请求发送到develop分支。

对于重大更改，请先打开一个问题以讨论您想要更改的内容。

完整示例代码

import 'dart:convert';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart' show rootBundle;
import 'package:flutter_paxful_pay/flutter_paxful_pay.dart';
import 'package:uuid/uuid.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  // 此小部件是您的应用程序的根。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

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

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  Map<String, dynamic> _secrets = {};
  late final _uuid = const Uuid();

  [@override](/user/override)
  void initState() {
    super.initState();
    rootBundle.loadString('assets/json/secrets.json').then((string) {
      _secrets = json.decode(string);
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            MaterialButton(
              child: const Text('Pay'),
              color: Colors.blue,
              textColor: Colors.white,
              onPressed: () => FlutterPAXFulPay.openWebView(
                context: context,
                apiKey: _secrets['api_key'],
                merchantId: _secrets['merchant_id'],
                to: 'bc1q83uzyzvt256k670uazjse9f0877vpze053m90v',
                fiatAmount: 50,
                fiatCurrency: 'USD',
                trackId: _uuid.v4(),
                secret: _secrets['secret'],
              ),
            ),
          ],
        ),
      ),
    );
  }
}