Download the PHP package vitorccs/maxipago-php-sdk without Composer
On this page you can find all versions of the php package vitorccs/maxipago-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vitorccs/maxipago-php-sdk
More information about vitorccs/maxipago-php-sdk
Files in vitorccs/maxipago-php-sdk
Package maxipago-php-sdk
Short Description SDK em PHP para API Maxipago
License GPL-3.0
Homepage https://github.com/vitorccs/maxipago-php-sdk
Informations about the package maxipago-php-sdk
Maxipago - SDK PHP
SDK em PHP para API Maxipago
Requisitos
- PHP >= 8.1
Descrição
SDK em PHP para a API Maxipago.
Instalação
Via Composer
Parâmetros
Parâmetro | Obrigatório | Padrão | Comentário |
---|---|---|---|
MAXIPAGO_MERCHANT_ID | Sim | null | Merchant ID para autenticação |
MAXIPAGO_MERCHANT_KEY | Sim | null | Merchant Key para autenticação |
MAXIPAGO_SANDBOX | Não | false | Habilita o modo Sandbox |
MAXIPAGO_TIMEOUT | Não | 30 | Timeout em segundos para estabelecer conexão com a API |
Podem ser definidos por variáveis de ambiente:
Ou passados como argumentos do serviço:
Serviços implementados
Criar Cliente
Realizar Pedido
Consultar Pedido
Pode-se obter a transação por qualquer um destes critérios
Cancelar Pedido
Estornar Pedido
Gerenciar Cartões de Crédito
Construtores (Builders)
Para auxiliar a criar uma Transação, foram disponibilizados alguns construtores:
Criar Cliente
`
Criar Pedido Boleto
Criar Pedido Cartão de Crédito
Criar Pedido PIX
Tratamento de erros
Esta biblioteca lança as exceções abaixo:
Principais:
MaxipagoValidationException
para erros diversos detectados pela API Maxipago, inclusive erros que impediram a Transação de ser criada (errorCode
diferente de 0).MaxipagoRequestException
para as demais falhas não tratadas pela API, incluindo erros de servidor (HTTP 4xx ou 5xx) e de conexão (ex: timeout).
No serviço de Criar Transação:
MaxipagoProcessorException
quando a Transação conseguiu ser criada pela Maxipago, mas há um erro de "processor" (responseCode
diferente de 0).
No serviço de Consultar Transação:
MaxipagoNotFoundException
ao tentar localizar uma Transação que não existe (ex: localizar por OrderId ou TransactionId).
Exemplo de corpo da resposta onde será lançado uma exceção MaxipagoValidationException
Exemplo de corpo da resposta onde será lançado uma exceção MaxipagoProcessorException
Exemplo de implementação
Webhooks
Para processar os webhooks da Maxipago, pode-se usar a biblioteca de conversão de XML para PHP.
Testes
Caso queira contribuir, por favor, implementar testes de unidade em PHPUnit.
Para executar:
All versions of maxipago-php-sdk with dependencies
guzzlehttp/guzzle Version ^7.4.2
ext-json Version *
ext-simplexml Version *
ext-libxml Version *
symfony/serializer Version ^7.1