PHPackages                             mrprompt/cielo - 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. [Payment Processing](/categories/payments)
4. /
5. mrprompt/cielo

ActiveLibrary[Payment Processing](/categories/payments)

mrprompt/cielo
==============

Integration with Cielo gateway.

4.0.0(1y ago)481.9k—8.3%231GPL-3.0-or-laterPHPPHP ^8.2CI passing

Since May 22Pushed 7mo ago6 watchersCompare

[ Source](https://github.com/mrprompt/Cielo)[ Packagist](https://packagist.org/packages/mrprompt/cielo)[ RSS](/packages/mrprompt-cielo/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (9)Dependencies (5)Versions (9)Used By (1)

Cielo
=====

[](#cielo)

[![Tests](https://github.com/mrprompt/Cielo/actions/workflows/tests.yml/badge.svg)](https://github.com/mrprompt/Cielo/actions/workflows/tests.yml)

Esta é uma biblioteca cliente para a API da [Cielo](https://www.cielo.com.br/).

AVISO
-----

[](#aviso)

**Esta versão foi inteiramente reescrita e é totalmente incompatível com as versões anteriores da biblioteca.**

Requisitos
----------

[](#requisitos)

- PHP 8.2+

Instalação
----------

[](#instalação)

```
composer require mrprompt/cielo "^4.0"
```

Exemplos
--------

[](#exemplos)

Para todos os recursos suportados pela biblioteca, existe um exemplo de código no diretório de [exemplos](./exemplos/). Para executa-los, copie o arquivo .env.example do diretório .env e edite os campos:

- CIELO\_MERCHANT\_ID
- CIELO\_MERCHANT\_KEY

Você pode obter as credencias diretamente na [documentação](https://docs.cielo.com.br/) da [Cielo](https://www.cielo.com.br/).

Recursos disponíveis
--------------------

[](#recursos-disponíveis)

- **Consulta BIN**
    - [Consultar BIN do cartão](https://docs.cielo.com.br/ecommerce-cielo/reference/consulta-bin-cartao)
- **Zero Auth**
    - [Validar cartão com o Zero Auth](https://docs.cielo.com.br/ecommerce-cielo/reference/validar-cartao)
    - [Validar cartão tokenizado](https://docs.cielo.com.br/ecommerce-cielo/reference/validar-cartao-tokenizado)
    - [Validar cartão de e-wallet](https://docs.cielo.com.br/ecommerce-cielo/reference/validar-cartao-e-wallet)
- **Cartão de crédito**
    - [Criar pagamento com cartão de crédito](https://docs.cielo.com.br/ecommerce-cielo/reference/criar-pagamento-credito)
    - [Capturar transação de crédito após a autorização](https://docs.cielo.com.br/ecommerce-cielo/reference/capturar-apos-autorizacao)
    - [Cancelar transação de crédito via PaymentId](https://docs.cielo.com.br/ecommerce-cielo/reference/cancelamento-paymentid)
    - [Cancelar transação de crédito via MerchantOrderId](https://docs.cielo.com.br/ecommerce-cielo/reference/cancelamento-merchantorderid)
- **Cartão de débito**
    - [Criar pagamento com cartão de débito](https://docs.cielo.com.br/ecommerce-cielo/reference/debito)
    - [Cancelar transação de débito via PaymentId](https://docs.cielo.com.br/ecommerce-cielo/reference/cancelamento-d%C3%A9bito-paymentid)
    - [Cancelar transação de débito via MerchantOrderId](https://docs.cielo.com.br/ecommerce-cielo/reference/cancelamento-debito-merchantorderid)
- **PIX**
    - [Criar pagamento com QRCode Pix](https://docs.cielo.com.br/ecommerce-cielo/reference/qrcode-pix)
    - [Solicitar uma devolução Pix](https://docs.cielo.com.br/ecommerce-cielo/reference/devolu%C3%A7ao-pix-api)
- **Boleto**
    - [Criar pagamento com boleto](https://docs.cielo.com.br/ecommerce-cielo/reference/boleto-api)
- **Tokenização**
    - [Criar cartão tokenizado antes da autorização](https://docs.cielo.com.br/ecommerce-cielo/reference/criar-cardtoken)

Adicionais
----------

[](#adicionais)

Para [Laravel](https://laravel.com/)/[Lumen](https://lumen.laravel.com) foi desenvolvido um *Service Provider* para facilitar o uso da biblioteca. Você pode obter mais detalhes sobre uso ou instalação diretamente no [repositório](https://github.com/mrprompt/cielo-service-provider).

Debug
-----

[](#debug)

Para todas as requisições/recursos, você pode obter no retorno as propriedades `jsonEnvio` e `jsonRecebimento`, com o corpo da requisição e da resposta da API.

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance57

Moderate activity, may be stable

Popularity35

Limited adoption so far

Community26

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 88.6% 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 ~622 days

Recently: every ~645 days

Total

8

Last Release

385d ago

Major Versions

2.2 → 3.02018-04-03

3.2.1 → 4.0.02025-04-29

PHP version history (3 changes)2.0PHP >=5.3

3.0PHP >=7.1

4.0.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/201963?v=4)[Luís Cobucci](/maintainers/lcobucci)[@lcobucci](https://github.com/lcobucci)

![](https://www.gravatar.com/avatar/41076e410724cd2b42f9df8a964cf1b448c39d6dff1197650b108f0cae489f7f?d=identicon)[xthiago](/maintainers/xthiago)

![](https://www.gravatar.com/avatar/9d08744966e0d5783569605da853ef945dadac0be0f613f2eba6a052861d937a?d=identicon)[mrprompt](/maintainers/mrprompt)

![](https://www.gravatar.com/avatar/9c7143e38ef3b186588f44741eea9c17e5d789a4ae6b3fba40811cc6629708eb?d=identicon)[wcomnisky](/maintainers/wcomnisky)

---

Top Contributors

[![mrprompt](https://avatars.githubusercontent.com/u/166088?v=4)](https://github.com/mrprompt "mrprompt (194 commits)")[![xthiago](https://avatars.githubusercontent.com/u/720151?v=4)](https://github.com/xthiago "xthiago (11 commits)")[![wcomnisky](https://avatars.githubusercontent.com/u/133863?v=4)](https://github.com/wcomnisky "wcomnisky (8 commits)")[![gildonei](https://avatars.githubusercontent.com/u/1370979?v=4)](https://github.com/gildonei "gildonei (3 commits)")[![antonioribeiro](https://avatars.githubusercontent.com/u/3182864?v=4)](https://github.com/antonioribeiro "antonioribeiro (2 commits)")[![omar331](https://avatars.githubusercontent.com/u/3647700?v=4)](https://github.com/omar331 "omar331 (1 commits)")

---

Tags

tokenpaymentgatewayboletocardPagamentocreditocreditdebitpixcielodebitocartão

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mrprompt-cielo/health.svg)

```
[![Health](https://phpackages.com/badges/mrprompt-cielo/health.svg)](https://phpackages.com/packages/mrprompt-cielo)
```

###  Alternatives

[freelancehunt/php-credit-card-validator

Validates popular debit and credit cards' numbers against regular expressions and Luhn algorithm. Also validates the CVC and the expiration date.

18620.4k2](/packages/freelancehunt-php-credit-card-validator)[tritoq/cielo

Classe para integração com o Webservice da Cielo e a ferramenta de Análise de Risco

1916.1k1](/packages/tritoq-cielo)[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4845.9k](/packages/sebdesign-laravel-viva-payments)

PHPackages © 2026

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