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
Verificação do status do depósito
Este método é usado para obter informações sobre o depósito criado.
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
orderstatus
transaction_id
string
ID da transação em nosso sistema
— OU —
order_id
string
ID único do depósito no 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 - à espera, fail - falhado, in_hold - depósito em espera
Um depósito com estado 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 estado 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 no seu sistema
steam_id
string
Steam ID do usuário
date
int
Tempo UNIX de criação do depósito
amount
double
Valor depositado pelo usuário na moeda 'currency'
(apenas quando status = success, in_hold ou hold_approved)
(apenas quando status = success, in_hold ou hold_approved)
amount_currency
string
Moeda do pagamento
(apenas quando status = success, in_hold ou hold_approved)
(apenas quando status = success, in_hold ou hold_approved)
amount_in_currencies
object
Valor do depósito em todas as moedas disponíveis
(apenas quando status = success, in_hold ou hold_approved)
(apenas quando status = success, in_hold ou hold_approved)
user_amount
double
Valor depositado pelo usuário com multiplicador das configurações do projeto, na moeda currency
(apenas quando status = success, in_hold ou hold_approved)
(apenas quando status = success, in_hold ou hold_approved)
user_amount_in_currencies
object
Valor depositado pelo usuário com multiplicador das configurações do projeto, em todas as moedas disponíveis
(apenas quando status = success, in_hold ou hold_approved)
(apenas quando status = success, in_hold ou hold_approved)
offer_date
int
Tempo UNIX de criação da oferta de troca de skins
para o usuário (pode estar ausente)
para o usuário (pode estar ausente)
in_hold_until
int
Tempo UNIX até o depósito ser mantido (pode estar ausente)
trade_offer_id
string
ID da oferta de troca no Steam (pode estar ausente)
skins_send_date
int
Tempo UNIX da aceitação das skins (pode estar ausente)
(apenas quando status = success, in_hold ou hold_approved)
(apenas quando status = success, in_hold ou hold_approved)
custom_currency
string
Nome da moeda personalizada (se especificado)
(apenas quando status = success, in_hold ou hold_approved)
(apenas quando status = success, in_hold ou hold_approved)
custom_currency_rate
double
Taxa de moeda personalizada (se especificada)
(apenas quando status = success, in_hold ou hold_approved)
(apenas quando status = success, in_hold ou hold_approved)
custom_currency_sum
double
O valor que o utilizador depositou na moeda 'custom_currency'
(apenas quando status = success, in_hold ou hold_approved)
(apenas quando status = success, in_hold ou hold_approved)
reason
string
Motivo do estado de falha:
1. 'timeout' - o tempo para seleccionar 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 o status for fail)
1. 'timeout' - o tempo para seleccionar 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 o status for 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