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
Verificação do status do depósito
Este método é usado para obter informações sobre o depósito criado.
Parâmetros obrigatórios destacados em azul
Envie uma solicitação POST para o Endpoint da API com os seguintes parâmetros:
method
string
orderstatus
transaction_id
string
ID da transação em nosso sistema
— OU —
order_id
string
ID único do depósito em seu sistema
Resposta do servidor:
Em caso de sucesso, a resposta do servidor será um objeto JSON com o seguinte conteúdo:
status
string
success - pagamento bem-sucedido, pending - aguardando, fail - falhou, in_hold - depósito em espera
Um depósito com status in_hold pode mudar para success ou fail.
Apenas para depósitos sem espera de 8 dias: hold_approved - depósito em espera foi aprovado, hold_returned - depósito aprovado em espera cancelado. Mais detalhes...
Um depósito com status in_hold pode mudar para success ou fail.
Apenas para depósitos sem espera de 8 dias: hold_approved - depósito em espera foi aprovado, hold_returned - depósito aprovado em espera cancelado. Mais detalhes...
transaction_id
string
ID da transação em nosso sistema
order_id
string
ID único do depósito em seu sistema
steam_id
string
ID do usuário Steam
date
int
Tempo UNIX de criação do depósito
amount
double
Valor depositado pelo usuário na moeda 'currency'
(somente quando status = success, in_hold ou hold_approved)
(somente quando status = success, in_hold ou hold_approved)
amount_currency
string
Moeda do pagamento
(somente quando status = success, in_hold ou hold_approved)
(somente quando status = success, in_hold ou hold_approved)
amount_in_currencies
object
Valor do depósito em todas as moedas disponíveis
(somente quando status = success, in_hold ou hold_approved)
(somente quando status = success, in_hold ou hold_approved)
user_amount
double
Valor depositado pelo usuário multiplicado pelo multiplicador das configurações do projeto na moeda currency
(somente quando status = success, in_hold ou hold_approved)
(somente quando status = success, in_hold ou hold_approved)
user_amount_in_currencies
object
Valor depositado pelo usuário multiplicado pelo multiplicador das configurações do projeto em todas as moedas disponíveis
(somente quando status = success, in_hold ou hold_approved)
(somente quando status = success, in_hold ou hold_approved)
offer_date
int
Tempo UNIX de criação da oferta de troca
para o usuário (pode estar ausente)
para o usuário (pode estar ausente)
in_hold_until
int
Tempo UNIX até o qual o depósito está em espera (pode ser nulo)
trade_offer_id
string
ID da oferta de troca no Steam (pode estar ausente)
skins_send_date
int
Tempo UNIX de aceitação das skins (pode ser nulo)
(somente quando status = success, in_hold ou hold_approved)
(somente quando status = success, in_hold ou hold_approved)
custom_currency
string
Nome da moeda personalizada (se especificado)
(somente quando status = success, in_hold ou hold_approved)
(somente quando status = success, in_hold ou hold_approved)
custom_currency_rate
double
Taxa de moeda personalizada (se especificada)
(somente quando status = success, in_hold ou hold_approved)
(somente quando status = success, in_hold ou hold_approved)
custom_currency_sum
double
O valor que o usuário depositou na moeda 'custom_currency'
(somente quando status = success, in_hold ou hold_approved)
(somente quando status = success, in_hold ou hold_approved)
reason
string
Motivo do status de falha:
1. 'timeout' - o tempo para selecionar skins expirou
2. 'trade_timeout' - o tempo para aceitar trocas no Steam expirou
3. 'trade_canceled' - a negociação foi cancelada no Steam
(apenas se status = fail)
1. 'timeout' - o tempo para selecionar skins expirou
2. 'trade_timeout' - o tempo para aceitar trocas no Steam expirou
3. 'trade_canceled' - a negociação foi cancelada no Steam
(apenas se status = fail)
Lista de possíveis erros:
1
order_id_or_transaction_id_missing
order_id e transaction_id estão ausentes
2
invalid_order_id
order_id inválido
3
invalid_transaction_id
transaction_id ausente ou inválido
4
transaction_not_found
Depósito não encontrado
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