Flutter巴基斯坦支付插件paymob_pakistan的使用

Easily accept Jazzcash/Easypaisa/Card Payments through Paymob Pakistan in your Flutter app.

🚀 Installation

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

dependencies:
  paymob_pakistan: latest_version

确保将latest_version替换为实际可用的最新版本号。

🔨 Initialization

初始化插件时需要提供API密钥和其他集成ID。以下是初始化示例：

import 'package:paymob_pakistan/paymob_payment.dart';

void main() {
  PaymobPakistan.instance.initialize(
    apiKey: "YOUR_API_KEY", // 从Paymob仪表板获取
    jazzcashIntegrationId: 123123, // 从Paymob仪表板获取
    easypaisaIntegrationID: 123123, // 从Paymob仪表板获取
    integrationID: 123456, // 从Paymob仪表板获取
    iFrameID: 123456, // 从Paymob仪表板获取
  );
  runApp(const MyApp());
}

您也可以创建自己的实例：

final PaymobPakistan paymobPakistan = PaymobPakistan();
paymobPakistan.initialize(
  apiKey: "YOUR_API_KEY",
  jazzcashIntegrationId: 123123,
  easypaisaIntegrationID: 123123,
  integrationID: 123456,
  iFrameID: 123456,
);

🔖 Usage

使用插件进行支付的示例如下：

final PaymobResponse? response = await PaymobPakistan.instance.pay(
  context: context,
  currency: "PKR",
  paymentType: PaymentType.card, // 或者使用PaymentType.jazzcash或PaymentType.easypaisa
  amountInCents: "50000", // 500 PKR
  onPayment: (response) => setState(() => this.response = response), // 可选
);

示例Demo

下面是一个完整的示例，展示如何在Flutter应用中集成和使用paymob_pakistan插件：

// ignore_for_file: use_build_context_synchronously

import 'package:flutter/material.dart';
import 'package:paymob_pakistan/paymob_payment.dart';

void main() {
  PaymobPakistan.instance.initialize(
    apiKey: "YOUR_API_KEY",
    integrationID: 123456,
    iFrameID: 123456,
    jazzcashIntegrationId: 123456,
    easypaisaIntegrationID: 123456,
  );
  runApp(const MyApp());
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        appBarTheme: const AppBarTheme(color: Color(0xFF007aec)),
        elevatedButtonTheme: ElevatedButtonThemeData(
          style: ButtonStyle(
            backgroundColor: MaterialStateProperty.all(const Color(0xFF007aec)),
          ),
        ),
      ),
      debugShowCheckedModeBanner: false,
      home: const PaymentView(),
    );
  }
}

class PaymentView extends StatefulWidget {
  const PaymentView({Key? key}) : super(key: key);

  @override
  State<PaymentView> createState() => _PaymentViewState();
}

class _PaymentViewState extends State<PaymentView> {
  PaymobResponse? response;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Paymob')),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.stretch,
          children: [
            Image.network('https://paymob.pk/images/paymobLogo.png'),
            const SizedBox(height: 24),
            if (response != null)
              Column(
                crossAxisAlignment: CrossAxisAlignment.stretch,
                children: [
                  Text("Success ==> ${response?.success}"),
                  const SizedBox(height: 8),
                  Text("Transaction ID ==> ${response?.transactionID}"),
                  const SizedBox(height: 8),
                  Text("Message ==> ${response?.message}"),
                  const SizedBox(height: 8),
                  Text("Response Code ==> ${response?.responseCode}"),
                  const SizedBox(height: 16),
                ],
              ),
            Column(
              children: [
                ElevatedButton(
                  child: const Text('Pay with Jazzcash'),
                  onPressed: () async {
                    try {
                      final response = await PaymobPakistan.instance.initializePayment(
                        currency: "PKR",
                        amountInCents: "100",
                      );

                      final authToken = response.authToken;
                      final orderID = response.orderID;

                      await PaymobPakistan.instance.makePayment(
                        context,
                        currency: "PKR",
                        amountInCents: "100",
                        paymentType: PaymentType.jazzcash,
                        authToken: authToken,
                        orderID: orderID,
                        onPayment: (response) => setState(() => this.response = response),
                      );
                    } catch (err) {
                      rethrow;
                    }
                  },
                ),
              ],
            )
          ],
        ),
      ),
    );
  }
}

🧪 Testing Cards

✅ Successful payment

• Card Number: 5123456789012346
• Expiry Month: 12
• Expiry Year: 25
• CVV: 123
• Name: Test Account

❎ Declined payment

• Change CVV to 111 or expiry year to 20

Credits

所有API的功劳归于Paymob Pakistan。访问Paymob Pakistan以获取您的PayMob账户，并在您的Flutter应用程序中接受数字支付。可能需要联系Paymob支持来激活测试卡。