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 — produtos, preços, dados do comprador e configurações de notificação — e obtém um init_point para redirecionar o comprador ao formulário de pagamento do Mercado Pago.

A Order substitui a preferência como ponto de entrada no checkout. 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 TokenChave privada da aplicação criada no Mercado Pago, que é utilizada no backend. Você pode acessá-la através de Suas integrações > Detalhes da aplicação > Credenciais de produção. e os parâmetros necessários ao endpoint Criar orderAPI e execute a requisição.

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",
  "total_amount": "1000.00",
  "external_reference": "order_pro_123",
  "payer": {
    "email": "buyer@email.com"
  },
  "transactions": {
    "payments": [
      {
        "amount": "1000.00"
      }
    ]
  },
  "notification_url": "https://www.your-site.com/webhooks"
}'

Ao executar a requisição, a resposta conterá o id da Order e o objeto checkout_pro com a URL do init_point. Essa URL é o endereço para o qual você deve redirecionar o comprador para que ele acesse o formulário de pagamento do Mercado Pago e conclua a transação.

Guarde o id da Order para utilizá-lo em operações futuras, como consultas de status, cancelamentos e reembolsos.

json
Copiar
{
  "id": "ORD01HRYFWNYRE1MR1E60MW3X0T2P",
  "type": "online",
  "status": "created",
  "status_detail": "created",
  "external_reference": "order_pro_123",
  "total_amount": "1000.00",
  "checkout_pro": {
    "init_point": "https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=787997534-6dad21a1-6145-4f0d-ac21-66bf7a5e7a58"
  },
  "transactions": {
    "payments": [
      {
        "id": "pay_01JC1KVZ0WJY8Y4WA7MZG3A8F2",
        "amount": "1000.00",
        "status": "created"
      }
    ]
  }
}

Após obter o init_point, você deve prosseguir para a configuração do frontend. Para isso, escolha o tipo de integração que melhor atenda às suas necessidades, seja para um site ou um aplicativo móvel.

Selecione o tipo de integração que deseja realizar e siga os passos detalhados para completar a integração do Checkout Pro.