Respuestas, consulta y códigos - Alignet Integration Docs

Pay-me PinPAD diferencia los resultados de negocio de los errores operativos mediante el código HTTP y el cuerpo JSON.

Un pago rechazado por el procesador devuelve HTTP 200 con status: "DENIED". No interpretes todos los HTTP 200 como aprobación.

Estructura de respuesta de pago

{
  "operationNumber": "44992528",
  "status": "APPROVED",
  "resultCode": "00",
  "resultMessage": "Aprobado",
  "authorizationCode": "123456",
  "completedAt": "2026-08-27T20:12:48Z"
}

Campo	Tipo	Descripción
`operationNumber`	String	Referencia recibida desde el sistema central. Puede faltar en errores de validación donde no fue posible identificarla.
`status`	String	Estado transaccional u operativo.
`resultCode`	String o null	Código financiero u operativo. `"00"` es el único código documentado como aprobación.
`resultMessage`	String	Mensaje legible asociado al resultado. Úsalo para diagnóstico, no para lógica de decisión.
`authorizationCode`	String o null	Código del procesador cuando el pago fue aprobado.
`completedAt`	String o null	Fecha y hora final en ISO 8601 UTC (`yyyy-MM-ddTHH:mm:ssZ`). Es `null` mientras no existe un resultado final.

Respuestas de `POST /authorize`

Pago aprobado — `200 OK`

{
  "operationNumber": "44992528",
  "status": "APPROVED",
  "resultCode": "00",
  "resultMessage": "Aprobado",
  "authorizationCode": "123456",
  "completedAt": "2026-08-27T20:12:48Z"
}

Confirma la venta —y ejecuta la acción de negocio asociada— únicamente cuando se cumplan ambas condiciones:

status = APPROVED
resultCode = 00

Pago rechazado — `200 OK`

{
  "operationNumber": "44992528",
  "status": "DENIED",
  "resultCode": "01",
  "resultMessage": "Peticion rechazada por el Procesador",
  "authorizationCode": null,
  "completedAt": "2026-08-27T20:12:48Z"
}

El rechazo es final para esa operación. Si el usuario desea volver a pagar, crea una operación nueva con otro operationNumber.

Resultado pendiente — `202 Accepted`

Retry-After: 2

{
  "operationNumber": "44992528",
  "status": "PENDING",
  "resultCode": "WAITING_RESULT",
  "resultMessage": "Consulte el estado antes de reintentar",
  "authorizationCode": null,
  "completedAt": null
}

No vuelvas a cobrar. Consulta la operación y respeta Retry-After cuando esté presente.

Terminal ocupado — `409 Conflict`

{
  "operationNumber": "44992530",
  "status": "ERROR",
  "resultCode": "POS_BUSY",
  "resultMessage": "El Pinpad está procesando otra operación",
  "authorizationCode": null,
  "completedAt": null
}

Pay-me PinPAD procesa una operación a la vez. Espera a que finalice la operación activa antes de reintentar la solicitud rechazada por concurrencia.

Terminal no disponible — `503 Service Unavailable`

{
  "operationNumber": "44992528",
  "status": "ERROR",
  "resultCode": "POS_NOT_AVAILABLE",
  "resultMessage": "El SDK de pagos no está disponible",
  "authorizationCode": null,
  "completedAt": null
}

El operador debe dejar Pay-me PinPAD abierta y en estado listo. Reintenta cuando el terminal vuelva a estar disponible.

Solicitud inválida — `400 Bad Request`

{
  "status": "ERROR",
  "resultCode": "BAD_REQUEST",
  "resultMessage": "amount inválido: debe ser un entero positivo en unidades menores"
}

Corrige la solicitud. No clasifiques este caso como un rechazo del procesador.

Consulta de estado

Usa la misma referencia que enviaste en la autorización:

GET /payments/{operationNumber}

Ejemplo:

GET http://192.168.68.121:8080/payments/44992528

