Principal
Informações Principais
Gerando uma Assinatura
Depósitos
Começando
Criando um Depósito
Criando um Depósito sem Redirecionamento (iframe)
Notificação de Depósito (webhook)
Verificando o Status do Depósito
Obtendo a Lista de Depósitos
Depósitos sem período de espera de 8 dias (Steam Trade Protection)
Aprovação de depósito com retenção de 8 dias
Receba notificações de webhook com falha
Depósitos sem a interface do usuário do SkinsBack
Create a deposit without SkinsBack UI (API)
Obter o inventário do usuário
Retirada de skins
Lista de preços (disponibilidade de skins)
Pesquisar skins
Comprar skin
Comprar skins em grandes quantidades
Status da compra de skin
Histórico de compras de skins
Outro
Saldo do Projeto
Histórico de Saques e Depósitos
Moedas e taxas
Status do servidor
Eventos em tempo real: websockets
Eventos em tempo real: webhooks
Criação do depósito
Ao contrário dos sistemas de pagamento clássicos, o SkinsBack não aceita um valor específico para recarga. O valor da recarga é enviado para o Result URL (webhook) após a entrega dos itens do jogo para nós.
A resposta deste método conterá a URL para a qual o usuário deve ser redirecionado (esta é a página de pagamento).
Os parâmetros 'min_amount' e/ou 'max_amount' são obrigatórios apenas para a criação de depósitos Limitados. Nesse caso, o parâmetro 'currency' também deve ser especificado. Se 'min_amount' for menor que o valor mínimo da transação do jogo, o valor mínimo da transação do jogo será usado.
Parâmetros obrigatórios destacados em azul
Envie uma solicitação POST para o Endpoint da API com os seguintes parâmetros:
method
string
create
order_id
string
ID único do depósito no seu sistema
steam_id
string
ID do usuário Steam padrão. O usuário pode trocar de conta durante a recarga.
trade_token
string
'token' da Trade URL do usuário (8 caracteres)
result_url
string
URL de Resultado opcional, que será usada
em vez daquela especificada nas configurações do projeto
em vez daquela especificada nas configurações do projeto
fail_url
string
Fail URL opcional
success_url
string
URL de sucesso opcional
min_amount
double
Valor mínimo de recarga.
Usado em conjunto com 'currency'
Usado em conjunto com 'currency'
max_amount
double
Valor máximo de recarga. Deve ser maior que 'min_amount'.
Usado em conjunto com 'currency'
Usado em conjunto com 'currency'
widget
bool
Se o valor for 1, o URL será enviado na resposta do servidor, destinado a exibir a interface de recarga dentro do seu site (iframe). Mais informações em recarga diretamente no site
game
string
Jogo a ser aberto por padrão ao carregar o inventário no formulário de pagamento ('cs2', 'dota2', 'rust')
custom_multiplier
double
Multiplicador de preço personalizado (substitui o valor das configurações do projeto). Valor mínimo: 0.5, máximo: 2
custom_currency
string
Moeda personalizada (necessária com custom_currency_rate). Você pode passar o nome de uma moeda personalizada e especificar sua taxa. Os preços das skins serão exibidos nesta moeda. Máximo de 4 caracteres.
custom_currency_rate
double
A taxa de uma moeda arbitrária (necessária com custom_currency). Valor mínimo: 0,1
Resposta do servidor:
Em caso de sucesso, a resposta do servidor será um objeto JSON com o seguinte conteúdo:
url
string
URL para redirecionar o usuário
transaction_id
int
ID da transação em nosso sistema
Exemplo de resposta bem-sucedida:
{
"status": "success",
"url": "https://skinsback.com/_/pay/9421749033d9d3f725c67572575975de/",
"transaction_id": 13
}
Lista de possíveis erros:
1
invalid_order_id
O valor order_id foi passado incorretamente
2
invalid_steam_id
steam_id inválido. Exemplo de ID Steam: 76561198827262007
5
order_id_already_exists
O order_id especificado já foi usado para criar um depósito
7
invalid_max_value
O valor máximo de recarga deve ser maior que 'min_value' e a soma mínima da transação do jogo
8
invalid_currency
Moeda inválida especificada
9
invalid_result_url
URL inválido especificado
10
invalid_success_url
URL de sucesso inválido
11
invalid_fail_url
URL de falha inválido
12
invalid_custom_currency
Moeda personalizada inválida especificada
13
invalid_custom_currency_rate
Taxa de moeda personalizada inválida especificada
14
invalid_custom_multiplier
Multiplicador personalizado inválido especificado. Valor mínimo: 0.5, máximo: 2
15
invalid_game
Jogo inválido especificado
erros padrão:
-1
please_use_post_method
É necessário usar o método POST
-2
invalid_shopid
ID do projeto não encontrado no sistema
-3
invalid_signature
Assinatura inválida
-4
shop_not_active
Projeto inativo
-5
invalid_method
Método de API inválido
-7
request_limit_reached
Limite de solicitações excedido (500 por minuto)
-8
invalid_ip_address
Especifique o endereço IP nas configurações do projeto
-9
under_maintenance
Site em manutenção
-10
invalid_client_secret
Cabeçalho X-CLIENT-SECRET inválido
Exemplo de resposta com erro:
{
"status": "error",
"error_code": 1,
"error_message": "invalid_order_id"
}
Exemplo de solicitação com cabeçalhos de autorização em 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);
Exemplo de solicitação com assinatura em 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/pt-br/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);