Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Capturar order totalmente - Pagamentos online - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Capturar order totalmente

POST

https://api.mercadopago.com/v1/orders/{order_id}/capture
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.
Parâmetros de requisição
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
Parâmetros de resposta
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.

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.

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

A order não pode ser capturada. Verifique o status da order e tente novamente.

Erro. Operação não suportada.

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.

Requisição
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 TEST-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
    
Resposta de exemplo
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "processed",
  "status_detail": "accredited",
  "transactions": {
    "payments": [
      {
        "id": "PAY01J49MMW3SSBK5PSV3DFR32959",
        "amount": "24.90",
        "status": "processed",
        "status_detail": "accredited",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9"
      }
    ]
  }
}