Cancel

Este endpoint permite cancelar un pago PIX que se encuentra pendiente de pago. Una vez cancelado, el código PIX deja de ser válido y el cliente no podrá completar el pago. Es ideal para casos donde el cliente abandona la compra o se detecta un error en la transacción.

Características Principales

• Cliente abandona compra: Cancelar PIX generado pero no pagado

• Error en monto o datos: Cancelar y generar nuevo PIX correcto

• Tiempo excedido: Cancelar antes de que expire automáticamente

• Prevención de fraudes: Cancelar transacciones sospechosas

Flujo de Cancelación

1. Validación de identidad del merchant

2. Verificación de estado (solo pagos IN_PROGRESS)

3. Comunicación con PagBrasil para invalidar PIX

4. Verificación de firma HMAC para seguridad

5. Actualización de estado a CANCELLED

Consideraciones Importantes

Estados que Permiten Cancelación

Estado	¿Cancelable?	Razón
IN_PROGRESS	SÍ	Pago pendiente de realizar
COMPLETED	NO	Ya fue pagado (usar refund)
CANCELLED	NO	Ya está cancelado
FAILED	NO	Ya falló anteriormente
EXPIRED	NO	Ya expiró automáticamente

Tiempos y Límites

• Cancelación inmediata: Procesamiento en tiempo real

• Antes de expiración: Debe cancelarse antes de los 30 minutos

• Una vez cancelado: No puede reactivarse