PHPackages                             bit-ao/appy-pay-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. [Payment Processing](/categories/payments)
4. /
5. bit-ao/appy-pay-php

ActiveLibrary[Payment Processing](/categories/payments)

bit-ao/appy-pay-php
===================

0.0.1(10mo ago)110MITPHPPHP >=8.1

Since Aug 29Pushed 10mo agoCompare

[ Source](https://github.com/bit-ao/appy-pay-php)[ Packagist](https://packagist.org/packages/bit-ao/appy-pay-php)[ RSS](/packages/bit-ao-appy-pay-php/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (4)Versions (3)Used By (0)

appy-pay-php
============

[](#appy-pay-php)

SDK/Helper/Adapter em **PHP puro** para facilitar a integração com a API da **AppyPay** — um facilitador de gateway de pagamento para empresas em Angola.
As APIs seguem princípios **REST**, com nomenclatura orientada a recursos, e as respostas são em **JSON**.

> ⚠️ **Estado**: Este repositório **esta em desenvolvimento**.

> ⚠️ **Aviso legal**: Este projeto é colaborativo e **não** representa, nem é afiliado, patrocinado, endossado ou associado a quaisquer marcas, bancos, operadoras, gateways, agregadores ou entidades citadas.
>
> Nomes e logótipos mencionados são propriedade dos seus titulares. As informações aqui reunidas podem ficar **desatualizadas**. Verifica sempre as **fontes oficiais** antes de decisões técnicas ou comerciais.
>
>  Este material é fornecido “**AS IS**”, sem garantias. **Não** constitui aconselhamento jurídico, financeiro ou fiscal.

---

🧱 Arquitectura (Clean/Hexagonal)
--------------------------------

[](#-arquitectura-cleanhexagonal)

- **Core** (estável, sem versão): Entidades, Value Objects, DTOs, Use Cases e Ports (interfaces).
- **Adapters** (versionados): Implementações específicas para a API da AppyPay `V1`, `V2`…
- **GatewayFactory**: escolhe o adapter pela versão configurada.
- **Laravel (opcional)**: ServiceProvider + config para *binding* via IoC.

```
src/
├─ Core/
│  ├─ Domain/{Entities,ValueObjects}
│  ├─ Contracts/
│  └─ Application/{DTO,UseCases}
├─ Adapters/
│  ├─ Http/{HttpClient,CurlHttpClient}
│  └─ AppyPay/{GatewayFactory, V1/*, V2/*}
└─ InterfaceAdapters/Laravel/{AppyPayServiceProvider.php,config/appypay.php}

```

📦 Instalação (quando publicar no Packagist)
-------------------------------------------

[](#-instalação-quando-publicar-no-packagist)

```
composer require /appy-pay-php
```

> Substitui `` pelo teu vendor (ex.: `bit-ao/appy-pay-php`).

⚙️ Configuração rápida (Laravel – opcional)
-------------------------------------------

[](#️-configuração-rápida-laravel--opcional)

1. Publica o config: `php artisan vendor:publish --tag=config`
2. Define no `.env`:

```
APPYPAY_BASE_URL=https://api.appypay.ao
APPYPAY_VERSION=v1
APPYPAY_API_KEY=seu_key
APPYPAY_API_SECRET=seu_secret

```

🚀 Exemplo rápido (PHP puro)
---------------------------

[](#-exemplo-rápido-php-puro)

```