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.
| Nombre del campo | Descripción | Reglas |
|---|---|---|
| transaction_id | ID único de la transacción que se desea anular | required, exists:transactions |
| comment | Comentario o razón de la anulación | required, string, min:1, max:255 |
Restricciones:
Ejemplo de solicitud:
curl -X POST \
'{{ URL::to('/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. |