Flutter安全支付插件safexpay的使用
Flutter安全支付插件safexpay的使用
本指南将帮助你了解如何在Flutter项目中集成和使用safexpay
插件来实现安全支付功能。我们将通过一个简单的示例来演示如何初始化插件、设置支付参数并处理支付结果。
获取开始
首先,确保你已经安装了Flutter环境,并且可以创建一个新的Flutter项目。如果你还没有安装Flutter,请访问Flutter官方文档获取安装指南。
配置safexpay插件
在你的pubspec.yaml
文件中添加safexpay
依赖:
dependencies:
safexpay: ^1.0.0 # 请根据实际情况替换版本号
然后运行flutter pub get
来安装依赖。
初始化插件
在你的主应用类中初始化safexpay
插件并设置商户信息:
import 'dart:async';
import 'dart:math';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:safexpay/constants/strings.dart';
import 'package:safexpay/constants/utility.dart';
import 'package:safexpay/safexpay.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatefulWidget {
[@override](/user/override)
_MyAppState createState() => _MyAppState();
}
class _MyAppState extends State<MyApp> {
String _platformVersion = 'Unknown';
[@override](/user/override)
void initState() {
super.initState();
initPlatformState();
MerchantConstants.setDetails(
mId: 'HERE-MERCHANT-ID',
mKey: 'HERE-MERCHANT-KEY',
aggId: 'HERE-AGGREGATOR-ID',
environment: Environment.PRODUCTION); //Environment.PRODUCTION
}
// 平台消息是异步的,因此我们在异步方法中初始化。
Future<void> initPlatformState() async {
String platformVersion;
// 平台消息可能会失败,所以我们使用try/catch来捕获PlatformException。
// 我们也处理消息可能返回null的情况。
try {
platformVersion = await Safexpay.platformVersion ?? 'Unknown platform version';
} on PlatformException {
platformVersion = 'Failed to get platform version.';
}
// 如果在异步平台消息飞行时小部件被从树中移除,则我们希望丢弃回复而不是调用setState来更新我们的非存在的外观。
if (!mounted) return;
setState(() {
_platformVersion = platformVersion;
});
}
[@override](/user/override)
Widget build(BuildContext context) {
return MaterialApp(
debugShowCheckedModeBanner: false, home: UserInputPage());
}
}
用户输入页面
在这个页面中,用户可以输入金额并点击按钮进行支付:
class UserInputPage extends StatefulWidget {
[@override](/user/override)
_UserInputPageState createState() => _UserInputPageState();
}
class _UserInputPageState extends State<UserInputPage> implements SafeXPayPaymentCallback {
TextEditingController controller = TextEditingController();
GlobalKey<ScaffoldState> _scaffoldKey = GlobalKey<ScaffoldState>();
late SafeXPayPaymentCallbackObservable _safeXPayPaymentCallbackObservable;
[@override](/user/override)
void initState() {
super.initState();
_safeXPayPaymentCallbackObservable = SafeXPayPaymentCallbackObservable();
_safeXPayPaymentCallbackObservable.register(this);
}
[@override](/user/override)
void dispose() {
_safeXPayPaymentCallbackObservable.unRegister(this);
super.dispose();
}
[@override](/user/override)
Widget build(BuildContext context) {
return Scaffold(
key: _scaffoldKey,
appBar: AppBar(
title: Text('DemoPaymentApp'),
),
body: Padding(
padding: const EdgeInsets.all(16.0),
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
mainAxisSize: MainAxisSize.max,
children: [
TextField(
controller: controller,
keyboardType: TextInputType.number,
decoration: InputDecoration(hintText: 'Enter the amount to pay'),
),
const SizedBox(
height: 32,
),
ElevatedButton(
onPressed: () {
String amount = controller.text.toString().trim();
if (amount.isEmpty) {
Utility.showSnackBarMessage(
state: _scaffoldKey.currentState!,
message: 'Please enter amount to pay');
} else {
SafeXPayGateway safeXPayGateway = SafeXPayGateway(
orderNo: '${Random().nextInt(1000)}',
amount: double.parse(controller.text),
currency: 'INR',
transactionType: 'SALE',
channel: 'MOBILE',
successUrl: 'https://1bd1c7cd06b7.ngrok.io/Performance/public/simApp',
failureUrl: 'https://1bd1c7cd06b7.ngrok.io/Performance/public/simApp',
countryCode: 'IND');
safeXPayGateway.setUserDetails(
name: 'Nagendra',
emailId: 'nagendra@safexpay.com',
mobile: '7710910181');
safeXPayGateway.allowedPaymentMethods(
allowCardPayment: true,
allowNetBankingPayment: true,
allowWalletPayment: true,
allowUPIPayment: true);
MaterialPageRoute route = MaterialPageRoute(builder: (context) => safeXPayGateway);
Navigator.push(context, route);
}
},
child: Text(
'Proceed to Payment',
style: TextStyle(color: Colors.black),
),
style: ElevatedButton.styleFrom(
primary: Colors.cyanAccent,
padding: const EdgeInsets.symmetric(vertical: 12, horizontal: 24),
),
)
],
),
),
);
}
[@override](/user/override)
void onInitiatePaymentFailure(
String orderID,
String transactionID,
String paymentID,
String paymentStatus,
String date,
String time,
String paymode,
String amount,
String udf1,
String udf2,
String udf3,
String udf4,
String udf5) {
print('onInitiatePaymentFailure : $orderID -- $transactionID -- $paymentID -- $paymentStatus -- $date -- $time -- $paymode -- $amount -- $udf1 -- $udf2 -- $udf3 -- $udf4 -- $udf5');
}
[@override](/user/override)
void onPaymentCancelled() {
print('onPaymentCancelled : Transaction Cancelled');
}
[@override](/user/override)
void onPaymentComplete(
String orderID,
String transactionID,
String paymentID,
String paymentStatus,
String date,
String time,
String paymode,
String amount,
String udf1,
String udf2,
String udf3,
String udf4,
String udf5) {
print('onPaymentComplete : $orderID -- $transactionID -- $paymentID -- $paymentStatus -- $date -- $time -- $paymode -- $amount -- $udf1 -- $udf2 -- $udf3 -- $udf4 -- $udf5');
}
}
更多关于Flutter安全支付插件safexpay的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html
更多关于Flutter安全支付插件safexpay的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html
SafeExpay
是一个用于在 Flutter 应用中实现安全支付的插件。它通常用于处理支付交易,确保支付过程的安全性。以下是如何在 Flutter 项目中使用 safexpay
插件的基本步骤:
1. 添加依赖
首先,你需要在 pubspec.yaml
文件中添加 safexpay
插件的依赖项。
dependencies:
flutter:
sdk: flutter
safexpay: ^1.0.0 # 请使用最新版本
然后运行 flutter pub get
来获取依赖包。
2. 初始化 SafeExpay
在你的 Flutter 应用中,首先需要初始化 SafeExpay
插件。通常,你可以在 main.dart
或任何其他合适的地方进行初始化。
import 'package:safexpay/safexpay.dart';
void main() async {
WidgetsFlutterBinding.ensureInitialized();
// 初始化 SafeExpay
await SafeExpay.initialize(
apiKey: 'YOUR_API_KEY',
environment: Environment.sandbox, // 或者 Environment.production
);
runApp(MyApp());
}
3. 发起支付请求
在你的应用中,你可以使用 SafeExpay
插件来发起支付请求。以下是一个简单的示例:
import 'package:flutter/material.dart';
import 'package:safexpay/safexpay.dart';
class PaymentPage extends StatelessWidget {
Future<void> initiatePayment() async {
try {
// 创建支付请求
final PaymentRequest request = PaymentRequest(
amount: 100.0, // 支付金额
currency: 'USD', // 货币类型
orderId: 'ORDER12345', // 订单ID
description: 'Payment for product', // 支付描述
);
// 发起支付
final PaymentResponse response = await SafeExpay.startPayment(request);
// 处理支付响应
if (response.status == PaymentStatus.success) {
print('Payment successful: ${response.transactionId}');
} else {
print('Payment failed: ${response.errorMessage}');
}
} catch (e) {
print('Error during payment: $e');
}
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text('SafeExpay Payment'),
),
body: Center(
child: ElevatedButton(
onPressed: initiatePayment,
child: Text('Pay Now'),
),
),
);
}
}
4. 处理支付结果
在 PaymentResponse
中,你可以根据 status
字段来判断支付是否成功,并执行相应的操作。例如,你可以显示成功或失败的消息给用户。
5. 配置环境
SafeExpay
提供了两种环境:Environment.sandbox
和 Environment.production
。在开发阶段,你可以使用 sandbox
环境进行测试。当应用上线时,切换到 production
环境。
6. 错误处理
在处理支付过程中,可能会遇到各种错误。你可以通过 try-catch
块来捕获异常,并根据需要处理错误。
7. 调试和日志
在开发过程中,你可以启用 SafeExpay
的调试模式,以便查看详细的日志信息。
SafeExpay.setDebugEnabled(true);