Status da order
Os status de uma order representam as diferentes etapas do ciclo de vida de um pagamento realizado por meio do Checkout Pro e gerenciado pela API de OrdersAPI que gerencia o ciclo de vida completo de uma order de pagamento no Checkout Pro.. Cada status indica o estágio atual da transação, desde a criação da order até sua conclusão ou resolução final.
Para consultar o status de uma order a qualquer momento, envie um GET com seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Detalhes da aplicação > Testes > Credenciais de teste. ao endpoint Obter orderAPI.
Status e detalhes de status da order
A tabela a seguir descreve todos os status possíveis de uma order e seus respectivos detalhes.
| Status | Status detail | Descrição |
created | created | Order criada com sucesso. Aguardando a interação do comprador ou o início do processamento do pagamento. |
processed | accredited | Pagamento aprovado e creditado ao vendedor. |
processed | refunded | Pagamento totalmente reembolsado ao comprador. A order permanece com status processed com este detalhe. |
processed | partially_refunded | Pagamento parcialmente reembolsado. O saldo restante foi creditado ao vendedor. |
action_required | waiting_capture | Pagamento autorizado, mas ainda não capturado. |
failed | bad_filled_card_data | O processamento do pagamento falhou devido a informações incorretas do cartão informadas pelo comprador. |
failed | invalid_card_token | O processamento do pagamento falhou porque o token do cartão informado é inválido ou expirou. |
failed | high_risk | Transação rejeitada pelo sistema de prevenção de fraudes por alto risco. |
failed | rejected_by_issuer | Transação rejeitada pelo emissor do cartão. O comprador pode precisar contatar seu banco. |
failed | required_call_for_authorize | Transação rejeitada pelo emissor e requer autorização. O comprador deve ligar para seu banco. |
failed | max_attempts_exceeded | Transação rejeitada porque o número máximo de tentativas de processamento foi excedido. |
failed | card_disabled | O cartão selecionado para a transação está desabilitado. |
failed | card_insufficient_amount | O cartão selecionado não possui saldo suficiente para cobrir o valor da transação. |
failed | amount_limit_exceeded | O valor da transação excede o limite permitido pelo cartão. |
failed | invalid_installments | Ocorreu um erro durante o processamento relacionado à configuração de parcelas. |
failed | processing_error | O processamento do pagamento falhou devido a um erro interno inesperado. Recomenda-se realizar uma nova tentativa da operação. |
processing | pending_review_manual | Pagamento pendente de análise manual pela equipe de risco do Mercado Pago. Nenhuma ação é necessária neste momento. |
processing | in_process | O pagamento está em processamento. Nenhuma ação necessária. |
refunded | refunded | A order foi totalmente reembolsada e o status principal da transação é refunded. |
canceled | canceled | A order foi cancelada ou expirou sem que o pagamento fosse concluído. |
Ciclo de vida da order
O ciclo de vida típico de uma order segue a sequência: created → processing → processed. Nesse fluxo, a order é criada, o pagamento é processado e creditado ao vendedor.
Existem caminhos alternativos conforme a resolução da transação:
- Cancelamento:
created→canceled— A order é cancelada antes de ser processada. - Reembolso total:
processed→refunded— O valor total da order é devolvido ao comprador. O status principal muda pararefunded. - Reembolso parcial:
processed(compartially_refunded) — Apenas uma parte do valor é devolvida, e a order permanece com statusprocessed. - Falha:
created→failed— O pagamento é recusado por dados incorretos, alto risco ou outro erro de processamento. - Captura manual:
created→action_required(comwaiting_capture) — O pagamento é autorizado, mas ainda não capturado.
Para consultar o status de uma order a qualquer momento, envie uma requisição GET ao endpoint Obter orderAPI com seu Access Token e aguarde a notificação via webhook (tópico orders_v2) antes de tomar ações irreversíveis, como despachar um envio ou liberar um acesso.
Para mais informações sobre como gerenciar as notificações de status de pagamento, consulte a documentação de notificações.