Código HTTP	Significado	Acción del sistema central
`200 OK`	La operación tiene un resultado final.	Evalúa `status` y `resultCode`.
`202 Accepted`	La operación todavía está en curso o pendiente.	Consulta nuevamente y respeta `Retry-After` si está presente.
`404 Not Found`	No existe una operación con esa referencia.	Verifica que la referencia sea exactamente la enviada. No asumas que el pago fue rechazado.

Respuesta de una operación inexistente:

{
  "operationNumber": "27423555",
  "status": "ERROR",
  "resultCode": "NOT_FOUND",
  "resultMessage": "Operación no encontrada",
  "authorizationCode": null,
  "completedAt": null
}

Estados

`status`	Final	Significado	Acción
`APPROVED`	Sí	Pago aprobado.	Confirma solo si `resultCode` también es `"00"`.
`DENIED`	Sí	Pago rechazado por el procesador.	No confirmes. Un nuevo intento requiere otro `operationNumber`.
`CANCELLED`	Sí	La autorización terminó cancelada; no equivale a un extorno.	No confirmes. Un nuevo intento requiere otra referencia. Revisa la diferencia entre cancelación y extorno.
`PENDING`	No	Venció la espera, pero el cobro puede continuar.	Consulta; no inicies otro cobro.
`PROCESSING`	No	El cobro se está procesando.	Consulta; no inicies otro cobro.
`UNKNOWN`	No	El resultado es incierto, por ejemplo después de un reinicio durante el proceso.	Mantén la operación abierta y consulta.
`ERROR`	Depende del código HTTP y `resultCode`	Error operativo, de validación o de consulta.	Aplica el tratamiento del código recibido.

Códigos confirmados

`resultCode`	Contexto	Significado
`00`	Financiero	Pago aprobado.
`01`	Financiero, ejemplo verificado	Petición rechazada por el procesador.
`WAITING_RESULT`	Operativo	La operación sigue pendiente; consulta su estado.
`POS_BUSY`	Operativo	Ya existe otra operación activa.
`POS_NOT_AVAILABLE`	Operativo	El SDK de pagos no está disponible.
`BAD_REQUEST`	Validación	El JSON o uno de sus campos no cumple el contrato.
`NOT_FOUND`	Consulta	No existe una operación con esa referencia.

No se ha confirmado el catálogo completo de códigos del procesador. Trata únicamente APPROVED junto con "00" como aprobación. Conserva cualquier código desconocido y escálalo sin asignarle un significado.

Los códigos 14 y 15 no están confirmados para el contrato HTTP vigente de Transit. No los uses para decidir una cancelación hasta validarlos contra la implementación ECR.

Matriz de decisión

Respuesta	Decisión
`200` + `APPROVED` + `00`	Confirmar el pago, guardar el código de autorización y aplicar la regla de apertura.
`200` + `DENIED` o `CANCELLED`	No confirmar. Informar el resultado.
`202` + `PENDING`	Mantener la operación abierta y consultar.
`409` + `POS_BUSY`	Esperar a que el terminal se libere.
`503` + `POS_NOT_AVAILABLE`	Restablecer la disponibilidad del terminal y reintentar.
`400` + `BAD_REQUEST`	Corregir la solicitud.
Timeout o conexión interrumpida	Consultar la referencia original antes de cualquier nuevo cobro.

​Estructura de respuesta de pago

​Respuestas de POST /authorize

​Pago aprobado — 200 OK

​Pago rechazado — 200 OK

​Resultado pendiente — 202 Accepted

​Terminal ocupado — 409 Conflict

​Terminal no disponible — 503 Service Unavailable

​Solicitud inválida — 400 Bad Request

​Consulta de estado

​Estados

​Códigos confirmados

​Matriz de decisión

Estructura de respuesta de pago

Respuestas de `POST /authorize`

Pago aprobado — `200 OK`

Pago rechazado — `200 OK`

Resultado pendiente — `202 Accepted`

Terminal ocupado — `409 Conflict`

Terminal no disponible — `503 Service Unavailable`

Solicitud inválida — `400 Bad Request`

Consulta de estado

Estados

Códigos confirmados

Matriz de decisión