Estado de compra de la skin

Principal

Información principal Generación de firma

Depósitos

Empezando Creación de depósito Creación de depósito sin redireccionamiento (iframe) Notificación de depósito (webhook) Verificación del estado del depósito Obtener lista de depósitos Depósitos sin período de espera de 8 días (Steam Trade Protection) Aprobación de depósito con retención de 8 días Recibir notificaciones de webhooks fallidos

Depósitos sin SkinsBack UI

Create a deposit without SkinsBack UI (API) Crear un depósito sin SkinsBack UI (API)

Retiro de skins

Lista de precios (disponibilidad de skins) Buscar skins Comprar skin Compra de skins al por mayor Estado de compra de skin Historial de compras de skins

Otro

Saldo del proyecto Historial de retiros del saldo y depósitos Monedas y tasas Estado del servidor Eventos en tiempo real: websockets Eventos en tiempo real: webhooks

Estado de compra de la skin

Información sobre la skin adquirida. Este método permite conocer el ID de la oferta de intercambio de Steam, así como verificar si el objeto ha sido aceptado por el usuario (o si ha sido rechazado).

Los parámetros obligatorios están resaltados en azul .

Envía una solicitud POST a API Endpoint con los siguientes parámetros:

method

string

market_getinfo

buy_id

int

'buy_id' de la compra (del método market_buy)

— O —

custom_ids

array

array de 'custom_id' de su sistema. Si se especifica este parámetro, la respuesta contendrá una matriz de elementos que contienen información sobre cada compra

— O —

buy_ids

array

array de 'buy_id' de compras. Si se especifica este parámetro, la respuesta contendrá una matriz de elementos que contienen información sobre cada compra

Respuesta del servidor:

En caso de éxito, la respuesta del servidor será un objeto JSON con el siguiente contenido:

item

object

Objeto que contiene información sobre la piel comprada

— item.id

int

ID de la piel

— item.name

string

Nombre de la piel

— item.price

float

Precio de la piel en USD

— item.classid

string

ID de clase de la piel

buy_id

int

ID de compra de la piel

offer_status

string

Estado de compra:
1. 'creating_trade' — el intercambio se está creando
2. 'waiting_accept' — el intercambio está esperando a ser aceptado
3. 'accepted' — el intercambio ha sido aceptado
4. 'canceled' — el intercambio ha sido cancelado por el usuario
5. 'timeout' — el intercambio no fue aceptado en 10 minutos
6. 'invalid_trade_token' — token de intercambio inválido
7. 'user_not_tradable' — el usuario tiene restricciones en el sistema de intercambio
8. 'trade_create_error' — error al crear el intercambio (intente nuevamente)
9. 'rollback_user' — el skin ha sido devuelto por el usuario (Protección de Intercambio de Steam)
10. 'rollback_supplier' — el skin ha sido devuelto por el proveedor (Protección de Intercambio de Steam)

in_hold

bool

Si la compra está en espera (solo para compras con retención de 8 días)

in_hold_until

string (datetime)

Tiempo UNIX hasta el cual la compra está en espera (solo para compras con retención de 8 días)

error_reason

string

Razón (si está presente):
1. 'user_cant_trade' - el usuario tiene una restricción para comerciar en Steam
2. 'private_inventory' - el usuario debe abrir el inventario
3. 'user_trade_ban' - el usuario tiene prohibición comercial
4. 'user_inventory_is_full' - el inventario del usuario está lleno
5. 'too_many_failed_attempts' - Demasiados intentos fallidos de retirada para el usuario
6. 'skin_unavailable' - skin no disponible para compra (o venta)

steamid

string

Steam ID de usuario

date

int

Fecha de compra (tiempo UNIX)

balance_debited_sum

float

Monto debitado del saldo del proyecto (USD)

tradeofferid

string

Trade Offer ID en Steam (solo si se creó una oferta de intercambio)

custom_id

string

'custom_id' en su sistema

Ejemplo de respuesta exitosa:

{
    "status": "success",
    "item": {
        "id": "1280",
        "name": "Taunt: RazorFlip!",
        "price": "0.16",
        "classid": "1723112726"
    },
    "buy_id": "9",
    "offer_status": "trade_create_error",
    "error_reason": null,
    "steamid": "76561198050648523",
    "date": "1596999226",
    "balance_debited_sum": "11.73"
}

Lista de posibles errores:

missing_one_of_required_params

Falta el parámetro requerido (buy_id, buy_ids o custom_ids)

offer_not_found

Compra de la skin no encontrada

-6

market_disabled

Mercado desactivado

errores estándar:

-1

please_use_post_method

Es necesario utilizar el método POST

-2

invalid_shopid

ID del proyecto no encontrado en el sistema

-3

invalid_signature

Firma incorrecta

-4

shop_not_active

El proyecto no está activo

-5

invalid_method

Método API inválido

-7

request_limit_reached

Se ha alcanzado el límite de solicitudes (500 por minuto)

-8

invalid_ip_address

Por favor, especifique la dirección IP en la configuración del proyecto

-9

under_maintenance

El sitio web está en mantenimiento

-10

invalid_client_secret

Encabezado X-CLIENT-SECRET no válido