API para vendedores

• Gestionar ofertas
  Crea borradores, actualiza campos seguros, publica y archiva a través de /api/v1/offers.
• Cumplir ventas
  Lista e inspecciona los pedidos de los vendedores, luego márcalos como entregados con URLs de evidencia opcionales.
• Mantente dentro del límite
  Cada clave tiene un límite de 300 solicitudes por minuto. Las respuestas incluyen encabezados X-RateLimit-*.
• Reacciona en tiempo real
  Suscríbete a eventos de pedidos y ofertas, o reabastece el inventario COMPLEJO con webhooks de reserva.

1. 1Abre Configuración → Desarrollador y habilita el acceso (auto-servicio, sin espera de aprobación).
2. 2Crea una clave de API y copia la clave secreta una vez (rmt_sk_live_…). Almacénala en tu gestor de secretos.
3. 3Llama a GET /api/v1 con Authorization: Bearer para confirmar ámbitos, cuotas y operaciones.

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 y obtener tus ofertas.
• offers:write: Crear, actualizar, publicar y eliminar ofertas.
• orders:read: Listar y obtener pedidos de vendedores.
• orders:write: Marcar pedidos como entregados.
• webhooks:manage: Reservado para la futura gestión de webhooks de la API Abierta. Configura puntos finales en la configuración de Desarrollador hoy.

• El formato JSON publica un sobre estructurado con id, tipo, creado y datos.
• El formato Discord publica embeds ricos con enlaces de pedidos u ofertas.
• La firma opcional utiliza X-RMT-Timestamp y X-RMT-Signature (el mismo esquema que la reserva).
• El historial de entregas aparece bajo cada punto final para que puedas reintentar fallos. Los puntos finales se pausarán automáticamente después de fallos repetidos.

{
  "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…"
}

• El stock local siempre es preferido; el webhook solo llena el déficit.
• Configura un valor predeterminado a nivel de oferta, o anula por opción de precio, en el paso de Items del editor de ofertas.
• Solo HTTPS. La firma HMAC opcional coincide con los webhooks salientes (X-RMT-Event: reserve.item).
• Probar en el editor envía dryRun: true. En la página de pedidos, usa Reintentar reserva después de arreglar tu punto final.

{
  "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

  Falta el encabezado Authorization o X-Api-Key.

• API_KEY_INVALID

  401

  Clave desconocida, revocada, expirada o acceso de desarrollador deshabilitado.

• SCOPE_MISSING

  403

  La clave carece del ámbito requerido por el punto final.

• RATE_LIMITED

  429

  Demasiadas solicitudes. Respeta Retry-After y X-RateLimit-Reset.

• RESERVE_FAILED

  400

  El webhook de reserva se agotó, devolvió datos inválidos o faltaron campos requeridos.

Las respuestas exitosas incluyen X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.