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
Notificação de depósito (webhook)
Ao contrário dos sistemas de pagamento clássicos, SkinsBack não aceita um valor específico para recarga. O valor do recarga é 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 a verificar. Utilize o método de verificação de assinaturas para verificar a assinatura do pedido.
OU pode verificar o cabeçalho X-SIGN enviado para o seu servidor utilizando o algoritmo:
md5(clientId + clientSecret) (concatenação).
OU pode verificar o cabeçalho X-SIGN enviado para o seu servidor utilizando o algoritmo:
md5(clientId + clientSecret) (concatenação).
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)
user_risk.total_deposits_count
int
Número total de depósitos do utilizador em todos os projetos durante todo o período.
(apenas quando status = in_hold)
(apenas quando status = in_hold)
user_risk.total_deposits_sum
float
Soma total de depósitos do utilizador em todos os projetos durante todo o período.
(apenas quando status = in_hold)
(apenas quando status = in_hold)
user_risk.total_rollback_deposits_count
int
Número de depósitos com reversão onde o utilizador recebeu pagamentos antecipados de projetos.
(apenas quando status = in_hold)
(apenas quando status = in_hold)
user_risk.total_rollback_deposits_sum
float
Soma de depósitos com reversão onde o utilizador recebeu pagamentos antecipados de projetos.
(apenas quando status = in_hold)
(apenas quando status = in_hold)
user_risk.joined_at
datetime
Data de registo do utilizador
(apenas quando status = in_hold)
(apenas quando status = in_hold)
user_risk.last_deposit_at
datetime
Data do último depósito
(apenas quando status = in_hold)
(apenas quando status = in_hold)
user_risk.user_inventory
array
Valor do inventário do utilizador
(apenas quando status = in_hold)
(apenas quando status = in_hold)
user_risk.user_inventory[].last_updated_at
datetime
Data da última atualização do inventário para jogo específico
(apenas quando status = in_hold)
(apenas quando status = in_hold)
user_risk.user_inventory[].sum
float
Soma do inventário do utilizador em USD
(apenas quando status = in_hold)
(apenas quando status = in_hold)