Uma order é o recurso central da API de Orders que unifica o ciclo de vida do pagamento. Ao criar uma order para o Checkout Pro, você define os detalhes da transação, incluindo produtos, preços e dados do comprador, e obtém um checkout_url para redirecionar o comprador ao formulário de pagamento do Mercado Pago.

A partir da sua criação, o id da order será o identificador único que você utilizará para consultar, cancelar ou reembolsar a transação ao longo de todo o fluxo.

Para criar uma order, envie um POST com seu Access Token de testeChave privada de teste da aplicação criada no Mercado Pago, que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Credenciais de teste. e os parâmetros necessários ao endpoint Criar orderAPI e execute a requisição. Crie uma order para cada fluxo de pagamento ou transação que quiser iniciar.

Inclua sempre o header X-Idempotency-Key com um UUID único por tentativa para evitar a criação de orders duplicadas.

curl
Copiar
curl -X POST \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
    -H 'X-Idempotency-Key: UNIQUE_KEY' \
    'https://api.mercadopago.com/v1/orders' \
    -d '{
  "type": "online",
  "processing_mode": "manual",
  "total_amount": "1000.00",
  "external_reference": "order_pro_123",
  "payer": {
    "email": "buyer@email.com"
  },
  "items": [
    {
      "title": "Meu produto",
      "unit_price": "1000.00",
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": "1000.00"
    }
  ]
}'

Ao executar a requisição, a resposta conterá o id da order e o campo checkout_url com a URL de redirecionamento para o formulário de pagamento do Mercado Pago. Redirecione o comprador para esse endereço para que ele conclua a transação. Guarde o id da order para utilizá-lo em operações futuras, como consultas de status, cancelamentos e reembolsos. Os valores de country_code e currency variam conforme o país da conta do vendedor.

json
Copiar
{
  "id": "ORDTST01KS5AJ6HTK2HRQ3XJ3C2JCKP9",
  "type": "online",
  "processing_mode": "manual",
  "status": "created",
  "status_detail": "created",
  "capture_mode": "automatic_async",
  "external_reference": "order_pro_123",
  "description": "Meu produto",
  "total_amount": "1000.00",
  "total_paid_amount": "0.00",
  "checkout_url": "https://www.mercadopago.com.ar/checkout/v1/redirect?order_id=ORDTST01KS5AJ6HTK2HRQ3XJ3C2JCKP9",
  "client_token": "eyJhbGciOiJSUzI1NiIs...",
  "expiration_time": "P1D",
  "country_code": "ARG",
  "user_id": "1858095454",
  "currency": "ARS",
  "created_date": "2026-05-21T13:10:56.845Z",
  "last_updated_date": "2026-05-21T13:10:56.845Z",
  "integration_data": {
    "application_id": "8772548647196351"
  },
  "config": {
    "online": {
      "retries": {
        "allowed": false
      }
    },
    "payment_method": {}
  },
  "items": [
    {
      "title": "Meu produto",
      "unit_price": "1000.00",
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": "1000.00"
    }
  ]
}

Veja na tabela abaixo a descrição dos principais campos retornados na resposta.

Veja na tabela abaixo a descrição dos principais campos retornados na resposta.

Com o checkout_url disponível, o próximo passo é configurar o frontend para redirecionar o comprador.

Após criar a order, você pode consultar seu status ou buscá-la a qualquer momento utilizando o id retornado na resposta. Para isso, utilize os seguintes endpoints:

• Obter order por IDAPI
• Buscar ordersAPI

Escolha o tipo de integração que melhor atenda às suas necessidades, seja para um site ou um aplicativo móvel, e siga os passos detalhados para completar a integração do Checkout Pro.