Flutter支付集成插件flutter_adyen_cse的使用

Adyen Payment客户端加密库适用于Flutter项目。

它适用于那些不需要使用Adyen Drop-in集成，而只需要对卡信息进行tokenize或使用自定义界面来输入卡数据的项目。

需求

检查应用兼容性：

• Android最低SDK版本：21 - Android Lollipop
• iOS最低构建目标：iOS 12.2

获取您的客户端加密公钥

在使用flutter_adyen_cse插件时，您需要设置为publicKey。要获取您的公钥，请按以下步骤操作：

1. 使用公司级别的账户登录到您的客户区域。
2. 导航至开发者 > API凭证。
3. 在用户列表中点击您的Web服务用户（ws@Company.[您的公司账户]）。 这将打开编辑Web服务用户页面。
4. 在客户端侧加密面板中，复制客户端加密公钥。

使用

第一步 - 初始化flutter_adyen_cse插件

import 'package:flutter_adyen_cse/flutter_adyen_cse.dart';
import 'package:flutter_adyen_cse/models/models.dart';

try {
  await FlutterAdyenCse.initAdyenCse(AdyenCseConfig(
    publicKey: '<您的客户端加密公钥>'
  ));
} on PlatformException {
  rethrow;
}

第二步 - 加密卡数据

import 'dart:developer';

import 'package:flutter_adyen_cse/flutter_adyen_cse.dart';
import 'package:flutter_adyen_cse/models/models.dart';

try {
  final AdyenCseEncryptedCard? encryptedCard =
      await FlutterAdyenCse.encryptCard(AdyenCseCard(
    cardNumber: '4242424242424242',
    expiryMonth: '12',
    expiryYear: '2026',
    securityCode: '737',
  ));

  if (encryptedCard != null) log(encryptedCard.toJson().toString());
} on PlatformException {
  rethrow;
}

第三步 - 使用加密后的卡数据

加密后的卡数据存储在AdyenCseEncryptedCard对象中，您可以根据需要使用这些数据。

示例应用

您可以在我们的示例应用中查看如何使用flutter_adyen_cse插件。

参考资料

• 自定义卡集成
• Adyen iOS Drop-in
• Adyen Android Drop-in

示例代码

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

import 'package:flutter/services.dart';
import 'package:flutter_adyen_cse/flutter_adyen_cse.dart';
import 'package:flutter_adyen_cse/models/models.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final TextEditingController _numberController = TextEditingController();
  final TextEditingController _expMonthController = TextEditingController();
  final TextEditingController _expYearController = TextEditingController();
  final TextEditingController _cvvController = TextEditingController();
  Map<String, String>? result;

  [@override](/user/override)
  void initState() {
    super.initState();
    initAdyenCsePlugin();
    _numberController.text = '4242424242424242';
    _expMonthController.text = '12';
    _expYearController.text = '2026';
    _cvvController.text = '737';
  }

  Future<void> initAdyenCsePlugin() async {
    try {
      await FlutterAdyenCse.initAdyenCse(AdyenCseConfig(
        publicKey: const String.fromEnvironment('ADYEN_PK', defaultValue: ''),
      ));
    } on PlatformException {
      rethrow;
    }
  }

  Future<void> encryptCard() async {
    try {
      final AdyenCseEncryptedCard? encryptedCard =
          await FlutterAdyenCse.encryptCard(AdyenCseCard(
        cardNumber: _numberController.value.text,
        expiryMonth: _expMonthController.value.text,
        expiryYear: _expYearController.value.text,
        securityCode: _cvvController.value.text,
      ));

      if (encryptedCard != null) {
        setState(() {
          result = encryptedCard.toJson();
        });
      }
    } on PlatformException {
      rethrow;
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) => MaterialApp(
        home: Scaffold(
          appBar: AppBar(
            title: const Text('Adyen CSE demo'),
          ),
          body: Padding(
            padding: const EdgeInsets.all(20),
            child: Column(
              mainAxisSize: MainAxisSize.min,
              children: [
                TextFormField(
                  controller: _numberController,
                  decoration: const InputDecoration(label: Text('卡号')),
                ),
                Row(
                  children: [
                    Expanded(
                      child: TextFormField(
                        controller: _expMonthController,
                        decoration: const InputDecoration(label: Text('有效期月')),
                      ),
                    ),
                    const SizedBox(width: 30),
                    Expanded(
                      child: TextFormField(
                        controller: _expYearController,
                        decoration: const InputDecoration(label: Text('有效期年')),
                      ),
                    ),
                  ],
                ),
                TextFormField(
                  controller: _cvvController,
                  decoration: const InputDecoration(label: Text('CVV')),
                ),
                Padding(
                  padding: const EdgeInsets.all(20),
                  child: MaterialButton(
                    onPressed: () => encryptCard(),
                    child: const Text(
                      '加密卡',
                      style: TextStyle(
                        color: Colors.white,
                      ),
                    ),
                    color: Colors.blue,
                  ),
                ),
                const Divider(
                  color: Colors.black54,
                ),
                Padding(
                  padding: const EdgeInsets.symmetric(vertical: 20),
                  child: Row(
                    children: const [
                      Text('结果：'),
                    ],
                  ),
                ),
                Expanded(
                  child: Material(
                    type: MaterialType.card,
                    borderRadius: BorderRadius.circular(10),
                    color: Colors.grey[200],
                    child: result != null
                        ? ListView.separated(
                            itemCount: result!.keys.length,
                            itemBuilder: (context, index) => Column(
                              crossAxisAlignment: CrossAxisAlignment.start,
                              mainAxisSize: MainAxisSize.min,
                              children: [
                                Padding(
                                  padding:
                                      const EdgeInsets.symmetric(vertical: 10),
                                  child: Text(
                                    result!.keys.elementAt(index),
                                    style: const TextStyle(
                                      fontWeight: FontWeight.bold,
                                    ),
                                  ),
                                ),
                                Text(result!.values.elementAt(index)),
                              ],
                            ),
                            separatorBuilder: (context, index) =>
                                const SizedBox(
                              height: 20,
                            ),
                          )
                        : Container(),
                  ),
                ),
              ],
            ),
          ),
        ),
      );
}