Reversión de Transacciones

Overview

Este endpoint permite reversar una transacción aprobada. La reversión está disponible para transacciones procesadas por Redeban (MasterCard) o Credibanco (Visa) y debe realizarse antes de las 9:00 PM del día de la aprobación.

Reversar Transacción

Nombre del campo Descripción Reglas
transaction_id ID único de la transacción que se desea reversar required, exists:transactions
comment Comentario o razón de la reversión required, string, min:1, max:255

Restricciones:

  • La transacción debe tener menos de un año de antigüedad
  • No debe tener un contracargo asociado
  • No puede ser una transacción tokenizada
  • Debe haber saldo disponible suficiente para realizar la reversión
  • Solo se pueden reversar transacciones realizadas con tarjeta de crédito/débito
  • Solo se pueden reversar transacciones procesadas por Redeban (MasterCard) o Credibanco (Visa)
  • Solo se pueden reversar transacciones agregadoras
  • Solo se pueden reversar transacciones realizadas con tarjetas Mastercard o Visa
  • Si la transacción ya tiene una reversión, solo se puede intentar nuevamente si el código de respuesta lo permite
  • La reversión debe realizarse antes de las 9:00 PM del día de la aprobación

Ejemplo de solicitud:

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

Respuesta exitosa:

{
    "reversed": true,
    "message": "La transacción ha sido reversada."
}

Posibles errores:

Código HTTP Mensaje
404 La transacción solicitada no existe en el sistema.
400 La transacción no puede ser reversada porque está fuera del horario permitido (debe ser antes de las 21:00).
400 La transacción no puede ser reversada porque tiene más de un año de antigüedad.
400 No es posible reversar una transacción que tiene un contracargo asociado.
400 No es posible reversar una transacción tokenizada.
400 No hay saldo disponible suficiente para realizar la reversión.
400 Solo es posible reversar transacciones realizadas con tarjeta de crédito/débito.
400 Solo es posible reversar transacciones procesadas por Redeban o Credibanco.
400 Solo es posible reversar transacciones agregadoras.
400 Solo es posible reversar transacciones realizadas con tarjetas Mastercard o Visa.
400 La transacción ya tiene una reversión y no es posible realizar otro intento.