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
Verificación del estado del depósito
Este método se utiliza para obtener información sobre el depósito creado.
Los parámetros obligatorios están resaltados en azul .
Envía una solicitud POST a API Endpoint con los siguientes parámetros:
method
string
orderstatus
transaction_id
string
ID de transacción en nuestro sistema
— O —
order_id
string
ID único del depósito en tu sistema
Respuesta del servidor:
En caso de éxito, la respuesta del servidor será un objeto JSON con el siguiente contenido:
status
string
success - pago exitoso, pending - en espera, fail - fallido, in_hold - depósito en espera
Un depósito con estado in_hold puede cambiar a success o fail.
Solo para depósitos sin espera de 8 días: hold_approved - depósito en espera fue aprobado, hold_returned - depósito aprobado en espera cancelado. Más detalles...
Un depósito con estado in_hold puede cambiar a success o fail.
Solo para depósitos sin espera de 8 días: hold_approved - depósito en espera fue aprobado, hold_returned - depósito aprobado en espera cancelado. Más detalles...
transaction_id
string
ID de transacción en nuestro sistema
order_id
string
ID único del depósito en tu sistema
steam_id
string
Steam ID del usuario
date
int
Tiempo UNIX de creación del depósito
amount
double
Cantidad que el usuario depositó en la moneda 'currency'
(solo cuando status = success, in_hold o hold_approved)
(solo cuando status = success, in_hold o hold_approved)
amount_currency
string
Moneda del pago
(solo cuando status = success, in_hold o hold_approved)
(solo cuando status = success, in_hold o hold_approved)
amount_in_currencies
object
Cantidad de recarga en todas las monedas disponibles
(solo cuando status = success, in_hold o hold_approved)
(solo cuando status = success, in_hold o hold_approved)
user_amount
double
Cantidad multiplicada por el ajuste del proyecto que el usuario depositó en la moneda currency
(solo cuando status = success, in_hold o hold_approved)
(solo cuando status = success, in_hold o hold_approved)
user_amount_in_currencies
object
Cantidad multiplicada por el ajuste del proyecto que el usuario depositó en todas las monedas disponibles
(solo cuando status = success, in_hold o hold_approved)
(solo cuando status = success, in_hold o hold_approved)
offer_date
int
Tiempo UNIX de creación de la oferta de intercambio de skins
para el usuario (puede estar ausente)
para el usuario (puede estar ausente)
in_hold_until
int
Tiempo UNIX hasta el cual el depósito está en espera (puede estar ausente)
trade_offer_id
string
Trade Offer ID en Steam (puede estar ausente)
skins_send_date
int
Tiempo UNIX de aceptación de la oferta de intercambio de skins (puede estar ausente)
(solo cuando status = success, in_hold o hold_approved)
(solo cuando status = success, in_hold o hold_approved)
custom_currency
string
Nombre de moneda personalizada (si se especifica)
(solo cuando status = success, in_hold o hold_approved)
(solo cuando status = success, in_hold o hold_approved)
custom_currency_rate
double
Tipo de moneda personalizado (si se especifica)
(solo cuando status = success, in_hold o hold_approved)
(solo cuando status = success, in_hold o hold_approved)
custom_currency_sum
double
La cantidad que el usuario depositó en la moneda 'custom_currency'
(solo cuando status = success, in_hold o hold_approved)
(solo cuando status = success, in_hold o hold_approved)
reason
string
Motivo del estado de falla:
1. 'timeout' - el tiempo para seleccionar máscaras ha expirado
2. 'trade_timeout' - el tiempo para aceptar el intercambio en Steam ha expirado
3. 'trade_canceled' - el intercambio ha sido cancelado en Steam
(solo si el estado es fail)
1. 'timeout' - el tiempo para seleccionar máscaras ha expirado
2. 'trade_timeout' - el tiempo para aceptar el intercambio en Steam ha expirado
3. 'trade_canceled' - el intercambio ha sido cancelado en Steam
(solo si el estado es fail)
Lista de posibles errores:
1
order_id_or_transaction_id_missing
order_id y transaction_id están ausentes
2
invalid_order_id
Falta order_id
3
invalid_transaction_id
Falta o es incorrecto transaction_id
4
transaction_not_found
Depósito no encontrado
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