Ayuda Contactos
esES
ENEN DEDE ESES PLPL PT-BRPT-BR PT-PTPT-PT RURU TRTR VIVI ZH-CNZH-CN
Conectar sitio web
Ayuda Contactos

API

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

Creación de depósito

A diferencia de los sistemas de pago clásicos, SkinsBack no acepta una cantidad específica para la recarga. La cantidad de recarga se envía a la Result URL (webhook) después de que nos transfiera los elementos del juego.

La respuesta de este método contendrá la URL a la que se debe redirigir al usuario (esta es la página de pago).

Los parámetros 'min_amount' y/o 'max_amount' son obligatorios solo para la creación de depósitos Limitados. En ese caso, también es obligatorio especificar el parámetro 'currency'. Si 'min_amount' es menor que el monto mínimo de transacción del juego, se utilizará el monto mínimo de transacción del juego.

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

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

method
string
create
order_id
string
ID único del depósito en su sistema
steam_id
string
ID de usuario de Steam por defecto. El usuario puede cambiar de cuenta durante la recarga.
trade_token
string
'token' de la Trade URL del usuario (8 caracteres)
currency
string
Moneda (opcional)
result_url
string
URL de resultado opcional que se utilizará
en lugar de la URL especificada en la configuración del proyecto
fail_url
string
URL de fallo opcional
success_url
string
URL de éxito opcional
min_amount
double
Cantidad mínima de recarga.
Se utiliza junto con 'currency'
max_amount
double
Cantidad máxima de recarga. Debe ser mayor que 'min_amount'.
Se utiliza junto con 'currency'
widget
bool
Si el valor es 1, se enviará una URL en la respuesta del servidor que está destinada a mostrar la interfaz de recarga dentro de su sitio web (iframe). Más información en recarga directamente en el sitio web
game
string
Juego que se abre por defecto al cargar el inventario en el formulario de pago ('cs2', 'dota2', 'rust')
custom_multiplier
double
Multiplicador de precio personalizado (anula el valor de la configuración del proyecto). Valor mínimo: 0.5, máximo: 2
custom_currency
string
Moneda personalizada (requerida con custom_currency_rate). Puedes pasar el nombre de una moneda personalizada y especificar su tasa. Los precios de los aspectos se mostrarán en esta moneda. Máximo 4 caracteres.
custom_currency_rate
double
La tasa de una moneda arbitraria (requerida con custom_currency). Valor mínimo: 0,1

Respuesta del servidor:

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

url
string
URL a la que se debe redirigir al usuario
transaction_id
int
ID de transacción en nuestro sistema

Ejemplo de respuesta exitosa:

{
    "status": "success",
    "url": "https://skinsback.com/_/pay/9421749033d9d3f725c67572575975de/",
    "transaction_id": 13
}

Lista de posibles errores:

1
invalid_order_id
El valor de order_id ha sido introducido incorrectamente
2
invalid_steam_id
steam_id inválido. Ejemplo de ID de Steam: 76561198827262007
5
order_id_already_exists
El order_id especificado ya ha sido utilizado para crear un depósito
7
invalid_max_value
La cantidad máxima de recarga debe ser mayor que 'min_value' y la suma mínima de reparto del juego
8
invalid_currency
Moneda no válida especificada
9
invalid_result_url
URL no válida especificada
10
invalid_success_url
URL de éxito inválida
11
invalid_fail_url
URL de fallo no válida
12
invalid_custom_currency
Moneda personalizada no válida especificada
13
invalid_custom_currency_rate
Tipo de moneda personalizado no válido
14
invalid_custom_multiplier
Multiplicador personalizado no válido especificado
15
invalid_game
Juego no válido especificado
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

Ejemplo de respuesta con error:

{
    "status": "error",
    "error_code": 1,
    "error_message": "invalid_order_id"
}

Ejemplo de solicitud con encabezados de autorización en PHP:

<?php
$params = array(
	'method' => 'create',
	'order_id' => 1,
	'steam_id' => '76561198827262007',
	'trade_token' => 'i1ArBZey',
	'currency' => 'usd'
);
$clientId = '12312312323123';
$clientSecret = '123123123123213';

$headers = [
    'X-CLIENT-ID: ' . $clientId,
    'X-CLIENT-SECRET: ' . $clientSecret,
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://skinsback.com/api.php");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$server_output = curl_exec($ch);
curl_close ($ch);
var_dump($server_output);

Ejemplo de solicitud con firma en PHP:

<?php
$params = array(
	'shopid' => '1', // Client ID
    'method' => 'create',
	'order_id' => 1,
	'steam_id' => '76561198827262007',
	'trade_token' => 'i1ArBZey',
	'currency' => 'usd'
);
$clientSecret = '123123123123213';
// @see https://skinsback.com/es/docs/api/v1/signature/
$params['sign'] = buildSignature($params, $clientSecret);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://skinsback.com/api.php");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$server_output = curl_exec($ch);
curl_close ($ch);
var_dump($server_output);
© 2025 SkinsBack. All right reserved.
Ayuda Contactos Acuerdo de servicio