PHPackages                             appmax/appmax\_api\_sdk\_php - 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. [API Development](/categories/api)
4. /
5. appmax/appmax\_api\_sdk\_php

ActiveLibrary[API Development](/categories/api)

appmax/appmax\_api\_sdk\_php
============================

SDK não oficial para consumo da API da Appmax em PHP

1692↑22.7%PHP

Since May 21Pushed 12mo ago1 watchersCompare

[ Source](https://github.com/RafaelMarquesFull/appmax-sdk-php)[ Packagist](https://packagist.org/packages/appmax/appmax_api_sdk_php)[ RSS](/packages/appmax-appmax-api-sdk-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

SDK Appmax para PHP
===================

[](#sdk-appmax-para-php)

Este SDK não oficial permite a integração com a API da Appmax de forma simples e direta em projetos PHP.

Esta não é uma versão oficial.
------------------------------

[](#esta-não-é-uma-versão-oficial)

Requisitos
----------

[](#requisitos)

- PHP 8.1 ou superior
- Extensão cURL habilitada

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

[](#instalação)

1. Faça o download do pacote
2. Extraia os arquivos em seu projeto
3. Inclua o autoloader:

```
composer require appmax/appmax_api_sdk_php
```

Uso Básico
----------

[](#uso-básico)

### Inicialização

[](#inicialização)

```
use Appmax\AppmaxAPI;

// Inicializar o SDK com sua chave de API
$appmax = new AppmaxAPI('sua_chave_api_aqui');

// Para ambiente de testes
$appmax = new AppmaxAPI('sua_chave_api_aqui', ['testMode' => true]);
```

### Criar um Cliente

[](#criar-um-cliente)

```
try {
    $cliente = $appmax->customers->create([
        'firstName' => 'Nome',
        'lastName' => 'Sobrenome',
        'email' => 'email@exemplo.com',
        'telephone' => '11999999999',
        'ip' => '127.0.0.1',
        'address' => [
            'postcode' => '12345678',
            'street' => 'Rua Exemplo',
            'number' => '123',
            'district' => 'Bairro',
            'city' => 'Cidade',
            'state' => 'SP'
        ]
    ]);

    // O hash do cliente é necessário para criar pedidos
    $clienteHash = $cliente['hash'];

} catch (\Appmax\Structures\AppmaxAPIError $e) {
    echo "Erro: " . $e->getMessage();
}
```

### Criar um Pedido

[](#criar-um-pedido)

```
try {
    $pedido = $appmax->orders->create([
        'customerHash' => $clienteHash,
        'total' => 99.90,
        'items' => [
            [
                'name' => 'Produto Exemplo',
                'price' => 99.90,
                'quantity' => 1,
                'sku' => 'SKU123'
            ]
        ]
    ]);

    // O hash do pedido é necessário para criar pagamentos
    $pedidoHash = $pedido['hash'];

} catch (\Appmax\Structures\AppmaxAPIError $e) {
    echo "Erro: " . $e->getMessage();
}
```

### Criar um Pagamento

[](#criar-um-pagamento)

```
try {
    // Exemplo com cartão de crédito
    $pagamento = $appmax->payments->create([
        'orderHash' => $pedidoHash,
        'method' => 'credit_card',
        'installments' => 1,
        'card' => [
            'number' => '4111111111111111',
            'holder' => 'NOME DO TITULAR',
            'expiry' => '12/25',
            'cvv' => '123',
            'brand' => 'visa'
        ]
    ]);

    // Ou usando token do cartão
    $pagamento = $appmax->payments->create([
        'orderHash' => $pedidoHash,
        'method' => 'credit_card',
        'installments' => 1,
        'card' => [
            'token' => 'token_do_cartao',
            'holder' => 'NOME DO TITULAR',
            'brand' => 'visa'
        ]
    ]);

} catch (\Appmax\Structures\AppmaxAPIError $e) {
    echo "Erro: " . $e->getMessage();
}
```

### Tokenizar Cartão

[](#tokenizar-cartão)

```
try {
    $token = $appmax->payments->tokenize([
        'number' => '4111111111111111',
        'holder' => 'NOME DO TITULAR',
        'expiry' => '12/25',
        'cvv' => '123',
        'brand' => 'visa'
    ]);

    // Usar o token em pagamentos futuros
    $tokenCartao = $token['token'];

} catch (\Appmax\Structures\AppmaxAPIError $e) {
    echo "Erro: " . $e->getMessage();
}
```

### Obter Parcelas Disponíveis

[](#obter-parcelas-disponíveis)

```
try {
    $parcelas = $appmax->payments->getInstallments(99.90, 'visa');

    // Lista de parcelas disponíveis
    foreach ($parcelas as $parcela) {
        echo "Parcelas: " . $parcela['installments'];
        echo " - Valor: " . $parcela['installment_amount'];
        echo " - Total: " . $parcela['amount'];
        echo "\n";
    }

} catch (\Appmax\Structures\AppmaxAPIError $e) {
    echo "Erro: " . $e->getMessage();
}
```

### Adicionar Código de Rastreio

[](#adicionar-código-de-rastreio)

```
try {
    $appmax->orders->addTrackingCode($pedidoHash, 'BR1234567890BR');
} catch (\Appmax\Structures\AppmaxAPIError $e) {
    echo "Erro: " . $e->getMessage();
}
```

### Reembolsar Pedido

[](#reembolsar-pedido)

```
try {
    $appmax->orders->refund($pedidoHash, [
        'reason' => 'Motivo do reembolso',
        'amount' => 99.90 // opcional, para reembolso parcial
    ]);
} catch (\Appmax\Structures\AppmaxAPIError $e) {
    echo "Erro: " . $e->getMessage();
}
```

Tratamento de Erros
-------------------

[](#tratamento-de-erros)

Todas as operações podem lançar exceções do tipo `\Appmax\Structures\AppmaxAPIError` em caso de falha. Sempre envolva as chamadas em blocos try/catch para tratar os erros adequadamente.

```
try {
    // Operação com o SDK
} catch (\Appmax\Structures\AppmaxAPIError $e) {
    echo "Código do erro: " . $e->getCode();
    echo "Mensagem: " . $e->getMessage();

    // Dados adicionais do erro, se disponíveis
    $dadosErro = $e->getErrorData();
}
```

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/2570ef26b12b0b040efd88991a768699d5cbf78522762255f8b86df57b9f24f4?d=identicon)[RafaelMarquesFull](/maintainers/RafaelMarquesFull)

---

Top Contributors

[![RafaelMarquesFull](https://avatars.githubusercontent.com/u/107640792?v=4)](https://github.com/RafaelMarquesFull "RafaelMarquesFull (4 commits)")

### Embed Badge

![Health badge](/badges/appmax-appmax-api-sdk-php/health.svg)

```
[![Health](https://phpackages.com/badges/appmax-appmax-api-sdk-php/health.svg)](https://phpackages.com/packages/appmax-appmax-api-sdk-php)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

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