Criação de depósito

Geral

Informações Principais Geração de Assinatura

Depósitos

Começando Criação de Depósito Criação de Depósito sem Redirecionamento (iframe) Notificação de Depósito (webhook) Verificação do Status do Depósito Obtenção da 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 SkinsBack UI

Create a deposit without SkinsBack UI (API) Obter o inventário do utilizador

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 Retiradas do Saldo e Depósitos Moedas e taxas Status do servidor Eventos em tempo real: websockets Eventos em tempo real: webhooks

Criação de depósito

Ao contrário dos sistemas de pagamento tradicionais, o SkinsBack não aceita um valor específico para recarga. O valor da recarga é enviado para a 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, também é necessário especificar o parâmetro 'currency'. 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.

Os parâmetros obrigatórios estão 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 em seu sistema

steam_id

string

ID do usuário do 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)

currency

string

Moeda (opcional)

result_url

string

URL de Resultado opcional, que será usada
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'

max_amount

double

Valor máximo de recarga. Deve ser maior que 'min_amount'.
Usado em conjunto com 'currency'

widget

bool

Se o valor for 1, o URL será enviado na resposta do servidor para exibir a interface de recarga dentro do seu site (iframe). Mais detalhes em recarga diretamente no site

game

string

Jogo a abrir por predefinição ao carregar o inventário no formulário de pagamento ('cs2', 'dota2', 'rust')

custom_multiplier

double

Multiplicador de preços personalizado (substitui o valor das definições do projeto). Valor mínimo: 0.5, máximo: 2

custom_currency

string

Moeda personalizada (obrigatória com custom_currency_rate). Pode passar o nome de uma moeda personalizada e especificar a sua taxa. Os preços das skins serão apresentados nesta moeda. Máximo de 4 caracteres.

custom_currency_rate

double

A taxa de uma moeda arbitrária (exigida 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:

invalid_order_id

O valor order_id foi passado incorretamente

invalid_steam_id

steam_id inválido. Exemplo de ID Steam: 76561198827262007

order_id_already_exists

O order_id especificado já foi utilizado para criar um depósito

invalid_max_value

O montante máximo de recarga deve ser superior a 'min_value' e à soma mínima do negócio do jogo

invalid_currency

Moeda inválida especificada

invalid_result_url

URL inválido especificado

invalid_success_url

URL de sucesso inválido

invalid_fail_url

URL de falha inválido

invalid_custom_currency

Moeda personalizada inválida especificada

invalid_custom_currency_rate

Taxa de moeda personalizada inválida especificada

invalid_custom_multiplier

Multiplicador personalizado inválido especificado. Valor mínimo: 0.5, máximo: 2

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 pedido 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-pt/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);