Flutter支付网关插件nagad_payment_gateway的使用

Nagad在线支付API集成Flutter包

这是一个Flutter包，适用于希望将Nagad提供的新在线支付方式整合到其应用中的商家和服务提供商。

注意：请通过联系Nagad获取您的商户凭证。

需要由Nagad提供的凭证

final merchantID = "特定商户ID"
final merchantPrivateKey = "商户私钥"
final pgPublicKey = "Nagad支付网关公钥"

初始化Nagad实例

创建一个Credentials实例并将其提供给Nagad实例：

Nagad nagad = Nagad(
      credentials: const Credentials(
          merchantID: merchantID,
          merchantPrivateKey: merchantPrivateKey,
          pgPublicKey: merchantPrivateKey,
          isSandbox: true)); // 切换为false以用于生产环境

注意：请确保替换提供的凭证为您的Nagad沙盒或生产凭证。

设置额外的商户信息

Map<String, dynamic> additionalMerchantInfo = {
        "serviceName" : "T恤",
        "serviceLogoURL" : "tinyurl.com/sampleLogoUrl",
        "additionalFieldNameEN" : "颜色",
        "additionalFieldNameBN" : "রং",
        "additionalFieldValue" : "白色"
    };

nagad.setAdditionalMerchantInfo(additionalMerchantInfo);

N.B: additionalMerchantInfo必须是Map<String, dynamic>类型。额外的商户信息可以是任何东西，并将在后续使用中保存。然而，只有这些字段会显示在支付页面上。

普通支付

要进行普通商户支付，请使用pay方法：

请求

final nagadResponse = await nagad.regularPayment(context, amount: 10.25, orderId: orderId);

参数

• amount: 支付金额。建议使用double类型。
• orderID: 唯一标识符，用于订单支付。您可以使用当前的millisecondsSinceEpoch来保证唯一性。

DateTime now = DateTime.now();
String orderId = 'order${now.millisecondsSinceEpoch}';

响应

nagadResponse包含以下信息：

1. merchantId
2. orderId
3. paymentRefId
4. amount
5. clientMobileNo
6. merchantMobileNo
7. orderDateTime
8. issuerPaymentDateTime
9. issuerPaymentRefNo
10. additionalMerchantInfo
11. status
12. statusCode
13. cancelIssuerDateTime
14. cancelIssuerRefNo
15. serviceType

N.B: 如果需要，请将所需的信息保存到您的数据库中。

许可证

nagad_payment_gateway 包的许可证是 GNU通用公共许可证（GPL）版本3.0。

©2024

完整示例Demo

