A vigência é o período de validade definido para uma order. Ao configurá-la, você pode estabelecer uma data de início efetivo e uma data de vencimento que define o prazo máximo para realizar o pagamento.

Para configurar a vigência, inclua os parâmetros config.online.available_from e expiration_time ao enviar a requisição ao endpoint Criar orderAPI:

• Em config.online.available_from, informe a data e hora de início efetivo no formato ISO 8601 (yyyy-MM-dd'T'HH:mm:ssZ). Por exemplo: "2026-01-15T12:00:00.000-04:00".
• Em expiration_time, informe o tempo de vencimento a partir da criação da order no formato ISO 8601. Por exemplo: "P1D" equivale a 1 dia.

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",
  "expiration_time": "P1D",
  "payer": {
    "email": "buyer@email.com"
  },
  "items": [
    {
      "title": "Meu produto",
      "unit_price": "1000.00",
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": "1000.00"
    }
  ],
  "config": {
    "online": {
      "available_from": "2026-01-15T12:00:00.000-04:00"
    }
  }
}'