Flutter支付网关集成插件omniware_payment_gateway_totalxsoftware的使用

Flutter支付网关集成插件omniware_payment_gateway_totalxsoftware的使用

关于Omniware Payment Gateway Totalxsoftware - Flutter Plugin

该插件由Totalx Software开发，提供了与Omniware支付网关的无缝集成，使Flutter应用程序能够进行安全高效的支付处理。

功能

• 简单集成：轻松将Omniware支付网关集成到Flutter应用中。
• 可定制：支持多种支付方式、货币和用户配置文件。
• 保存到Firebase：可选地将支付数据保存到Firebase，便于跟踪。
• 安全支付：确保加密和安全的支付处理。

安装

1. 在pubspec.yaml文件中添加依赖：

   dependencies:
     omniware_payment_gateway_totalxsoftware: ^1.0.0
   

2. 运行flutter pub get以安装包。

3. 在Dart文件中导入插件：

   import 'package:omniware_payment_gateway_totalxsoftware/omniware_payment_gateway_totalxsoftware.dart';
   

平台特定设置

Android集成

1. 更新AndroidManifest.xml：添加命名空间并更新应用标签：

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:tools="http://schemas.android.com/tools">
       <application
           android:label="[@string](/user/string)/totalxsoftwareapp"
           ... >
           ...
       </application>
   </manifest>
   
   <!-- 添加以下内容 -->
   <!-- ++  xmlns:tools="http://schemas.android.com/tools
   ++  android:label="[@string](/user/string)/totalxsoftwareapp" -->
   

2. 在res/values/colors.xml中添加颜色：

   <resources>
       <color name="colorPrimary">#FF6200EE</color>
       <color name="colorPrimaryDark">#FF3700B3</color>
       <color name="colorAccent">#FF03DAC5</color>
   </resources>
   

3. 在res/values/strings.xml中添加字符串：

   <resources>
       <string name="app_name">Kurikkal Business Park</string>
       <string name="totalxsoftwareapp">Kurikkal Business Park</string>
   </resources>
   

4. 在res/values/styles.xml中添加样式：

   <?xml version="1.0" encoding="utf-8"?>
   <resources>
       <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
           <item name="android:windowBackground">@drawable/launch_background</item>
       </style>
   
       <style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
           <item name="android:windowBackground">?android:colorBackground</item>
       </style>
   
       <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
           <item name="colorPrimary">[@color](/user/color)/colorPrimary</item>
           <item name="colorPrimaryDark">[@color](/user/color)/colorPrimaryDark</item>
           <item name="colorAccent">[@color](/user/color)/colorAccent</item>
       </style>
   </resources>
   
   <!-- 添加以下内容 -->
   <!-- ++  <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
   ++      <item name="colorPrimary">[@color](/user/color)/colorPrimary</item>
   ++      <item name="colorPrimaryDark">[@color](/user/color)/colorPrimaryDark</item>
   ++      <item name="colorAccent">[@color](/user/color)/colorAccent</item>
   ++  </style> -->
   

5. 更新settings.gradle：添加插件：

   include ":app"
   include ":payment_gateway_plugin"
   

6. 更新app/build.gradle：确保包含必要的依赖项：

   dependencies {
       implementation 'androidx.appcompat:appcompat:1.6.0'
       // 其他依赖项
   }
   

iOS集成

1. 更新Info.plist：添加支持的UPI和支付应用：

   <dict>
       ...
       <key>LSApplicationQueriesSchemes</key>
       <array>
           <string>upi</string>
           <string>credpay</string>
           <string>gpay</string>
           <string>phonepe</string>
           <string>paytmmp</string>
           <string>mobikwik</string>
           <string>com.amazon.mobile.shopping</string>
           <string>bharatpe</string>
           <string>freecharge</string>
           <string>payzapp</string>
           <string>myjio</string>
           <string>bhim</string>
           <string>slice</string>
           ...
       </array>
       ...
   </dict>
   

请求参数列表

示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中使用omniware_payment_gateway_totalxsoftware插件进行支付。

import 'dart:developer';
import 'dart:io';

import 'package:flutter/material.dart';
import 'package:omniware_payment_gateway_totalxsoftware/omniware_payment_gateway_totalxsoftware.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Omniware Payment Gateway',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const PaymentScreen(),
    );
  }
}

class PaymentScreen extends StatelessWidget {
  const PaymentScreen({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("Omniware Payment Gateway"),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            OmniwarePaymentGatewayTotalxsoftware.pay(
              context,
              saveInFirebase: true,
              appName: 'totalxsoftwareapp',
              platform: Platform.isAndroid ? 'android' : 'ios',
              paymentMode: PaymentMode.LIVE, // LIVE or TEST
              amount: 100, // 支付金额
              apiKey: 'YOUR_API_KEY', // 替换为您的实际API密钥
              merchantId: 'YOUR_MERCHANT_ID', // 替换为您的实际商户ID
              salt: 'YOUR_SALT', // 替换为您的实际Salt值
              description: 'Brief description of product or service being charged for', // 替换为您的产品描述
              currency: Currency.INR, // 根据需要更改货币
              returnUrl: 'https://totalx.in', // 替换为您的返回URL
              userProfile: OmniwareUserProfile(
                uid: 'user_unique_id', // 替换为用户的唯一ID
                name: 'Customer Name', // 替换为客户姓名
                email: 'customer@example.com', // 替换为客户电子邮件
                phoneNumber: '1234567890', // 替换为客户电话号码
                city: 'City Name', // 替换为客户所在城市
                state: 'State Name', // 替换为客户所在州
                country: 'Country Code', // 替换为国家代码（例如IND）
                zipcode: '123456', // 替换为客户邮政编码
                // addressline_1: 'Address Line 1', // 如需使用，请取消注释并替换
                // addressline_2: 'Address Line 2', // 如需使用，请取消注释并替换
              ),
              success: (response, orderId) {
                log('Payment Success: $response');
                log('Order ID: $orderId');
              },
              failure: (response, orderId) {
                log('Payment Failure: $response');
                log('Order ID: $orderId');
              },
              error: (response) {
                log('Payment Error: $response');
              },
            );
          },
          child: const Text("Make Payment"),
        ),
      ),
    );
  }
}