Flutter支付集成插件flutter_cielo的使用

flutter-cielo

Package用于使用Cielo e-Commerce SDK创建交易。更多详细信息请访问 文档。

开始

在您的pubspec.yaml文件中添加flutter_cielo包。

dependencies:
  flutter_cielo: ^x.x.x

然后在代码中导入：

import 'package:flutter_cielo/flutter_cielo.dart';

初始化API对象：

final CieloEcommerce cielo = CieloEcommerce(
  environment: Environment.SANDBOX, // 环境设置为沙箱模式
  merchant: Merchant(
    merchantId: "SEU_MERCHANT_ID", // 商户ID
    merchantKey: "SEU_MERCHANT_KEY", // 商户密钥
  ),
);

创建一个销售对象并发起支付：

// 创建销售对象
Sale sale = Sale(
  merchantOrderId: "123", // 唯一订单ID
  customer: Customer(
    name: "Comprador crédito simples" // 用户名
  ),
  payment: Payment(
    type: TypePayment.creditCard, // 支付类型
    amount: 7777, // 金额（以分计算）
    installments: 1, // 分期数
    softDescriptor: "Cielo", // 支付描述
    creditCard: CreditCard(
      cardNumber: "1234123412341231", // 卡号
      holder: "Teste Holder", // 持卡人姓名
      expirationDate: "12/2030", // 到期日期
      securityCode: "123", // 安全码
      brand: "Visa", // 卡品牌
    ),
  ),
);

try {
  var response = await cielo.createSale(sale);
  print(response.payment.paymentId); // 打印支付ID
} catch (e) {
  print(e); // 捕获异常
}

Tokenizing一张信用卡

使用tokenizeCard方法对信用卡进行token化处理：

CreditCard cart = CreditCard(
  customerName: "Comprador Teste Cielo",
  cardNumber: "1234123412341231",
  holder: "Teste Holder",
  expirationDate: "12/2030",
  brand: "Visa",
);

try {
  var response = await cielo.tokenizeCard(cart);
  print(response.cardToken); // 打印生成的卡token
} on CieloException catch (e) {
  print(e.message); // 打印错误消息
  print(e.errors[0].message); // 打印具体错误信息
  print(e.errors[0].code); // 打印错误代码
}

使用Tokenized卡进行支付

使用已token化的卡进行支付：

Sale sale = Sale(
  merchantOrderId: "123",
  customer: Customer(
    name: "Comprador crédito simples"
  ),
  payment: Payment(
    type: TypePayment.creditCard,
    amount: 7777,
    installments: 1,
    softDescriptor: "Cielo",
    creditCard: CreditCard.token(
      cardToken: "1234123412341231", // 使用已token化的卡
      securityCode: "123",
      brand: "Visa",
    ),
  ),
);

try {
  var response = await cielo.createSale(sale);
  print(response.payment.paymentId); // 打印支付ID
} on CieloException catch (e) {
  print(e.message); // 打印错误消息
  print(e.errors[0].message); // 打印具体错误信息
  print(e.errors[0].code); // 打印错误代码
}

示例代码

以下是一个完整的示例代码：

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

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key key, this.title}) : super(key: key);

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  final CieloEcommerce cielo = CieloEcommerce(
    environment: Environment.SANDBOX,
    merchant: Merchant(
      merchantId: "SEU_MERCHANT_ID",
      merchantKey: "SEU_MERCHANT_KEY",
    ),
  );

  void _incrementCounter() async {
    try {
      print("Iniciando pagamento tokenizado....");
      Sale sale = Sale(
        merchantOrderId: "123",
        customer: Customer(
          name: "Comprador crédito simples"
        ),
        payment: Payment(
          type: TypePayment.creditCard,
          amount: 7777,
          installments: 1,
          softDescriptor: "Pagame",
          creditCard: CreditCard(
            cardToken: "TOKEN_DO_CARTAO",
            securityCode: "123",
            brand: "Visa",
          ),
        ),
      );

      var response = await cielo.createSale(sale);
      print(response.payment.paymentId); // 打印支付ID
    } on CieloException catch (e) {
      print(e.message); // 打印错误消息
      print(e.errors[0].message); // 打印具体错误信息
      print(e.errors[0].code); // 打印错误代码
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text('You have pushed the button this many times:'),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.display1,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: Icon(Icons.add),
      ),
    );
  }
}