API do Vendedor

• Gerenciar ofertas
  Crie rascunhos, atualize campos seguros, publique e arquive via /api/v1/offers.
• Cumprir vendas
  Liste e inspecione pedidos de vendedores, depois marque-os como entregues com URLs de evidência opcionais.
• Fique dentro do limite
  Cada chave tem um limite de 300 requisições por minuto. As respostas incluem cabeçalhos X-RateLimit-*.
• Reaja em tempo real
  Inscreva-se em eventos de pedidos e ofertas, ou reabasteça o inventário COMPLEXO com webhooks de reserva.

1. 1Abra Configurações → Desenvolvedor e ative o acesso (autoatendimento, sem espera de aprovação).
2. 2Crie uma chave de API e copie a chave secreta uma vez (rmt_sk_live_…). Armazene-a no seu gerenciador de segredos.
3. 3Chame GET /api/v1 com Authorization: Bearer para confirmar escopos, cotas e operações.

curl -s -H "Authorization: Bearer rmt_sk_live_…" \
  https://rmt.gg/api/v1 | jq .

{
  "name": "RMT Seller Open API",
  "version": "1",
  "basePath": "/api/v1",
  "scopes": ["offers:read", "offers:write", "orders:read", "orders:write", "webhooks:manage"],
  "webhookEvents": ["order.paid", "order.delivered", "…"],
  "operations": [ /* full catalog */ ]
}

• offers:read: Listar e obter suas ofertas.
• offers:write: Criar, atualizar, publicar e excluir ofertas.
• orders:read: Listar e obter pedidos de vendedores.
• orders:write: Marcar pedidos como entregues.
• webhooks:manage: Reservado para gerenciamento futuro de webhooks da API Aberta. Configure endpoints nas configurações de Desenvolvedor hoje.

• O formato JSON envia um envelope estruturado com id, tipo, criado e dados.
• O formato Discord envia embeds ricos com links de pedidos ou ofertas.
• A assinatura opcional usa X-RMT-Timestamp e X-RMT-Signature (mesmo esquema que reserva).
• O histórico de entregas aparece sob cada endpoint para que você possa tentar novamente em caso de falhas. Os endpoints pausam automaticamente após falhas repetidas.

{
  "id": "whd_…",
  "type": "order.paid",
  "created": "2026-07-23T12:00:00.000Z",
  "data": {
    "order": {
      "uid": "ord_…",
      "reference": "RMT-…",
      "status": "PAID",
      "url": "https://rmt.gg/orders/ord_…",
      "items": [ /* line items with offer names */ ]
    }
  }
}

{
  "X-RMT-Event": "order.paid",
  "X-RMT-Delivery": "whd_…",
  "X-RMT-Timestamp": "1710000000",
  "X-RMT-Signature": "v1=abc123…"
}

• O estoque local é sempre preferido; o webhook preenche apenas a falta.
• Configure um padrão de oferta, ou substitua por opção de preço, na etapa Itens do editor de ofertas.
• Apenas HTTPS. A assinatura HMAC opcional combina com webhooks de saída (X-RMT-Event: reserve.item).
• Testar no editor envia dryRun: true. Na página do pedido, use Tentar reservar novamente após corrigir seu endpoint.

{
  "id": "rsv_…",
  "type": "reserve.item",
  "order": { "uid": "ord_…", "reference": "RMT-…", "url": "https://rmt.gg/orders/ord_…" },
  "offer": { "url": "my-offer", "title": "Game key", "pageUrl": "https://rmt.gg/offers/my-offer" },
  "option": { "id": 1, "name": "Standard" },
  "fields": [{ "id": 10, "name": "License", "type": "text", "required": true }],
  "quantity": 1
}

{
  "entries": [
    { "name": "License", "value": "AAAA-BBBB-CCCC" }
  ]
}

{
  "license": "AAAA-BBBB-CCCC",
  "email": "[email protected]",
  "password": "temporary-pass"
}

• API_KEY_REQUIRED

  401

  Cabeçalho Authorization ou X-Api-Key ausente.

• API_KEY_INVALID

  401

  Chave desconhecida, revogada, expirada ou acesso de desenvolvedor desativado.

• SCOPE_MISSING

  403

  A chave não possui o escopo exigido pelo endpoint.

• RATE_LIMITED

  429

  Muitas requisições. Respeite Retry-After e X-RateLimit-Reset.

• RESERVE_FAILED

  400

  Webhook de reserva expirou, retornou dados inválidos ou faltaram campos obrigatórios.

Respostas bem-sucedidas incluem X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.