Download the PHP package hardsystem/erede-php without Composer
On this page you can find all versions of the php package hardsystem/erede-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hardsystem/erede-php
More information about hardsystem/erede-php
Files in hardsystem/erede-php
Package erede-php
Short Description e.Rede integration SDK for hardsystem
License MIT
Informations about the package erede-php
SDK PHP
SDK de integração eRede
Novidade na versão
0.3.0: a autenticação foi migrada para OAuth 2.0 e os endpoints v2 da Rede (o antigo HTTP Basic/v1 foi desligado pela Rede em 05/01/2026). A fachada (Store/eRede) continua a mesma — detalhes em Autenticação (OAuth 2.0).
Funcionalidades
Este SDK possui as seguintes funcionalidades:
- Autorização
- Captura
- Consultas
- Cancelamento
- 3DS2
- Zero dollar
- iata
- MCC dinâmico.
Autenticação (OAuth 2.0)
A partir da versão
0.3.0a biblioteca usa OAuth 2.0 e os endpoints v2 da Rede. O HTTP Basic (v1) foi desligado pela Rede em 05/01/2026.
A mudança é retrocompatível na fachada: continue criando new Store($pv, $chave, $env)
e new eRede($store) como antes. Internamente a biblioteca passou a:
- obter um
access_tokenno endpoint OAuth (grant_type=client_credentials); - reutilizá-lo (dura ~24 min) e renová-lo com folga (~5 min antes de expirar);
- enviar
Authorization: Bearer {access_token}em todas as transações v2.
Credenciais
As credenciais são as mesmas do Portal Use Rede, apenas renomeadas pelo OAuth 2.0. Quem já transacionava no Basic não precisa recadastrar nada — a Chave de Integração existente continua válida.
| Portal Use Rede | OAuth 2.0 | Argumento do Store |
|---|---|---|
| PV | clientId |
1º — filiation |
| Chave de Integração | clientSecret |
2º — token |
| Token de acesso | access_token |
— (gerado em runtime) |
Os aliases Store::getClientId() e Store::getClientSecret() estão disponíveis; os
getters antigos (getFiliation() / getToken()) continuam funcionando.
Cache do token (opcional, PSR-16)
Por padrão o access_token é reutilizado em memória durante a mesma request. Para
compartilhá-lo entre requests (recomendado em produção), injete um backend PSR-16
(Psr\SimpleCache\CacheInterface) — o cache do Laravel já implementa essa interface:
Sem backend injetado, no pior caso é feita uma chamada ao endpoint de token por
request HTTP. Com o backend, o token é guardado como value object serializável
(Rede\Auth\AccessToken), com TTL alinhado à expiração informada pela Rede.
Endpoints por ambiente
| Sandbox | Produção | |
|---|---|---|
| Token | https://rl7-sandbox-api.useredecloud.com.br/oauth2/token |
https://api.userede.com.br/redelabs/oauth2/token |
| Transações (v2) | https://sandbox-erede.useredecloud.com.br/v2/transactions |
https://api.userede.com.br/erede/v2/transactions |
Escolhidos automaticamente por Environment::sandbox() / Environment::production().
Instalação
Dependências
- PHP >= 8.1
Instalando o SDK
Se já possui um arquivo composer.json, basta adicionar a seguinte dependência ao seu projeto:
Com a dependência adicionada ao composer.json, basta executar:
Alternativamente, você pode executar diretamente em seu terminal:
Testes
O SDK utiliza PHPUnit com TestDox para os testes. Para executá-los em ambiente local, você precisa exportar
as variáveis de ambiente REDE_PV e REDE_TOKEN com suas credenciais da API. Feito isso, basta rodar:
Testes unitários vs. integração
A partir da 0.3.0 os testes estão divididos em dois suites (phpunit.xml.dist):
-
unit— não acessam a rede nem exigem credenciais (ex.:AccessToken,AuthenticationService,Authenticator). Podem rodar a qualquer momento: integration— batem no sandbox v2 e exigemREDE_PV(clientId) eREDE_TOKEN(clientSecret) de OAuth válidos:
Os testes também podem ser executados através de um container com a configuração ideal para o projeto. Para isso, basta fazer:
export REDE_DEBUG=1
# Utilizando
## Autorizando uma transação
Por padrão, a transação é capturada automaticamente; caso seja necessário apenas autorizar a transação, o método `Transaction::capture()` deverá ser chamado com o parâmetro `false`:
## Adiciona configuração de parcelamento
## Adiciona informação adicional de gateway e módulo
## Autorizando uma transação com MCC dinâmico
## Autorizando uma transação IATA
## Capturando uma transação
## Cancelando uma transação
## Consultando uma transação pelo ID
## Consultando uma transação pela referência
## Consultando cancelamentos de uma transação
## Transação com autenticaçãoAll versions of erede-php with dependencies
ext-curl Version *
ext-json Version *
psr/log Version *
psr/simple-cache Version ^1 || ^2 || ^3
monolog/monolog Version *