Recursos para IA
Errores de reembolso
A continuación, encontrarás todos los posibles errores devueltos por el endpoint de reembolsoAPI de la API de Orders para Mercado Pago Point y las acciones recomendadas para cada caso.
Códigos de error
| HTTP | Error (error) | Descripción | Acción recomendada |
400 | empty_required_header | El header X-Idempotency-Key es obligatorio y no fue enviado. | Incluir el header en todas las solicitudes de reembolso. |
400 | unsupported_partially_refunds | La order no admite reembolsos parciales. | Verificar si la order es elegible para reembolso parcial antes de enviar el body con transactions[]. |
400 | refund_amount_exceeds | El monto del reembolso excede el saldo disponible. | Verificar que el valor enviado sea menor o igual al saldo de la transacción. |
401 | unauthorized | El Access Token enviado es inválido o expirado. | Verificar y reenviar con el token correcto. |
401 | user_not_authorized | El usuario no tiene permiso para ejecutar esta acción. | Verificar si el Access Token pertenece al mismo usuario que creó la order. |
403 | partial_refund_forbidden_with_tips | Los reembolsos parciales no están permitidos en orders con propina. | Realizar el reembolso total o no enviar el array transactions[]. |
404 | order_not_found | Order no encontrada. | Verificar si el order_id enviado en el path es correcto. |
404 | transaction_not_found | Transacción no encontrada en la order. | Verificar si el transactions[].id enviado pertenece a la order especificada. |
409 | refund_in_progress | Ya existe un reembolso en procesamiento para esta order. | Esperar algunos minutos antes de volver a intentarlo. |
409 | idempotency_key_already_used | El X-Idempotency-Key enviado ya fue utilizado con un body diferente en las últimas 24 horas. | Enviar un nuevo valor para el header. |
409 | order_already_refunded | La order ya fue reembolsada en su totalidad. | Ninguna acción necesaria; el reembolso ya fue completado. |
409 | cannot_refund_order | El estado actual de la order no permite reembolso. | Verificar si la order tiene status: processed antes de solicitar el reembolso. |
409 | refund_period_exceeded | Se superó el plazo máximo para reembolso. | Los reembolsos se aceptan hasta 90 días a partir de la fecha del pago. |
409 | action_not_allowed_for_current_state | La acción no está permitida por el estado actual del pago. | Verificar el status y el status_detail de la order antes de intentar el reembolso. |
409 | movement_operations_pending | La order tiene movimientos financieros pendientes. | Esperar algunos minutos y repetir la solicitud. |
422 | payment_not_refundable | El pago no puede ser reembolsado. | Verificar las condiciones del pago; algunos medios de pago no admiten reembolso. |
422 | amount_not_refundable | El monto solicitado no puede ser reembolsado. | Intentar con un monto diferente o verificar las condiciones del pago. |
422 | max_refunds_exceeded | Se superó el número máximo de reembolsos para esta order. | Ninguna acción posible; el límite de reembolsos ya fue alcanzado. |
425 | order_payment_not_yet_enabled_for_refund | La order aún no está habilitada para reembolso. | Esperar unos instantes y repetir la solicitud. |
428 | insufficient_money_for_refund | Saldo insuficiente en la cuenta para procesar el reembolso. | Verificar el saldo disponible en la cuenta de Mercado Pago antes de volver a intentarlo. |
500 | idempotency_validation_failed | Error en la validación de idempotencia. | Repetir la solicitud con el mismo X-Idempotency-Key. |
500 | genérico | Error interno del servidor. | Repetir la solicitud. Si el problema persiste, contactar al soporte. |