Ambientes y credenciales

POS Cloud to Cloud no está disponible en Sandbox

Las integraciones con equipos POS no operan en virtualpos-sandbox.com. Mientras desarrollas, intégrate contra el ambiente de integración que te habilita tu ejecutivo.

Cada integración usa una API distinta, por lo que sus URLs y credenciales también son distintas:

	Ventas con tarjeta	Suscripciones presenciales
URL base: integración	https://ms-payment-c2c.virtualpos-dev.com/ms-payment-c2c	Te la entrega tu ejecutivo
URL base: producción	https://ms-payment-c2c.virtualpos.cl/ms-payment-c2c	https://api.virtualpos.cl
Credenciales	API key y secreto de webhook	API KEY y SECRET KEY de la API de Virtualpos

Ventas con tarjeta

Credenciales

Las credenciales de Ventas con tarjeta no se obtienen en el portal de comercio: te las entrega tu ejecutivo asignado. Para cada ambiente recibirás:

• API key: autentica tus solicitudes en el header X-Api-Key. Ver Autenticación.
• Secreto de webhook: te permite verificar que los webhooks que recibes los envió Virtualpos. Ver Webhooks.
• Serial del POS: en integración, el serial de tu POS virtual. En producción, el de cada equipo habilitado.

Precaución

La API key y el secreto de webhook se usan solo en tu servidor. Nunca los incluyas en código que se ejecute en el navegador, en una app móvil ni en el propio POS.

Simulador de POS

El simulador reemplaza al equipo físico mientras te integras. Te permite ver las operaciones que tu sistema envía a tu POS virtual y aprobarlas o rechazarlas tú mismo, para probar cada camino de tu integración, incluido tu webhook.

• URL: c2c-console.virtualpos-dev.com
• Acceso: lo habilita Virtualpos. Pídelo a tu ejecutivo o escríbenos a soporte@virtualpos.cl.

Flujo de prueba:

1. Crea una operación contra el ambiente de integración usando el serial de tu POS virtual.
2. En el simulador, la operación aparece en Operaciones con estado DISPATCHED.
3. Presiona Responder y elige el resultado: aprobar o rechazar.
4. Recibe el webhook en tu callbackUrl y consulta el estado final con la API.

Prueba tu webhook sin publicar tu servidor

Usa una URL de Webhook.site como callbackUrl para ver los webhooks que envía Virtualpos, con sus headers y su body, antes de tener tu propio endpoint publicado.

Suscripciones presenciales

Suscripciones presenciales usa la API de Virtualpos: las mismas llaves y la misma firma JWT que Suscripciones. Para probar, tu ejecutivo te habilita el ambiente de integración y te entrega:

• La URL base de la API de integración.
• Tu API KEY y SECRET KEY de ese ambiente.
• El serial del POS al que enviarás las suscripciones.

En producción usas la URL https://api.virtualpos.cl y las llaves de tu portal de comercio de Producción.

Pasar a Producción

Cuando tu integración funcione en el ambiente de integración, tu ejecutivo habilita tus equipos POS en Producción. Solo debes cambiar:

1. La URL base de la API, a la de producción de cada integración (ver tabla).
2. Tus credenciales, por las de Producción.
3. El serial del POS, por el de tus equipos reales.