Download the PHP package devsitarget/sdk-cielo-php without Composer
On this page you can find all versions of the php package devsitarget/sdk-cielo-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download devsitarget/sdk-cielo-php
More information about devsitarget/sdk-cielo-php
Files in devsitarget/sdk-cielo-php
Package sdk-cielo-php
Short Description SDK PHP para integração com a API E-commerce Cielo (crédito, consulta, captura e cancelamento)
License MIT
Informations about the package sdk-cielo-php
SDK PHP Cielo
SDK de integração com a API E-commerce Cielo: cartão de crédito, consulta, captura, cancelamento, Zero Auth, tokenização e parser do Post de Notificação.
Funcionalidades
- Cartão de crédito: autorização com captura automática ou posterior (inclui parcelamento e
CardToken) - Captura total ou parcial (
PUT /1/sales/{PaymentId}/capture) - Cancelamento e estorno (
void/refund) total ou parcial porPaymentIdouMerchantOrderId - Consulta por
PaymentId,TideMerchantOrderId(API de query) - Zero Auth (validação de cartão) e tokenização (Cartão Protegido)
- Parser do Post de Notificação
- Mapeamento dos status transacionais da Cielo
Requisitos
- PHP >= 8.1
- Guzzle HTTP
Instalação
Configuração
Valores monetários são sempre enviados em centavos (int), como exige a API Cielo (Amount = 15700 equivale a R$ 157,00).
Uso básico
Criar pagamento com cartão de crédito (captura automática)
Autorizar agora e capturar depois
Envie capture: false na criação e chame capture() com o PaymentId retornado:
Cancelamento e estorno
Na API Cielo, cancelamento e estorno usam o mesmo endpoint (PUT /1/sales/{PaymentId}/void). O que muda é o momento:
- até 23h59 do dia da autorização → status
Voided(10), cancelamento - depois disso → status
Refunded(11), estorno
refund() é alias de void(). Aceitam PaymentId ou acquirerTid (Tid). A Cielo só cancela por PaymentId; se vier só o Tid, o SDK consulta a transação e resolve o identificador.
Consultar transação
A consulta usa a API de query (apiquerysandbox / apiquery), distinta da API transacional.
Zero Auth e tokenização
Pagamento com cartão já tokenizado:
Post de Notificação
Status transacionais
| Código | Enum | Descrição |
|---|---|---|
| 0 | NotFinished |
Aguardando atualização de status |
| 1 | Authorized |
Autorizado, apto a capturar |
| 2 | PaymentConfirmed |
Confirmado / capturado |
| 3 | Denied |
Negado pelo autorizador |
| 10 | Voided |
Cancelado |
| 11 | Refunded |
Estornado após o dia da autorização |
| 12 | Pending |
Aguardando instituição financeira |
| 13 | Aborted |
Abortado por falha ou antifraude |
| 20 | Scheduled |
Recorrência agendada |
Docker
Variáveis de ambiente em env.example: CIELO_MERCHANT_ID, CIELO_MERCHANT_KEY, CIELO_ENVIRONMENT.
Estrutura
All versions of sdk-cielo-php with dependencies
guzzlehttp/guzzle Version ^7.5
psr/http-client Version ^1.0
psr/http-message Version ^1.0 || ^2.0
psr/log Version ^1.0 || ^2.0 || ^3.0