Ambientes

A Owem Pay disponibiliza dois ambientes isolados para integracao.

Producao

Atributo	Valor
Base URL	https://api.owem.com.br
ISPB	37839059
Descricao	Transacoes reais no SPI/BACEN. Movimentacao financeira efetiva.

https://api.owem.com.br/api/external/...

Homologacao

Atributo	Valor
Base URL	https://api-hml.owem.com.br
ISPB	37839059
Descricao	Ambiente de testes com dados isolados. Transacoes nao afetam saldos reais.

https://api-hml.owem.com.br/api/external/...

Homologacao

Use o ambiente de homologacao para desenvolver e testar sua integracao antes de operar em producao. As credenciais sao diferentes entre ambientes.

Credenciais

As credenciais (client_id e client_secret) sao fornecidas pelo seu gerente de conta durante o processo de cadastro. Cada ambiente possui credenciais proprias e independentes.

Credenciais sao exclusivas por ambiente

Credenciais de homologacao nao funcionam em producao e vice-versa. Nunca compartilhe suas credenciais com terceiros.

Seguranca

Recurso	Detalhes
HTTPS obrigatorio	TLS 1.2 ou superior em todas as conexoes
HSTS	HTTP Strict Transport Security habilitado
Cloud Armor (WAF)	Firewall de aplicacao web protegendo o cluster
IP Whitelist	Obrigatoria para cada API Key
HMAC-SHA512	Assinatura por requisicao em endpoints transacionais

Requisitos de Integracao

• Todas as requisicoes devem usar HTTPS
• A API Key e permanente -- nao expira. Configure IPs na whitelist para seguranca
• Requisicoes transacionais (cash-in, cash-out, refund, webhooks) exigem HMAC-SHA512
• Valores monetarios: entrada em centavos (R$ 1,00 = 100), resposta em unidades base (R$ 1,00 = 10000)
• Respostas seguem o padrao {"worked": true/false, ...}
• Nunca use ponto flutuante para valores monetarios -- sempre inteiros

Rate Limiting

Tipo	Limite
Por IP (autenticado)	60.000 requisicoes/minuto
Por IP (sem autenticacao)	5 requisicoes/minuto
Webhooks por conta	Ate 5 URLs

Headers de rate limit na resposta:

X-RateLimit-Limit: 60000
X-RateLimit-Remaining: 59997
Retry-After: 3  (apenas quando 429)

Suporte

Para duvidas sobre integracao, entre em contato com o suporte tecnico pelo canal disponibilizado no seu contrato.