Banco Activo Simulador

Guía de integración · v1.0.0 · http://activo.bancos-sandbox.qrovia.xyz

Emula las APIs de Banco Activo (Pago Móvil Interbancario y servicios de cuenta): P2C Validador (legacy), C2P con OTP, transferencias interna/externa y consultas de saldo/movimientos. REST/JSON sobre HTTPS, método POST.

Modelo de autenticación. OAuth2 client_credentials (Bearer JWT, TTL 3600s) emitido en POST /token, MÁS header apikey en cada llamada. Estilo WSO2 API Manager. El P2C legacy se controla por IP/VPN.

integration.json llms.txt /health Panel admin Especificación técnica

Endpoints

Método	Path	Servicio	Auth
`POST`	`/token`	OAuth2 token (client_credentials)	Basic key:secret
`GET`	`/jwks`	JWKS público	—
`POST`	`/api/transacciones`	P2C Validador — validar pago	IP/VPN (legacy)
`POST`	`/api/consultas`	P2C Validador — consultar pagos	IP/VPN (legacy)
`POST`	`/cobro/c2p/1.0.0/c2p`	C2P — cobro Pago Móvil (OTP)	Bearer + apikey
`POST`	`/api/transferencias/1.0.0/externa`	Transferencia externa	Bearer + apikey
`POST`	`/api/transferencia/1.0.0/interna`	Transferencia interna	Bearer + apikey
`POST`	`/consulta/saldo/pago_movil/1.0.0/saldos`	Consulta de saldo	Bearer + apikey
`POST`	`/api/consulta/1.0.0.0`	Consulta de movimientos	Bearer + apikey
`POST`	`/consulta/movimientos/1.0.0/ampliada-rango`	Movimientos por rango	Bearer + apikey
`GET`	`/health`	Estado del servicio	—

Notas

Formatos de monto por servicio: C2P con coma (1550,00), transferencias con punto (5.00), saldo locale VE (1.010.144,66).
Webhook saliente transaction_webhook con reintentos: registra tu endpoint en el panel admin.
Para forzar resultados de prueba (fondos insuficientes, OTP inválido, etc.) usa los valores mágicos del manual confidencial.

Material confidencial. Las credenciales, llaves de cifrado, identificadores y valores mágicos para pruebas se entregan por separado: docs/integration/banco-activo-integration.md (CONFIDENCIAL — solicítalo a tu contacto Qrovia)..

Sandbox de pruebas: no procesa dinero real ni se conecta a la red bancaria. Las credenciales y secretos se entregan por separado.

Para IA: lee http://activo.bancos-sandbox.qrovia.xyz/integration.json (descriptor máquina-legible).