Cancelar transacción

https://api-uat.kushkipagos.com

PATCH

/transfer/v1/cancel/{token}

🇨🇴 Solo Colombia · flujo Bre-B.

Cancela una transacción Bre-B activa antes de que llegue a un estado final, invalidando el código QR.

Úsalo cuando el cliente ingresó un monto equivocado, decide no completar el pago o cuando
necesitas emitir un QR nuevo antes de que expire el actual (el QR es válido por 10 minutos).

Una cancelación exitosa devuelve HTTP 204 No Content: no hay cuerpo de respuesta.

Ten en cuenta

Este endpoint aplica solo a transacciones creadas con flowType: "BRE_B".

Devuelve HTTP 400 con el código T023 si la transacción ya llegó a un estado final, en cuyo
caso no se puede cancelar.

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Request

Path Params

Header Params

Responses

🟢204No Content

Transacción cancelada. El código QR queda inválido y la respuesta no tiene cuerpo.

This response does not have a body.

🟠400Bad Request

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api-uat.kushkipagos.com/transfer/v1/cancel/A3pKwX200000yzQR9146362rJMCBSt7n' \
--header 'Private-Merchant-Id: 68sc9a1d38824acbb78b5bdd1fa3773d'

Response Example

400 - T023 — transaction already in a final status

{
    "code": "T023",
    "message": "Transacción posee un estado final."
}

Modified at 2026-09-11 15:05:29

Consultar estado

Transfer out