Flutter支付集成插件fxendit的使用

Flutter支付集成插件fxendit的使用

使用Xendit在Flutter应用程序中进行支付集成。

开始使用

在你的项目中添加依赖：

$ flutter pub add fxendit

使用说明

1. 获取公钥： 访问Xendit开发者设置页面获取你的公钥。

2. 配置AndroidManifest.xml： 在AndroidManifest.xml文件中添加必要的权限和活动。

   <manifest...>
     ...
     
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
     <uses-permission android:name="android.permission.INTERNET"/>
     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
     <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   
     <application...>
       ...
       
       <activity
         android:name="com.xendit.example.CreateTokenActivity"
         android:theme="@style/NormalTheme"/>
         
       <activity
         android:name="com.xendit.example.AuthenticationActivity"
         android:theme="@style/NormalTheme"/>
         
       <activity
         android:name="com.xendit.example.ValidationUtilActivity"
         android:theme="@style/NormalTheme"/>
         
       <activity android:name="com.xendit.XenditActivity"/>
       ...
     </application>
   </manifest>
   

3. 初始化Xendit： 在你的Dart代码中导入并初始化Xendit插件。

   import 'package:fxendit/fxendit.dart';
   
   Xendit xendit = Xendit('your_xendit_public_key');
   

4. 创建单次使用的Token：

   XCard card = XCard(
     creditCardNumber: '4111111111111111', // 示例卡号
     creditCardCVN: '123', // 卡背面的CVV码
     expirationMonth: '09', // 过期月份
     expirationYear: '2021', // 过期年份
   );
   
   TokenResult result = await xendit.createSingleUseToken(
     card,
     amount: 75000, // 交易金额
     shouldAuthenticate: true, // 是否需要认证
     onBehalfOf: '', // 代理账户ID
   );
   
   if (result.isSuccess) {
     tokenId = result.token!.id;
     print('Token ID: ${result.token!.id}');
   } else {
     print('SingleUseToken Error: ${result.errorCode} - ${result.errorMessage}');
   }
   

5. 创建多次使用的Token：

   XCard card = XCard(
     creditCardNumber: '4111111111111111',
     creditCardCVN: '123',
     expirationMonth: '09',
     expirationYear: '2021',
   );
   
   TokenResult result = await xendit.createMultipleUseToken(card);
   
   if (result.isSuccess) {
     tokenId = result.token!.id;
     print('Token ID: ${result.token!.id}');
   } else {
     print('MultipleUseToken Error: ${result.errorCode} - ${result.errorMessage}');
   }
   

6. 创建3DS认证：

   AuthenticationResult result = await xendit.createAuthentication(tokenId, amount: 50000);
   
   if (result.isSuccess) {
     print('Authentication ID: ${result.authentication!.id}');
   } else {
     print('Authentication Error: ${result.errorCode} - ${result.errorMessage}');
   }
   

7. 验证信用卡号码的有效性：

   String cardNumber = '4111111111111111';
   
   bool isValid = CardValidator.isCardNumberValid(cardNumber);
   

8. 验证信用卡过期日期的有效性：

   String expirationMonth = '09';
   String expirationYear = '2021';
   
   bool isValid = CardValidator.isExpiryValid(expirationMonth, expirationYear);
   

9. 验证信用卡CVN的有效性：

   String cardCVN = '123';
   
   bool isValid = CardValidator.isCvnValid(cardCVN);
   

10. 获取信用卡类型：

    String cardNumber = '4111111111111111';
    
    CardType cardType = CardValidator.getCardType(cardNumber);
    print('${cardType.cardName} - ${cardType.cardKey}');
    

11. 验证信用卡CVN长度是否符合其类型的要求：

    String cardNumber = '4111111111111111';
    String cardCVN = '123';
    
    bool isValid = CardValidator.isCvnValidForCardType(cardCVN, cardNumber);
    

示例代码

查看完整的示例代码可以从这里获取。

示例代码：example/lib/main.dart

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

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  // 使用你自己的公钥
  Xendit xendit = Xendit(
      'xnd_public_development_RGUHB7gkrX2QTfeWMMCZhoUMAoVBmEadosxVOGfCCIX92kdCacGBoDlrjldsm7');
  String tokenId = '';

  [@override](/user/override)
  void initState() {
    super.initState();
    WidgetsBinding.instance?.addPostFrameCallback((_) async {
      await _testSingleUseToken();
      await _testMultipleUseToken();
      await _testAuthentication();
    });
  }

  Future _testSingleUseToken() async {
    XCard card = XCard(
      creditCardNumber: '4111111111111111',
      creditCardCVN: '123',
      expirationMonth: '09',
      expirationYear: '2021',
    );

    TokenResult result = await xendit.createSingleUseToken(
      card,
      amount: 75000,
      shouldAuthenticate: true,
      onBehalfOf: '',
    );

    if (result.isSuccess) {
      tokenId = result.token!.id;
      print('Token ID: ${result.token!.id}');
    } else {
      print(
          'SingleUseToken Error: ${result.errorCode} - ${result.errorMessage}');
    }
  }

  Future _testMultipleUseToken() async {
    XCard card = XCard(
      creditCardNumber: '4111111111111111',
      creditCardCVN: '123',
      expirationMonth: '09',
      expirationYear: '2021',
    );

    TokenResult result = await xendit.createMultipleUseToken(card);

    if (result.isSuccess) {
      tokenId = result.token!.id;
      print('Token ID: ${result.token!.id}');
    } else {
      print(
          'MultipleUseToken Error: ${result.errorCode} - ${result.errorMessage}');
    }
  }

  Future _testAuthentication() async {
    if (tokenId.isNotEmpty) {
      AuthenticationResult result =
          await xendit.createAuthentication(tokenId, amount: 50000);

      if (result.isSuccess) {
        print('Authentication ID: ${result.authentication!.id}');
      } else {
        print(
            'Authentication Error: ${result.errorCode} - ${result.errorMessage}');
      }
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('FXendit Example'),
        ),
        body: Center(
          child: Text(''),
        ),
      ),
    );
  }
}