Anulación de Transacciones

{danger} Este endpoint ya no existe.

POST /api/v1/payment/cancel-transaction fue retirado de la API. Esta página se conserva solo como referencia histórica: si tu integración todavía lo llama, recibirás un 404.

Usa Refund / Reversión — POST /api/v1/payment/refund-transaction— que cubre tanto la anulación del mismo día como la reversión posterior.

Overview

Este endpoint permite anular una transacción aprobada. La anulación solo está disponible para transacciones procesadas por Credibanco y debe realizarse antes de las 9:00 PM del día de la aprobación.

Anular Transacción

Nombre del campo Descripción Reglas
transaction_id El transaction_id de la transacción a anular ['required', 'exists:transactions,transaction_id']
comment Motivo de la anulación ['required', 'string', 'min:1', 'max:255']

Restricciones:

  • Solo se pueden anular transacciones procesadas por Credibanco(Visa)
  • La transacción no debe tener un contracargo asociado
  • La transacción debe estar en estado aprobado
  • Solo se pueden anular transacciones realizadas con tarjeta de crédito/débito
  • La anulación debe realizarse antes de las 9:00 PM del día de la aprobación

Ejemplo de solicitud:

curl -X POST \
'/api/v1/payment/cancel-transaction' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H "Content-type: application/json" \
-d '{
    "transaction_id": "123e4567-e89b-12d3-a456-426614174000",
    "comment": "Anulación por solicitud del cliente"
}'

Respuesta exitosa:

{
    "cancelled": true,
    "message": "La transacción ha sido anulada."
}

Posibles errores:

Código HTTP Mensaje
404 La transacción solicitada no existe en el sistema.
400 Solo se pueden anular transacciones procesadas por Credibanco.
400 No se pueden anular transacciones que tienen un contracargo asociado.
400 Esta transacción ya ha sido anulada previamente.
400 Solo se pueden anular transacciones que estén en estado aprobado.
400 Solo se pueden anular transacciones realizadas con tarjeta de crédito/débito.
400 La transacción no puede ser anulada después de las 9:00 PM del día de la aprobación.