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
Notificação de depósito (webhook)
Ao contrário dos sistemas de pagamento tradicionais, SkinsBack não aceita um valor específico para o reabastecimento. O valor do reabastecimento é enviado para o Result URL (webhook) após a entrega dos itens do jogo para nós.
Parâmetros enviados pelo método POST para o Result URL:
sign
string
Assinatura para verificar. Use o método de verificação de assinatura para verificar a assinatura da solicitação.
OU você pode verificar o cabeçalho X-SIGN enviado ao seu servidor usando o algoritmo:
md5(clientId + clientSecret) (concatenação).
OU você pode verificar o cabeçalho X-SIGN enviado ao seu servidor usando o algoritmo:
md5(clientId + clientSecret) (concatenação).
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)
user_risk.total_deposits_count
int
Número total de depósitos do usuário em todos os projetos durante todo o período.
(somente quando status = in_hold)
(somente quando status = in_hold)
user_risk.total_deposits_sum
float
Soma total de depósitos do usuário em todos os projetos durante todo o período.
(somente quando status = in_hold)
(somente quando status = in_hold)
user_risk.total_rollback_deposits_count
int
Número de depósitos com reversão onde o usuário recebeu pagamentos antecipados de projetos.
(somente quando status = in_hold)
(somente quando status = in_hold)
user_risk.total_rollback_deposits_sum
float
Soma de depósitos com reversão onde o usuário recebeu pagamentos antecipados de projetos.
(somente quando status = in_hold)
(somente quando status = in_hold)
user_risk.joined_at
datetime
Data de registro do usuário
(somente quando status = in_hold)
(somente quando status = in_hold)
user_risk.last_deposit_at
datetime
Data do último depósito
(somente quando status = in_hold)
(somente quando status = in_hold)
user_risk.user_inventory
array
Valor do inventário do usuário
(somente quando status = in_hold)
(somente quando status = in_hold)
user_risk.user_inventory[].last_updated_at
datetime
Data da última atualização do inventário para jogo específico
(somente quando status = in_hold)
(somente quando status = in_hold)
user_risk.user_inventory[].sum
float
Soma do inventário do usuário em USD
(somente quando status = in_hold)
(somente quando status = in_hold)