Documentação neo-pays
A API de cobrança e de pagamento da neo-pays: dinheiro móvel, transferência para um IBAN dedicado e pagamento instantâneo do BCEAO, por trás de uma única integração.
Começar
- Início rápido — da conta à primeira cobrança
- Autenticação — chaves, modo de teste, idempotência
- Referência da API — todas as operações, gerada a partir da especificação
Os guias
| Guia | O que cobre |
|---|---|
| Cobranças | Criar um pagamento, lê-lo, acompanhá-lo |
| Pagamentos | Enviar fundos, e o saldo que os governa |
| Reembolsos | Devolver a totalidade ou parte de uma cobrança |
| Estados | O ciclo de vida de uma operação |
| Webhooks | Assinatura, reenvio, deduplicação |
| Erros | O envelope, e o que cada código lhe pede para fazer |
Três coisas a saber antes de escrever código
Os montantes vão em unidades menores, como cadeia de caracteres. "amount_minor": "500000" num
activo sem casas decimais são 500 000. Nunca um número de vírgula flutuante, nunca um inteiro JSON:
ambos perdem cêntimos. O número de casas decimais de cada activo é dado por GET /v1/assets — não o
escreva no código.
Os activos e as plataformas são identificadores, não símbolos. Envia asset_id e platform_id,
não "XOF" nem "orange_money". GET /v1/corridors diz quais a SUA conta pode usar, pela ordem em
que o encaminhamento os escolheria.
Não existe conversão de moeda. Os montantes nunca se somam entre activos, e nenhuma chamada converte um no outro.
Uma só versão
A API é /v1, e é a única. A camada de compatibilidade haybtech que ocupava esse caminho foi
eliminada a 12/09/2026 — nunca nada foi entregue sobre ela — e a superfície neo-pays, até então
montada em /v2, tomou o seu lugar. Se encontrar uma referência a /v2, está desactualizada.