# Introdução

> O que o PayApp verifica num comprovativo e como pensar a integração.

O PayApp confirma se um comprovativo de transferência bancária angolano é genuíno, se o dinheiro
foi para a conta certa e se aquele comprovativo já foi usado antes. É um produto da Ferreira Korp,
em Luanda.

## O que é verificado

Cada comprovativo enviado passa por três perguntas:

- **É autêntico?** A assinatura digital do banco no PDF confere.
- **É para si?** O destino da transferência é uma das contas registadas da loja.
- **É novo?** Este comprovativo ainda não tinha sido verificado na sua loja.

> **Regra de negócio:** só entregue a mercadoria quando `autentico === true` **e** `repetido === false`. Um comprovativo autêntico mas repetido é a tentativa de burla mais comum: o mesmo PDF verdadeiro reenviado a várias lojas.

## Onde se usa

- **API**, para integrar no seu site ou sistema.
- **WhatsApp**, para verificar sem escrever código.
- **Aplicação Android**, para a loja física.

## Endereço base

Todos os pedidos da API vão para:

```bash
https://api.payapp.ferreirakorp.com
```

A autenticação faz-se com a chave da loja no cabeçalho `X-API-Key: pk_live_…` (ou
`Authorization: Bearer pk_live_…`). A chave obtém-se no
[painel](https://api.payapp.ferreirakorp.com/painel).

## Privacidade por desenho

O PDF enviado **não é guardado em lado nenhum**. É analisado em memória e descartado no fim do
pedido. O nome, o IBAN e o valor existem apenas na resposta devolvida: não ficam no servidor.

Para detectar comprovativos repetidos guarda-se só uma impressão digital irreversível:

```bash
SHA-256(id_da_loja + numero_da_transaccao + sal_secreto)
```

Leva o identificador da loja lá dentro, por isso a mesma transacção gera impressões diferentes em
lojas diferentes. Consequência prática: **se precisar do histórico com valores, guarde-o do seu
lado** a partir das respostas. A API só devolve contagens.

---
Fonte: https://payapp-ao.com/docs