jetimob / juno-sdk-php-laravel
SDK de integração com a Juno
Installs: 3 236
Dependents: 0
Suggesters: 0
Security: 0
Stars: 14
Watchers: 3
Forks: 7
Open Issues: 0
Requires
- php: ^8.0
- ext-json: *
- illuminate/console: ^9.0 | ^10.0
- illuminate/container: ^9.0 | ^10.0
- illuminate/support: ^9.0 | ^10.0
- jetimob/http-php-laravel: ^2
Requires (Dev)
- orchestra/testbench: ^7.6.1
- phpunit/phpunit: ^v9.5.5 | ^10.0
- dev-master
- v2.0.2
- v2.0.1
- v2.0.0
- v2.0.0-rc.8
- v2.0.0-rc.7
- v2.0.0-rc.6
- v2.0.0-rc.5
- v2.0.0-rc.4
- v2.0.0-rc.3
- v2.0.0-rc.2
- v2.0.0-rc.1
- v2.0.0-beta.4
- v2.0.0-beta.3
- v2.0.0-beta.2
- v2.0.0-beta.1
- v2.0.0-alpha.6
- v2.0.0-alpha.5
- v1.1.4
- v1.1.3
- v1.1.2
- v1.1.1
- v1.1.0
- v1.0.0
- v0.3.3
- v0.3.2
- v0.3.1
- v0.3.0
- v0.2.9
- v0.2.8
- v0.2.7
- v0.2.6
- v0.2.5
- v0.2.4
- v0.2.3
- v0.2.2
- v0.2.1
- v0.2.0
- v0.1.2
- v0.1.1
- v0.1.0
- v0.0.3
- v0.0.2
- v0.0.1
This package is not auto-updated.
Last update: 2024-11-19 19:58:18 UTC
README
AVISO!
A carteira de clientes da Juno foi comprada pela iugu, e, por isso, este pacote se tornará obsoleto.
juno-sdk-php-laravel foi criado e é mantido pela equipe Jetimob. É um SDK utilizado para interagir com a API da Juno de forma simples e direta. A complexidade de autenticação OAuth2 é abstraída pelo pacote http-php-laravel, também desenvolvido dentro da Jetimob.
Os comandos abaixo devem ser executados dentro da pasta raíz do projeto onde o pacote deve ser instalado.
Versão 2.0
ATENÇÃO!
A versão
2.x
não é compatível com as versões inferiores!
Instalação
Utilizando o composer:
composer require jetimob/juno-sdk-php-laravel
Configuração
Para começar, as configurações do pacote devem ser publicadas através do comando:
php artisan juno:install
Este comando irá criar o arquivo de configuração juno.php
no diretório config
para que você possa modificar conforme
a necessidade do seu projeto.
As únicas configurações obrigatórias que precisam ser especificadas, são:
- resource_token
- oauth_client_id
- oauth_client_secret
Mais informações sobre as demais configurações podem ser encontradas no próprio arquivo.
resource_token
Muitos dos recursos também necessitam de um token de recurso, X-Resource-Token que identifica a conta digital que deverá ser utilizada durante a execução de uma operação. Cada conta digital tem o seu próprio token de recurso. Contas digitais criadas via API incluem o token de recurso na resposta da requisição. Para obter o token de recurso de uma conta digital já existente ou para redefinir o token de recurso, o cliente precisa acessar o painel do cliente Juno e realizar esta operação na aba Integração, opção Token Privado.
O resource_token
é utilizado como valor padrão para o header 'X-Resource-Token' que identifica uma conta
dentro da API da Juno. Esse valor pode ser sobrescrito programaticamente utilizando o método using
de cada API.
Ex.:
Juno::balance()->using('[Novo X-Resource-Token]')->get();
oauth_client_id
Instruções para obtenção aqui.
oauth_client_secret
Instruções para obtenção aqui.
Uso
Sempre que for chamar qualquer api do pacote *juno-sdk-php-laravel, utilize o namespace Jetimob\Juno\Facades\Juno
ou, simplesmente, Juno
. O namespace Juno
é registrado automaticamente pelo Laravel, ou seja, a importação pode
ser feita apenas com use Juno;
no topo de um arquivo.
Qualquer uma das implementações de API encontradas na configuração api_impl
podem ser acessadas diretamente através
da façade Juno
, invocando um método de mesmo nome da chave de configuração. Em outras palavras, a chave account
, que
representa a classe \Jetimob\Juno\Api\Account\AccountApi::class
, dentro do vetor api_impl
do arquivo de
configurações pode ser invocada com \Juno::account()
. O retorno desta função é uma instância de
\Jetimob\Juno\Api\Account\AccountApi::class
(definido pelo arquivo de configuração).
Licença
juno-sdk-php-laravel está licenciado sob The MIT License (MIT).
Mais informações sobre a API da Juno podem ser encontradas aqui e aqui (PDF detalhado).