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 Código QR 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 | invalid_path_param | El order_id enviado en el path tiene formato inválido. Debe comenzar con el prefijo ORD seguido de 26 caracteres. | Verifica y reenvía con un ID válido. |
400 | invalid_order_owner | No es posible procesar el reembolso de una order que no fue creada por el solicitante. | Verifica si el Access Token pertenece al mismo usuario que creó la order. |
400 | in_store_payment_refund_order | Se superó el plazo máximo para reembolso. El límite es de 360 días a partir de la fecha del pago. | Ninguna acción posible; el plazo de reembolso ya expiró. |
400 | unsupported_partially_refunds | La order no admite reembolsos parciales. | Verifica 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. | Verifica que el valor enviado sea menor o igual al saldo de la transacción. |
401 | unauthorized | El Access Token enviado es inválido o expiró. | Verifica y reenvía la solicitud con el Access Token correcto. |
401 | user_not_authorized | El usuario no tiene permiso para ejecutar esta acción. | Verifica 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. | Realiza el reembolso total sin enviar el array transactions[]. |
404 | order_not_found | Order no encontrada. | Verifica si el order_id enviado en el path es correcto. |
404 | transaction_not_found | Transacción no encontrada en la order. | Verifica si el transactions[].id enviado pertenece a la order especificada. |
409 | idempotency_key_already_used | El X-Idempotency-Key enviado ya fue utilizado con un body diferente en las últimas 24 horas. | Envía 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. | Verifica 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 360 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. | Verifica el status y el status_detail de la order antes de intentar el reembolso. |
409 | refund_in_progress | Ya existe un reembolso en procesamiento para esta order. | Aguarda algunos minutos antes de volver a intentarlo. |
409 | movement_operations_pending | La order tiene movimientos financieros pendientes. | Aguarda algunos minutos y repite la solicitud. |
422 | payment_not_refundable | El pago no puede ser reembolsado. | Verifica las condiciones del pago; algunos medios de pago no admiten reembolso. |
422 | amount_not_refundable | El monto solicitado no puede ser reembolsado. | Intenta con un monto diferente o verifica 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. | Aguarda unos instantes y repite la solicitud. |
428 | insufficient_money_for_refund | Saldo insuficiente en la cuenta para procesar el reembolso. | Verifica 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. | Repite la solicitud con el mismo X-Idempotency-Key. |
500 | genérico | Error interno del servidor. | Repite la solicitud. Si el problema persiste, consulta al soporte. |