Recursos para IA
Erros de reembolso
A seguir, você encontrará todos os possíveis erros retornados pelo endpoint de reembolsoAPI da API de Orders para QR Code e as ações recomendadas para cada caso.
Códigos de erro
| HTTP | Erro (error) | Descrição | Ação recomendada |
400 | empty_required_header | O header X-Idempotency-Key é obrigatório e não foi enviado. | Incluir o header em todas as requisições de reembolso. |
400 | invalid_path_param | O order_id enviado no path tem formato inválido. Deve começar com o prefixo ORD seguido de 26 caracteres. | Verificar e reenviar com um ID válido. |
400 | invalid_order_owner | Não é possível processar o reembolso de uma order que não foi criada pelo solicitante. | Verificar se o Access Token pertence ao mesmo usuário que criou a order. |
400 | in_store_payment_refund_order | O prazo máximo para reembolso foi excedido. O limite é de 360 dias a partir da data do pagamento. | Nenhuma ação possível; o prazo de reembolso já expirou. |
400 | unsupported_partially_refunds | A order não suporta reembolsos parciais. | Verificar se a order é elegível para reembolso parcial antes de enviar o body com transactions[]. |
400 | refund_amount_exceeds | O valor do reembolso excede o saldo disponível. | Verificar que o valor enviado seja menor ou igual ao saldo da transação. |
401 | unauthorized | O Access Token enviado é inválido ou expirou. | Verifique e reenvie a solicitação com o Access Token correto. |
401 | user_not_authorized | O usuário não tem permissão para executar esta ação. | Verificar se o Access Token pertence ao mesmo usuário que criou a order. |
403 | partial_refund_forbidden_with_tips | Reembolsos parciais não são permitidos em orders com gorjeta. | Realizar o reembolso total sem enviar o array transactions[]. |
404 | order_not_found | Order não encontrada. | Verificar se o order_id enviado no path está correto. |
404 | transaction_not_found | Transação não encontrada na order. | Verificar se o transactions[].id enviado pertence à order especificada. |
409 | idempotency_key_already_used | O X-Idempotency-Key enviado já foi utilizado com um body diferente nas últimas 24 horas. | Enviar um novo valor para o header. |
409 | order_already_refunded | A order já foi totalmente reembolsada. | Nenhuma ação necessária; o reembolso já foi concluído. |
409 | cannot_refund_order | O estado atual da order não permite reembolso. | Verificar se a order está com status: processed antes de solicitar o reembolso. |
409 | refund_period_exceeded | O prazo máximo para reembolso foi excedido. | Reembolsos são aceitos em até 360 dias a partir da data do pagamento. |
409 | action_not_allowed_for_current_state | A ação não é permitida pelo estado atual do pagamento. | Verificar o status e o status_detail da order antes de tentar o reembolso. |
409 | refund_in_progress | Já existe um reembolso em processamento para esta order. | Aguardar alguns minutos antes de tentar novamente. |
409 | movement_operations_pending | A order possui movimentos financeiros pendentes. | Aguardar alguns minutos e repetir a requisição. |
422 | payment_not_refundable | O pagamento não pode ser reembolsado. | Verificar as condições do pagamento; alguns meios de pagamento não suportam reembolso. |
422 | amount_not_refundable | O valor solicitado não pode ser reembolsado. | Tentar com um valor diferente ou verificar as condições do pagamento. |
422 | max_refunds_exceeded | O número máximo de reembolsos para esta order foi excedido. | Nenhuma ação possível; o limite de reembolsos já foi atingido. |
425 | order_payment_not_yet_enabled_for_refund | A order ainda não está habilitada para reembolso. | Aguardar alguns instantes e repetir a requisição. |
428 | insufficient_money_for_refund | Saldo insuficiente na conta para processar o reembolso. | Verificar o saldo disponível na conta Mercado Pago antes de tentar novamente. |
500 | idempotency_validation_failed | Falha na validação de idempotência. | Repetir a requisição com o mesmo X-Idempotency-Key. |
500 | genérico | Erro interno do servidor. | Repetir a requisição. Se o problema persistir, contactar o suporte. |