import 'package:example/pg_response.dart';
import 'package:flutter/material.dart';
import 'package:nagad_payment_gateway/nagad_payment_gateway.dart';

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

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

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  Nagad nagad = Nagad(
      credentials: const NagadCredentials(
          merchantID: '683002007104225',
          merchantPrivateKey:
          'MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCJakyLqojWTDAVUdNJLvuXhROV+LXymqnukBrmiWwTYnJYm9r5cKHj1hYQRhU5eiy6NmFVJqJtwpxyyDSCWSoSmIQMoO2KjYyB5cDajRF45v1GmSeyiIn0hl55qM8ohJGjXQVPfXiqEB5c5REJ8Toy83gzGE3ApmLipoegnwMkewsTNDbe5xZdxN1qfKiRiCL720FtQfIwPDp9ZqbG2OQbdyZUB8I08irKJ0x/psM4SjXasglHBK5G1DX7BmwcB/PRbC0cHYy3pXDmLI8pZl1NehLzbav0Y4fP4MdnpQnfzZJdpaGVE0oI15lq+KZ0tbllNcS+/4MSwW+afvOw9bazAgMBAAECggEAIkenUsw3GKam9BqWh9I1p0Xmbeo+kYftznqai1pK4McVWW9//+wOJsU4edTR5KXK1KVOQKzDpnf/CU9SchYGPd9YScI3n/HR1HHZW2wHqM6O7na0hYA0UhDXLqhjDWuM3WEOOxdE67/bozbtujo4V4+PM8fjVaTsVDhQ60vfv9CnJJ7dLnhqcoovidOwZTHwG+pQtAwbX0ICgKSrc0elv8ZtfwlEvgIrtSiLAO1/CAf+uReUXyBCZhS4Xl7LroKZGiZ80/JE5mc67V/yImVKHBe0aZwgDHgtHh63/50/cAyuUfKyreAH0VLEwy54UCGramPQqYlIReMEbi6U4GC5AQKBgQDfDnHCH1rBvBWfkxPivl/yNKmENBkVikGWBwHNA3wVQ+xZ1Oqmjw3zuHY0xOH0GtK8l3Jy5dRL4DYlwB1qgd/Cxh0mmOv7/C3SviRk7W6FKqdpJLyaE/bqI9AmRCZBpX2PMje6Mm8QHp6+1QpPnN/SenOvoQg/WWYM1DNXUJsfMwKBgQCdtddE7A5IBvgZX2o9vTLZY/3KVuHgJm9dQNbfvtXw+IQfwssPqjrvoU6hPBWHbCZl6FCl2tRh/QfYR/N7H2PvRFfbbeWHw9+xwFP1pdgMug4cTAt4rkRJRLjEnZCNvSMVHrri+fAgpv296nOhwmY/qw5Smi9rMkRY6BoNCiEKgQKBgAaRnFQFLF0MNu7OHAXPaW/ukRdtmVeDDM9oQWtSMPNHXsx+crKY/+YvhnujWKwhphcbtqkfj5L0dWPDNpqOXJKV1wHt+vUexhKwus2mGF0flnKIPG2lLN5UU6rs0tuYDgyLhAyds5ub6zzfdUBG9Gh0ZrfDXETRUyoJjcGChC71AoGAfmSciL0SWQFU1qjUcXRvCzCK1h25WrYS7E6pppm/xia1ZOrtaLmKEEBbzvZjXqv7PhLoh3OQYJO0NM69QMCQi9JfAxnZKWx+m2tDHozyUIjQBDehve8UBRBRcCnDDwU015lQN9YNb23Fz+3VDB/LaF1D1kmBlUys3//r2OV0Q4ECgYBnpo6ZFmrHvV9IMIGjP7XIlVa1uiMCt41FVyINB9SJnamGGauW/pyENvEVh+ueuthSg37e/l0Xu0nm/XGqyKCqkAfBbL2Uj/j5FyDFrpF27PkANDo99CdqL5A4NQzZ69QRlCQ4wnNCq6GsYy2WEJyU2D+K8EBSQcwLsrI7QL7fvQ==',
          pgPublicKey:
          'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAjBH1pFNSSRKPuMcNxmU5jZ1x8K9LPFM4XSu11m7uCfLUSE4SEjL30w3ockFvwAcuJffCUwtSpbjr34cSTD7EFG1Jqk9Gg0fQCKvPaU54jjMJoP2toR9fGmQV7y9fz31UVxSk97AqWZZLJBT2lmv76AgpVV0k0xtb/0VIv8pd/j6TIz9SFfsTQOugHkhyRzzhvZisiKzOAAWNX8RMpG+iqQi4p9W9VrmmiCfFDmLFnMrwhncnMsvlXB8QSJCq2irrx3HG0SJJCbS5+atz+E1iqO8QaPJ05snxv82Mf4NlZ4gZK0Pq/VvJ20lSkR+0nk+s/v3BgIyle78wjZP1vWLU4wIDAQAB',
          isSandbox: true));
  var error = '';

  [@override](/user/override)
  void initState() {
    super.initState();
    Map<String, dynamic> additionalMerchantInfo = {
      'serviceName': '品牌',
      'serviceLogoURL':
      'https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png',
      'additionalFieldNameEN': '类型',
      'additionalFieldNameBN': 'টাইপ',
      'additionalFieldValue': '支付',
    };
    nagad.setAdditionalMerchantInfo(additionalMerchantInfo);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              child: const Text('进行支付'),
              onPressed: () async {
                error = '';

                DateTime now = DateTime.now();
                String orderId = 'order${now.millisecondsSinceEpoch}';

                try {
                  final nagadResponse = await nagad.regularPayment(context, amount: 10.25, orderId: orderId);
                  Navigator.push(
                      context,
                      MaterialPageRoute(
                          builder: (context) => PGResponse(
                              nagadResponse: nagadResponse)));
                } catch (e) {
                  print(e);
                  setState(() {
                    error = e.toString();
                  });
                }
              },
            ),
            const SizedBox(
              height: 20,
            ),
            Text(error)
          ],
        ),
      ),
    );
  }
}