Flutter支付功能插件auropay_payments的使用
Flutter支付功能插件auropay_payments的使用
Auropay 插件
AuroPay 插件允许你在应用内接受支付,为你提供构建无缝支付体验所需的组件,适用于 iOS 和 Android 应用。
开始使用
pubspec.yaml 设置
要将 AuroPay Flutter 插件添加到你的项目中,请按照以下步骤操作:
步骤 1
在项目的 pubspec.yaml
文件中添加以下依赖项。如果还没有添加的话:
dependencies:
auropay_payments: latest_version
// 或者在终端运行
$ flutter pub add auropay_payments
步骤 2
在终端中运行以下命令:
$ flutter pub get
现在,AuroPay 插件已经添加到你的项目中了。
注意:
对于 Android,需要在 AndroidManifest.xml
文件中添加互联网权限:
<uses-permission android:name="android.permission.INTERNET"/>
对于 iOS,在 Info.plist
文件中添加相机权限:
<key>NSCameraUsageDescription</key>
<string>需要访问您的摄像头以扫描卡片。</string>
使用 SDK
为了在支付交易中使用 AuroPay Flutter 插件,SDK 需要在发起任何支付请求之前进行初始化。AuroPay 插件可以在 main.dart
中初始化。
初始化 SDK
构造必要的模型类来初始化插件,并在 Dart 文件中添加以下行:
// 创建客户配置。
CustomerProfile customerProfileObj = CustomerProfile(
title: "Some Title",
firstName: "First Name",
middleName: "Middle Name",
lastName: "Last Name",
phone: "01234567890",
email: "Test@gmail.com");
// 准备包含所需信息的构建器
final builder = AuropayBuilder(
subDomainId: keys.merchantId, // 你的商户域名
accessKey: keys.accessKey, // 你的访问密钥
secretKey: keys.secretKey, // 你的密钥
customerProfile: customerProfileObj)
.setAutoContrast(true) // 设置应用程序栏的颜色主题
.setCountry(Country.IN)
.setShowReceipt(true)
.askForCustomerDetail(false)
.getDetailedResponse(false)
.build();
你可以选择为 AuroPay 插件的 UI 元素指定一个主题,使其与你的应用主题匹配。
// 创建主题模型。
Theme myTheme = AuropayTheme(
primaryColor: const Color(0xff236C6C),
colorOnPrimary: Colors.black,
colorOnSecondary: Colors.redAccent,
secondaryColor: Colors.white);
builder.setTheme(myTheme);
发起支付请求并处理结果
以下代码片段展示了如何发起支付请求并接收回调事件。
auropayResponse = await _auropay.doPayment(
builder: builder,
amount: double.parse(amountController.text),
referenceNumber: "mock_reference");
final paymentStatus = ResponseType.success == auropayResponse?.type
? PaymentStatus.success
: PaymentStatus.failed;
String? message;
if (auropayResponse?.data is FailureData) {
FailureData data = auropayResponse?.data as FailureData;
message = '支付失败:\n${data.message}';
}
if (auropayResponse?.data is SuccessData) {
SuccessData data = auropayResponse?.data as SuccessData;
message = '支付成功\n交易 ID: ${data.transactionId}';
}
你可以通过在 builder
属性中设置以下参数来获取详细的支付响应。
builder.getDetailedResponse(true) // 默认为 false
通过遵循本文档中的步骤,你应该能够成功地将 AuroPay Flutter 插件集成到你的移动应用中,并实现无缝的支付流程。
如果你遇到任何问题,请联系我们:support@auropay.net
完整示例代码
你可以参考以下完整的示例代码来了解如何使用 AuroPay 插件:
import 'package:flutter/material.dart';
import 'simple_app.dart';
void main() {
runApp(const SimpleApp());
}
更多关于Flutter支付功能插件auropay_payments的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html