Ventas con tarjeta

La integración Ventas con tarjeta de POS Cloud to Cloud permite que tu sistema cobre con tarjetas de crédito, débito y prepago en un equipo POS Virtualpos y use otras funciones del equipo, como la impresora y el lector de códigos.

Todas las operaciones se crean con un mismo endpoint, indicando el tipo en operationType:

operationType	Qué hace	Ver
SALE	Venta con tarjeta, con propina opcional	Crear una venta
CHECKIN	Preautoriza un monto en la tarjeta (garantía)	Preautorización
CHECKOUT	Cierra una preautorización con el monto final	Cierre de preautorización
PRINT	Imprime un comprobante propio o reimprime un voucher	Imprimir · Reimprimir voucher
SCAN_BARCODE	Lee un código de barras o QR con la cámara del POS	Leer código de barras
GET_SERIAL	Obtiene el número de serie del POS	Obtener serial del POS

No confundir con la API de Checkins

CHECKIN y CHECKOUT de POS Cloud to Cloud son una preautorización presencial con la tarjeta física en el POS. La API de Checkins es otro producto, para garantías online con tarjeta tokenizada.

Endpoints

Método	Ruta	Descripción
POST	/api/v1/pos-operations	Crear una operación en un POS
GET	/api/v1/pos-operations/{paymentRequestId}	Consultar una operación
GET	/api/v1/pos-operations	Listar operaciones
GET	/api/v1/pos-operations/{paymentRequestId}/callback-attempts	Intentos de entrega del webhook
GET	/api/v1/pos-operations/{paymentRequestId}/callback-event	Contenido del webhook

Pasos para integrarte

1. Pide a tu ejecutivo tus credenciales y el acceso al ambiente de integración.
2. Envía la API key en cada request. Ver Autenticación.
3. Crea una venta usando un externalPaymentId único. Ver Estados e idempotencia.
4. Aprueba o rechaza la venta en el simulador de POS.
5. Recibe el resultado en tu callbackUrl y verifica su firma. Ver Webhooks.