> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pay-me.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Cancelación de una autorización en curso
> Cancelación validada y recuperación del cobro original ante fallos o incertidumbre.
`POST /cancel` solicita cancelar una autorización activa. El servicio debe comprobar que la cancelación se ejecutó y que el resultado corresponde al `operationNumber` solicitado.
Cerrar la pantalla del POS no confirma la cancelación. Si no se ejecutó o el resultado corresponde a otra operación, el servicio debe devolver un error, sin informar éxito.
## CARD
`POST /authorize` inicia el cobro y el PinPAD solicita la tarjeta. Si la cancelación falla y el cobro original queda `transaction.state: "AUTORIZADO"` en una consulta `200/00`, puedes evaluar un [extorno independiente](/procesamiento-fisico/alignet-transit/extorno). Un error de `/cancel` no ejecuta automáticamente `/reversals`.
```mermaid theme={"system"}
flowchart TD
A[Cobro con tarjeta] --> B[Solicitar cancelación]
B -->|Confirmada| C[Operación cancelada]
B -->|No se confirmó| D[Consultar pasarela: transaction.state]
D -->|200 y 00: AUTORIZADO| E[Evaluar extorno CARD]
D -->|Otro desenlace financiero confirmado| F[Registrar desenlace]
D -->|03 o 05 o 503 o 504| G[Consultar de nuevo o escalar]
D -->|Sin confirmar| D
```
## QR
Al generar el QR ya existe una transacción pendiente asociada al `operationNumber`. Mostrar o escanear el código no confirma el pago.
En QR, `/cancel` solo cancela o inhabilita el código. Ni `/cancel` ni refund devuelven un monto pagado; `/reversals` aplica únicamente a CARD.
```mermaid theme={"system"}
flowchart TD
A[Generar QR] --> B[QR pendiente]
B -->|Pago aprobado| C[Pago aprobado]
B --> D[Solicitar cancelación]
D -->|Confirmada| E[QR cancelado]
D -->|No se confirmó| F[Consultar pasarela: transaction.state]
F -->|200 y 00: AUTORIZADO| C
F -->|Otro desenlace financiero confirmado| G[Registrar desenlace]
F -->|03 o 05 o 503 o 504| H[Consultar de nuevo o escalar]
F -->|Sin confirmar| F
```
Si recuperas un QR `transaction.state: "AUTORIZADO"` en una consulta `200/00`, conserva el pago aprobado. No lo marques como cancelado, devuelto ni extornado; registra la discrepancia para revisión.
## Solicitud
Envía al mismo PinPAD de la autorización original:
```http theme={"system"}
POST /cancel
Content-Type: application/json
Connection: close
```
```json theme={"system"}
{
"operationNumber": "44992528"
}
```
| Campo | Tipo | Obligatorio | Uso |
| - | - | - | - |
| `operationNumber` | String | Sí | Referencia original: 1–64 caracteres sin espacios (`^\S{1,64}$`). |
No generes otra referencia ni envíes monto, moneda, método o datos de tarjeta.
```bash theme={"system"}
curl --header "Connection: close" -i --request POST "http://:/cancel" \
--header "Content-Type: application/json" \
--max-time 110 \
--data '{"operationNumber":"44992528"}'
```
## Resultados por método
Estas reglas aplican a CARD y QR. Evalúa el estado, el código y la validación del servicio; HTTP `200` por sí solo no confirma éxito.
| HTTP | `status` y `resultCode` | Acción |
| - | - | - |
| `200` | `CANCELLED` con `00`, `16` o `17` | Cancelación confirmada o éxito equivalente, validado por el servicio. No exige otra consulta para reconocerla. |
| `200` | `DENIED` con `14`, `15`, `18`, `19`, `20`, `01`, `03` u otro código SDK | Cancelación rechazada o abandonada. Consulta el cobro original; no marques cancelación exitosa. |
| `202` | `PENDING` con `P22` | Resultado todavía no confirmado. Consulta el cobro original; este GET no informa el desenlace de `/cancel`. |
| `404` | `ERROR/NOT_FOUND` | Venta inexistente o resultado SDK `05/07`. Verifica referencia y terminal. |
| `409` | `ERROR/CANCELLATION_IN_PROGRESS` | Ya hay una cancelación de esa referencia en curso. No envíes otra. |
| `503` | `ERROR/POS_NOT_AVAILABLE` | Restablece SDK o pantalla disponible; consulta el cobro antes de decidir otro envío. |
| `400` | `ERROR/BAD_REQUEST` | Corrige el JSON. |
Reenviar una cancelación ya finalizada devuelve el resultado guardado; una segunda cancelación en curso devuelve `409 CANCELLATION_IN_PROGRESS`.
Ejemplos de campos de decisión, sin representar pruebas ejecutadas:
```json Abandono con 14 theme={"system"}
{
"operationNumber": "44992528",
"status": "DENIED",
"resultCode": "14"
}
```
```json Cancelación confirmada con 16 theme={"system"}
{
"operationNumber": "44992528",
"status": "CANCELLED",
"resultCode": "16"
}
```
`DENIED/14` indica abandono por cierre de autorización en curso; `15` indica abandono con intento (QR cancelado). No confirman cancelación aprobada ni son rechazo típico de tarjeta. Decide con estado y código. No normalices `16` o `17` a `00`.
## Verificar el resultado final
No existe un endpoint de consulta de cancelación. La respuesta de `POST /cancel` informa el resultado de esa solicitud. Ante fallo, timeout o incertidumbre, `GET /payments/{operationNumber}` consulta **la pasarela** y devuelve `success`, `resultCode`, `resultMessage` y `transaction`, sin `status` propio. `00` significa encontrada: lee `transaction.state`. Este GET no devuelve `202`. Aplica el [contrato de consulta](/procesamiento-fisico/alignet-transit/respuesta-estados-y-codigos#consulta-de-estado):
| Estado del cobro | Acción |
| - | - |
| CARD: `transaction.state: "AUTORIZADO"` en una consulta `200/00` | Tras una cancelación fallida, evalúa `POST /reversals` con la referencia original, sin duplicar extornos. |
| QR: `transaction.state: "AUTORIZADO"` en una consulta `200/00` | Conserva el pago aprobado, sin refund ni reversa. |
| `200/00` con `transaction.state: "CANCELADO"` | La pasarela registra el cobro cancelado; no es una consulta del desenlace de `/cancel`. |
| `200/00` con otro `transaction.state` | Interpreta el literal financiero del SDK; la guía no enumera todos los estados. |
| `200/03`, `404/05`, `503/P04` o `POS_NOT_AVAILABLE`, `504/SEARCH_TIMEOUT` | Cobro no verificado. Conserva la referencia, vuelve a consultar o escala; no deduzcas rechazo ni habilites otra venta. |
En los ciclos del gráfico, repite únicamente el GET. No reenvíes `/cancel` ni generes otra venta mientras no conozcas el resultado del cobro. Un `202 WAITING_RESULT` tardío de `/authorize` no sustituye un resultado confirmado.
## Fallos de cancelación
| Situación | Tratamiento |
| - | - |
| Cancelación no ejecutada o resultado de otra operación | El servicio devuelve un error; no puede informar cancelación exitosa. |
| Timeout, desconexión o fallo del backend | Muestra **Cancelación no confirmada** y recupera el cobro original. Si falta conexión, restablécela primero. |
| Cancelación ejecutada y resultado validado | Reconoce la respuesta de éxito de `/cancel`. El cierre visual por sí solo no acredita este resultado. |
La matriz no especifica la respuesta cuando la cancelación no se ejecuta o el resultado corresponde a otra operación. No asignes a ese caso un HTTP, código ni cuerpo JSON sin confirmación de desarrollo.
## Manejo de 202 y pérdida de conexión
Todas las respuestas incluyen `Cache-Control: no-store`. HTTP `202` añade `Retry-After: 2`: espera dos segundos antes de consultar el cobro original. Una desconexión no garantiza recepción de `/cancel` ni cierre de pantalla.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.