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:

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.

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:

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.