PHPackages                             chico-rei/cielo-ecommerce-v3-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. chico-rei/cielo-ecommerce-v3-php

ActiveLibrary[API Development](/categories/api)

chico-rei/cielo-ecommerce-v3-php
================================

chico-rei

2.0.0(9mo ago)813.4k↓50%2MITPHPPHP &gt;=7.4

Since Jun 27Pushed 9mo ago3 watchersCompare

[ Source](https://github.com/chico-rei/cielo-ecommerce-v3-php)[ Packagist](https://packagist.org/packages/chico-rei/cielo-ecommerce-v3-php)[ Docs](https://github.com/chico-rei/cielo-ecommerce-v3-php)[ RSS](/packages/chico-rei-cielo-ecommerce-v3-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (5)Versions (8)Used By (0)

Cielo e-Commerce API v3 client wrapper for PHP
==============================================

[](#cielo-e-commerce-api-v3-client-wrapper-for-php)

[![Build Status](https://camo.githubusercontent.com/e7a80176b44c80a0b043848ea897aa4e55394a0bd8d4910954eab41730edc903/68747470733a2f2f7472617669732d63692e6f72672f636869636f2d7265692f6369656c6f2d65636f6d6d657263652d76332d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/chico-rei/cielo-ecommerce-v3-php)[![Coverage Status](https://camo.githubusercontent.com/b89232e2fe8199c8b7625ca69bf823e5ebd28fdbb3b1cfc449609ea23008f537/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f636869636f2d7265692f6369656c6f2d65636f6d6d657263652d76332d7068702f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/chico-rei/cielo-ecommerce-v3-php?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/199ec637ec7180c696d75259d3c9aaf2ac00beda266c5164b76edea329b7bfc1/68747470733a2f2f706f7365722e707567782e6f72672f636869636f2d7265692f6369656c6f2d65636f6d6d657263652d76332d7068702f762f737461626c65)](https://packagist.org/packages/chico-rei/cielo-ecommerce-v3-php)[![License](https://camo.githubusercontent.com/2644bc5498869471a8b0e46cde0c70fda05348e5b9cd9cd8b740fcd9ac6ba4b6/68747470733a2f2f706f7365722e707567782e6f72672f636869636f2d7265692f6369656c6f2d65636f6d6d657263652d76332d7068702f6c6963656e7365)](https://packagist.org/packages/chico-rei/cielo-ecommerce-v3-php)

This is a PHP client wrapper for [Cielo e-Commerce v3](https://developercielo.github.io/manual/cielo-ecommerce).

Install
-------

[](#install)

Via [Composer](https://getcomposer.org/)

```
$ composer require chico-rei/cielo-ecommerce-v3-php "dev-master"
```

Requires PHP 7.4 or newer.

Features
--------

[](#features)

- Create Payment
    - Credit/Debit Card
    - Wallet (Visa Checkout / Masterpass / Apple Pay / Samsung Pay)
    - Boleto
    - Eletronic Transfer
    - Recurrent
- Update Payment
    - Capture
    - Void
    - Recurrent Payment
- Query Payment
    - By Payment ID
    - By Order ID
- Query Card Bin
- Tokenize Card
- Fraud Analysis
- Velocity
- Zero Auth
- Silent Order Post

Usage
-----

[](#usage)

```
require 'path/to/vendor/autoload.php';

use \ChicoRei\Packages\Cielo\Cielo;
use \ChicoRei\Packages\Cielo\Merchant;
use \ChicoRei\Packages\Cielo\Util;

$merchant = Merchant::create([
    'id' => 'Your_ID',
    'key' => 'Your_KEY',
]);

$cielo = new Cielo($merchant); // For sandbox use: new Cielo($merchant, true);

try {
    $response = $cielo->sale()->create([
        'merchantOrderId' => '19800731',
        'payment' => [
            'type' => 'CreditCard',
            'amount' => 15700, // 157,00
            'installments' => 2,
            'softDescriptor' => 'Your Company',
            'capture' => true,
            'creditCard' => [
                'cardNumber' => '4551870000000000',
                'holder' => 'Name',
                'expirationDate' => '12/2021',
                'securityCode' => '123',
                'brand' => 'Visa'
            ]
        ]
    ]);

    echo $response->getPayment()->getStatus(); // Transaction Status Code

    $returnCode = $response->getPayment()->getReturnCode(); // Ex: '00'
    $details = Util::getReturnCodeDetails($returnCode);
    echo $details['definition']; // Transação autorizada com sucesso.

} catch (CieloAPIException $e) {
    // Handle API errors (or validation errors)
} catch (Exception $e) {
   // Handle exceptions
}
```

See [examples](examples) for more.

Testing
-------

[](#testing)

```
$ composer test
```

Credits
-------

[](#credits)

Project based on [DeveloperCielo/API-3.0-PHP](https://github.com/DeveloperCielo/API-3.0-PHP)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance58

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~372 days

Recently: every ~557 days

Total

7

Last Release

277d ago

Major Versions

1.x-dev → 2.0.02025-08-08

PHP version history (2 changes)1.0.0PHP &gt;=7.1

2.0.0PHP &gt;=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/476c021dbc27a48c569fd4278b4109afb335f847516df61d3a565a4d008658c3?d=identicon)[mathmarques](/maintainers/mathmarques)

![](https://www.gravatar.com/avatar/12234b85698474582105c607b55786b47c27d2ae2b03100068e6f8337d22f591?d=identicon)[rodrigobendia](/maintainers/rodrigobendia)

![](https://avatars.githubusercontent.com/u/19962290?v=4)[Chico Rei](/maintainers/chico-rei)[@chico-rei](https://github.com/chico-rei)

---

Top Contributors

[![mathmarques](https://avatars.githubusercontent.com/u/1610091?v=4)](https://github.com/mathmarques "mathmarques (30 commits)")

---

Tags

cielo-apicielo-ecommercephpsdksdk-phpapiecommercev3cielo

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/chico-rei-cielo-ecommerce-v3-php/health.svg)

```
[![Health](https://phpackages.com/badges/chico-rei-cielo-ecommerce-v3-php/health.svg)](https://phpackages.com/packages/chico-rei-cielo-ecommerce-v3-php)
```

###  Alternatives

[aimeos/aimeos-headless

Aimeos headless ecommerce system

2.5k2.3k](/packages/aimeos-aimeos-headless)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[pacely/mailchimp-apiv3

Simple API wrapper for Mailchimp API V3

95654.6k2](/packages/pacely-mailchimp-apiv3)[robwittman/shopify-php-sdk

PHP SDK for Shopify API

7098.9k1](/packages/robwittman-shopify-php-sdk)[siro/php-klaviyo-api

Low level but elegant Klaviyo full API wrapper for PHP with asynchronous track event support

16115.4k](/packages/siro-php-klaviyo-api)[phpfui/constantcontact

Object Oriented Wrapper for Constant Contact API V3 for PHP 8+

2015.7k1](/packages/phpfui-constantcontact)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
