Cielo：TypeScript/Node.js 中的 Cielo API 3.0 客户端-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00655/article/details/142510271

Cielo：TypeScript/Node.js 中的 Cielo API 3.0 客户端

cielo Client para a API 3.0 da Cielo em node.js 项目地址: https://gitcode.com/gh_mirrors/ci/cielo

项目介绍

Cielo 是一个基于 TypeScript/Node.js 的客户端库，专门用于与 Cielo API 3.0 进行交互。Cielo 是巴西领先的支付服务提供商，其 API 提供了丰富的支付处理功能，包括信用卡、借记卡、电子转账、银行支票和定期付款等多种支付方式。通过 Cielo 客户端，开发者可以轻松集成这些支付功能到自己的应用中，实现快速、安全的支付处理。

项目技术分析

Cielo 客户端库采用了现代的 TypeScript 语言，结合 Node.js 的强大生态系统，提供了高效、可靠的支付处理解决方案。以下是项目的主要技术特点：

TypeScript：使用 TypeScript 编写，提供了强类型检查和更好的代码可维护性。
Node.js：基于 Node.js 运行时，支持异步编程模型，适合处理高并发的支付请求。
Promise & Async/Await：支持 Promise 和 Async/Await 语法，简化异步操作的编写。
模块化设计：代码结构清晰，模块化设计使得功能扩展和维护更加方便。
测试覆盖：项目包含全面的测试用例，确保代码的稳定性和可靠性。

项目及技术应用场景

Cielo 客户端适用于多种应用场景，特别是需要集成支付功能的 Web 应用和移动应用。以下是一些典型的应用场景：

电子商务平台：支持信用卡、借记卡、银行支票等多种支付方式，提升用户支付体验。
订阅服务：通过定期付款功能，实现订阅服务的自动扣费。
在线课程平台：支持多种支付方式，方便用户购买课程。
企业内部系统：集成支付功能，实现内部费用的自动结算。

项目特点

简单易用：提供简洁的 API 接口，开发者可以快速上手。
功能全面：支持信用卡、借记卡、电子转账、银行支票和定期付款等多种支付方式。
安全可靠：遵循最佳安全实践，确保支付数据的安全性。
开源免费：基于 MIT 许可证，开发者可以自由使用和修改。
活跃社区：项目有活跃的社区支持，遇到问题可以快速获得帮助。

如何开始使用

安装

npm install --save cielo

初始化

import { CieloConstructor, Cielo } from 'cielo';

const cieloParams: CieloConstructor = {
    merchantId: 'xxxxxxxxxxxxxxxxxxxxxxx',
    merchantKey: 'xxxxxxxxxxxxxxxxxxxxxxxxxx',
    sandbox: true, // 可选 - 测试环境
    debug: true // 可选 - 调试模式
}

const cielo = new Cielo(cieloParams);

创建信用卡交易

const vendaParams: TransactionCreditCardRequestModel = {
    customer: {
        name: "Comprador crédito",
    },
    merchantOrderId: "2014111703",
    payment: {
        amount: 10000, // R$100,00
        creditCard: {
            brand: EnumBrands.VISA,
            cardNumber: "4532117080573700",
            holder: "Comprador T Cielo",
            expirationDate: "12/2021",
        },
        installments: 1,
        softDescriptor: "Banzeh",
        type: EnumCardType.CREDIT,
        capture: false,
    },
};

cielo.creditCard.transaction(vendaParams)
    .then((data) => {
        console.log(data);
    })
    .catch((err) => {
        console.error('ERRO', err);
    });

通过以上步骤，您可以轻松集成 Cielo 客户端到您的项目中，实现多种支付方式的支持。