Ambientes

AvivPay ofrece dos ambientes aislados para integracion.

Produccion

Atributo	Valor
Base URL	https://api.avivpay.com.br
ISPB	04838403
Descripcion	Transacciones reales en el SPI/BACEN. Movimiento financiero efectivo.

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

Homologacion

Atributo	Valor
Base URL	Proporcionada bajo solicitud por el equipo AvivPay
ISPB	04838403
Descripcion	Ambiente de pruebas con datos aislados. Las transacciones no afectan saldos reales.

Homologacion

Use el ambiente de homologacion para desarrollar y probar su integracion antes de operar en produccion. Las credenciales son diferentes entre ambientes.

Credenciales

Las credenciales (client_id y client_secret) son proporcionadas por su gerente de cuenta durante el proceso de registro. Cada ambiente posee credenciales propias e independientes.

Las credenciales son exclusivas por ambiente

Las credenciales de homologacion no funcionan en produccion y viceversa. Nunca comparta sus credenciales con terceros.

Seguridad

Recurso	Detalles
HTTPS obligatorio	TLS 1.2 o superior en todas las conexiones
HSTS	HTTP Strict Transport Security habilitado
Cloud Armor (WAF)	Firewall de aplicacion web protegiendo el cluster
IP Whitelist	Obligatoria para cada API Key
HMAC-SHA512	Firma por solicitud en endpoints transaccionales

Requisitos de Integracion

• Todas las solicitudes deben usar HTTPS
• La API Key es permanente -- no expira. Configure IPs en la whitelist para seguridad
• Las solicitudes transaccionales (cash-in, cash-out, refund, webhooks) exigen HMAC-SHA512
• Valores monetarios: entrada en centavos (R$ 1,00 = 100), respuesta en unidades base (R$ 1,00 = 10000)
• Las respuestas siguen el patron {"worked": true/false, ...}
• Nunca use punto flotante para valores monetarios -- siempre enteros

Rate Limiting

Tipo	Limite
Por IP (autenticado)	90.000 solicitudes/minuto
Por IP (sin autenticacion)	5 solicitudes/minuto
Webhooks por cuenta	Hasta 5 URLs

Headers de rate limit en la respuesta:

X-RateLimit-Limit: 60000
X-RateLimit-Remaining: 59997
Retry-After: 3  (solo cuando 429)

Soporte

Para dudas sobre integracion, contacte al soporte tecnico por el canal proporcionado en su contrato.