API

Schemat interakcji:

1. Przetwarzanie wymiany

• Użytkownik doładowuje saldo przez SkinsBack.
• Wybiera skórki CS2 do depozytu i akceptuje wymianę.
• Po akceptacji wymiany SkinsBack wysyła żądanie WebHook ze statusem in_hold do określonego Result URL w ustawieniach projektu.
• Treść webhooka będzie zawierać obiekt informacji o depozycie i dane użytkownika (pole user_risk) do podjęcia decyzji o zatwierdzeniu środków.

Dodatkowe dane użytkownika:

• Całkowita suma depozytów użytkownika we wszystkich projektach przez cały okres.
• Całkowita liczba depozytów użytkownika we wszystkich projektach przez cały okres.
• Suma i liczba depozytów z odwróceniem, gdzie użytkownik otrzymał zaliczki od projektów.
• Data rejestracji użytkownika w naszym systemie
• Wartość ekwipunku użytkownika.
• Data ostatniego depozytu.

Przykład danych:

{
  // ... 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
	  },
	}
  }
}

Obecnie jest to zestaw danych testowych, który naszym zdaniem pomoże w podejmowaniu decyzji. W ciągu 5 lat działalności mamy historię ponad 6 milionów użytkowników. Łącząc te informacje z historią klienta na Twojej platformie, możesz podjąć decyzję o wcześniejszym zasileniu środkami.

3. Schemat przejść statusów

• Depozyt pozostanie w stanie oczekiwania na ukończenie 8-dniowej Steam Trade Protection, dopóki nie wyślesz żądania do metody offer_approve. Po przesłaniu żądania strona depozytu pokaże ostateczny status sukcesu, status depozytu zmieni się na hold_approved, a system wyśle Webhook do Result URL ze zaktualizowanym statusem.
• Jeśli użytkownik nie anuluje wymiany w ciągu 8 dni, Result URL otrzyma webhook ze statusem success, finalizując status i zasilając środki na saldo projektu.
• W przypadku anulowania wymiany przez użytkownika, Result URL otrzyma webhook ze statusem hold_returned i środki nie zostaną zasilone.

Możliwe warianty przejść statusów depozytu (pole status):

• pending → in_hold → success lub fail (standardowy schemat)
• pending → in_hold → hold_approved → success lub hold_returned (schemat używający offer_approve)

4. Zasilanie i zwrot użytkownikowi

Po otrzymaniu statusów hold_approved i hold_returned zaimplementuj odpowiednią logikę przetwarzania depozytów. Może to obejmować:

• odblokowanie lub zablokowanie salda użytkownika.
• stosowanie innych sankcji zgodnie z polityką platformy.

5. Przykładowe scenariusze

• Jeśli klient wcześniej anulował płatności po otrzymaniu środków - to czerwona flaga, transakcja powinna być wstrzymana.
• Jeśli klient ma ekwipunek o wartości 2000$ i jest Twoim stałym klientem dokonującym depozytu 50$, transakcję można zatwierdzić, ponieważ blokada ekwipunku i niszczenie reputacji w Twojej usłudze byłoby niekorzystne.
• Twój dział ryzyka sprawdził informacje o kliencie, prawdopodobnie zażądał KYC, a po podjęciu decyzji przez Twój personel o zasileniu środków klienta, możesz wysłać żądanie do metody offer_approve w dowolnym momencie w ciągu 8 dni

W ten sposób wiele małych depozytów może być przetwarzanych automatycznie. Skuteczność tego podejścia będzie analizowana podczas działania.

6. Ważne informacje

Ostateczna decyzja o zasileniu depozytu należy do Ciebie. Po 8 dniach środki zostaną zasilone lub zostaną dostarczone informacje o anulowaniu wymiany z powodu oszukańczych działań klienta.