Autenticación

POS Cloud to Cloud no usa la firma JWT del resto de la API de Virtualpos. Cada solicitud se autentica con tu API key en el header X-Api-Key:

X-Api-Key: <tu-api-key>
Content-Type: application/json

Ambiente	URL base API
Integración	https://ms-payment-c2c.virtualpos-dev.com/ms-payment-c2c
Producción	https://ms-payment-c2c.virtualpos.cl/ms-payment-c2c

Alcance de la API key

• Cada API key está asociada a tu comercio. Solo puede crear y consultar operaciones de tu comercio, en los POS habilitados para POS Cloud to Cloud.
• No necesitas enviar tu código de comercio ni otros identificadores: Virtualpos los obtiene a partir de la API key.
• Puedes tener más de una API key activa, por ejemplo una por sistema o por sucursal. Pídelas a tu ejecutivo.

Si la API key falta o no es válida, la API responde 401 Unauthorized. Si intentas operar un POS que no está habilitado para tu comercio, responde 403 Forbidden. Ver Errores.

Buenas prácticas

• Guarda la API key en tu servidor, en variables de entorno o en un gestor de secretos.
• Envíala solo en el header X-Api-Key: nunca en la URL ni en query params.
• No la escribas en logs ni la compartas por correo o chat.
• Si crees que una API key quedó expuesta, pide a tu ejecutivo que la revoque y te entregue una nueva.