API

Esquema de interação:

1. Processamento de troca

• Usuário recarrega saldo via SkinsBack.
• Seleciona skins CS2 para depósito e aceita troca.
• Após aceitação da troca, SkinsBack envia solicitação WebHook com status in_hold para Result URL especificado nas configurações do projeto.
• Corpo do webhook conterá objeto com informações de depósito e dados do usuário (campo user_risk) para decisão de aprovação de fundos.

Dados adicionais do usuário:

• Soma total de depósitos do usuário em todos os projetos durante todo o período.
• Número total de depósitos do usuário em todos os projetos durante todo o período.
• Soma e contagem de depósitos com reversão onde usuário recebeu pagamentos antecipados de projetos.
• Data de registro do usuário em nosso sistema
• Valor do inventário do usuário.
• Data do último depósito.

Exemplo de dados:

{
  // ... deposit data
  "user_risk": {
	"total_deposits_count": 1,
	"total_deposits_sum": 7.68,
	"total_rollback_deposits_count": 0,
	"total_rollback_deposits_sum": 0,
	"joined_at": "2024-05-27 13:54:30",
	"last_deposit_at": "2025-03-27 17:22:51",
	"user_inventory": {
	  "cs2": {
		"last_updated_at": "2025-07-17T20:51:48.689998Z",
		"sum": 2.75
	  },
	  "dota2": {
		  "last_updated_at": "2025-07-17T20:50:48.689998Z",
		  "sum": 2.00
	  },
	  "rust": {
		"last_updated_at": "2025-07-17T20:55:48.689998Z",
		"sum": 1.40
	  },
	}
  }
}

Atualmente este é um conjunto de dados de teste que acreditamos ajudar na tomada de decisão. Em 5 anos de operação temos histórico de mais de 6 milhões de usuários. Combinando esta informação com histórico do cliente em sua plataforma, você pode tomar decisão sobre crédito antecipado de fundos.

3. Esquema de transição de status

• Depósito permanecerá em estado pendente para conclusão de Steam Trade Protection de 8 dias até você enviar solicitação para método offer_approve. Após envio de solicitação, página de depósito mostrará status final de sucesso, status do depósito mudará para hold_approved e sistema enviará Webhook para Result URL com status atualizado.
• Se usuário não cancelar troca em 8 dias, Result URL receberá webhook com status success, finalizando status e creditando fundos ao saldo do projeto.
• Em caso de cancelamento de troca pelo usuário, Result URL receberá webhook com status hold_returned e fundos não serão creditados.

Possíveis variantes de transição de status (campo status) para depósitos:

• pending → in_hold → success ou fail (esquema padrão)
• pending → in_hold → hold_approved → success ou hold_returned (esquema usando offer_approve)

4. Crédito e reembolso ao usuário

Ao receber status hold_approved e hold_returned, implemente lógica de processamento adequada. Pode incluir:

• desbloquear ou bloquear saldo do usuário.
• aplicar outras sanções conforme política da plataforma.

5. Cenários de exemplo

• Se cliente cancelou pagamentos após receber fundos anteriormente - isto é alerta vermelho, transação deve ser retida.
• Se cliente tem inventário avaliado em $2000 e é seu cliente frequente fazendo depósito de $100, transação pode ser aprovada já que bloquear inventário e arruinar reputação em seu serviço seria desvantajoso.
• Seu departamento de risco verificou informações do cliente, possivelmente solicitou KYC, e após decisão de sua equipe de creditar fundos ao cliente, você pode enviar solicitação ao método offer_approve a qualquer momento dentro de 8 dias

Assim, muitos pequenos depósitos podem ser processados automaticamente. Eficácia desta abordagem será analisada durante operação.

6. Informação importante

Decisão final sobre crédito de depósito é feita por seu lado. Após 8 dias fundos serão creditados ou serão fornecidas informações sobre cancelamento de troca devido a ações fraudulentas do cliente.