Capturar order totalmente - Orders - Mercado Pago Developers
Capturar order totalmente

Este endpoint permite capturar totalmente uma order previamente autorizada. Cada payment associado será capturado totalmente. Em caso de sucesso, a requisição retornará uma resposta com o status 200.

POST

https://api.mercadopago.com/v1/orders/{order_id}/capture
Request parameters
Path
order_id
string

OBRIGATÓRIO

ID da order cujos valores serão capturados. Esse valor é retornado na resposta à requisição Criar order.
Header
X-Idempotency-Key
string

OBRIGATÓRIO

Esta função permite repetir requisições de forma segura, sem o risco de realizar a mesma ação mais de uma vez por engano. Isso é útil para evitar erros, como a criação de dois pagamentos idênticos. Para garantir que cada...Ver mais
Response parameters
id
string
Identificador da order processada na requisição.
status
string
Status atual da order.
processed: Todas as transações foram processadas com sucesso.
processing: A order está em processamento e não requer nenhuma ação do integrador. Por exemplo, o pagamento pode estar pendente de revisão manual.
status_detail
string
Detalhes sobre o status do pagamento.
accredited: Pagamento creditado.
in_process: Se 'status=processing', o pagamento está sendo processado.
transactions
object
Contém informações sobre as transações associadas a uma order.
Erros

400Erro de requisição.

empty_required_header

O header "X-Idempotency-Key" é requerido e não foi enviado. Faça a requisição novamente incluindo-o.

invalid_path_param

O "order_id" fornecido no path da requisição não está correto. Verifique e forneça um ID válido para tentar novamente.

401Erro. Access Token não autorizado.

401

O Access Token enviado está incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.

invalid_credentials

Não há suporte para credenciais de teste. Utilize usuários de teste com credenciais de produção para o ambiente de teste (sandbox) e as suas credenciais de produção para o ambiente de produção.

402Erro de processamento.

402

A order foi criada mas alguma transação falhou. Verifique o campo "erros" para mais informações.

404Error. Order não encontrada.

order_not_found

Order não encontrada. Verifique se o ID enviado está correto.

409Alguma regra específica do sistema não permite a realização da ação devido a restrições definidas.

idempotency_key_already_used

O valor enviado como header de idempotência já foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.

cannot_capture_order

Erro. Order não pode ser capturada. O status da order não permite a sua captura. Apenas orders com "status" 'action_required' e "status_detail" 'waiting_capture' podem ser capturadas.

operation_not_supported

A operação não é suportada para esta order. Verifique o "status" e "status" da order e tente novamente.

500Erro genérico.

idempotency_validation_failed

Falha na validação. Tente enviar a solicitação novamente.

internal_error

Erro genérico. Tente enviar a solicitação novamente.

Request
curl -X POST \
    'https://api.mercadopago.com/v1/orders/{order_id}/capture'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
    
Response
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "processed",
  "status_detail": "accredited",
  "transactions": {
    "payments": [
      {
        "id": "PAY01J49MMW3SSBK5PSV3DFR32959",
        "amount": "24.90",
        "status": "processed",
        "status_detail": "accredited",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9"
      }
    ]
  }
}