Compra de skin y envío al usuario

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

Compra de skin y envío al usuario

Compra de skin y envío de skin al usuario.

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_buy

partner

string

Valor 'partner' de la Trade URL del usuario

token

string

Valor 'token' de la Trade URL del usuario

name + game

string + string

Nombre del skin (market hash name) + juego ('cs2', 'dota2', 'rust')

— O —

int

ID del skin en la lista de precios o búsqueda

max_price

float

Costo máximo del skin para comprar (en USD). Se utiliza como límite de costo

custom_id

string

ID único en su sistema. Se utiliza para evitar compras duplicadas.

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 la compra, se requiere para verificar el estado de la transferencia del artículo

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)

Este método solo puede contener create_trade. Otros estados se encuentran en los métodos market_getinfo / market_history.

balance_debited_sum

float

Monto debitado del saldo del proyecto (USD)

Ejemplo de respuesta exitosa:

{
    "status": "success",
    "item": {
        "id": "2729",
        "name": "Glock-18 | Bullet Queen (Battle-Scarred)",
        "price": "1591.91",
        "classid": "3770702114",
    },
    "buy_id": 5,
    "offer_status": "creating_trade",
    "balance_debited_sum": 3000
}

Lista de posibles errores:

missing_name_and_id

Falta el nombre del skin y el ID

name_min_length_3

Longitud mínima del nombre del skin: 3 caracteres

missing_partner_or_token

Falta el parámetro 'token' o 'partner'

insufficient_funds

Fondos insuficientes en el saldo del proyecto

skin_unavailable

La skin no está disponible para comprar

skins_not_found_at_specified_price

No se encontraron skins con un precio <= 'max_price'

custom_id_already_exists

'custom_id' ya existe en nuestro sistema

invalid_partner_value

Valor incorrecto para 'partner'

invalid_token_value

Valor incorrecto para 'token'. Solicite una nueva Trade URL al usuario

too_many_failed_attempts_for_user

Demasiados intentos fallidos al enviar skins al usuario (Trade URL incorrecta, usuario no acepta skins a tiempo, usuario no tiene capacidad para intercambiar skins). Intente nuevamente más tarde

custom_id_already_processing

Otra solicitud con el mismo 'custom_id' se está procesando actualmente. Por favor espere e intente nuevamente

-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