8080. Confirma la IP y el puerto de cada terminal antes de integrar.
Endpoints disponibles
POST /cancel y POST /reversals son operaciones distintas. Ambas usan el operationNumber de la autorización original y se consumen en el mismo host y puerto que POST /authorize.POST /cancel; /payments consulta el cobro original. Todas las respuestas incluyen Connection: close y Cache-Control: no-store; abre una conexión por petición. Solo HTTP 202 añade Retry-After: 2.
Verificar disponibilidad
GET /health al configurar el terminal y antes de iniciar operaciones cuando necesites comprobar disponibilidad. Una respuesta satisfactoria confirma la aplicación local; no confirma que el SDK esté inicializado ni que el procesador aprobará pagos.
Autorizar y consultar un pago
POST /authorize requiere un cuerpo JSON. Consulta Solicitud de autorización para conocer los campos, las validaciones y los ejemplos.
POST /authorize devuelve success, resultCode, resultMessage y result, sin status propio. GET /payments/{operationNumber} consulta la pasarela y devuelve success, resultCode, resultMessage y transaction, también sin status propio. 00 significa encontrada: lee transaction.state. Este GET no devuelve 202; consulta el contrato y la tabla HTTP. No lleva cuerpo. Usa exactamente la referencia enviada en la autorización:
Cancelar una autorización activa
POST /cancel recibe el operationNumber original. Reconoce cancelación exitosa solo con CANCELLED y 00, 16 o 17, validada por el servicio. HTTP 200 con DENIED, incluido 14, no confirma éxito.
Ante fallo, timeout o incertidumbre, consulta el cobro original; no hay un GET de cancelación. El cierre de pantalla no acredita el resultado. Revisa las respuestas y acciones de cancelación.
En QR solo se cancela o inhabilita el código; ni /cancel ni refund devuelven pagos. Un QR encontrado con transaction.state: "AUTORIZADO" conserva el pago aprobado, sin reversa.
Extornar una venta aprobada
POST /reversals solicita un extorno independiente y total de una venta CARD aprobada. No aplica a QR. Usa GET /reversals/{operationNumber} ante espera, timeout o pérdida de respuesta. Encontrar el cobro original no determina el resultado del extorno.
Consulta Extorno de una venta CARD aprobada para interpretar REVERSED, DENIED y el cuerpo compacto de 502 UNKNOWN.
Rutas fuera del contrato vigente
Una ruta válida con método incorrecto devuelve HTTP405 y METHOD_NOT_ALLOWED; una ruta desconocida devuelve HTTP 404 y NOT_FOUND.
No uses /payment, /api/v1/payments, /api/v1/payments/{operationNumber} ni DELETE /charges para esta integración. La autorización vigente sí incluye result.state y puede incluir transactionID, processorResponse y lifecycle. No traslades a esta interfaz los códigos locales P01–P21 de otras especificaciones.
Solicitud de autorización
Implementa el payload de
POST /authorize.Respuestas y códigos
Interpreta códigos HTTP y estados transaccionales.