API

Etkileşim şeması:

1. Takas işleme

• Kullanıcı SkinsBack üzerinden bakiye yükler.
• Yatırım için CS2 skinlerini seçer ve takası kabul eder.
• Takas kabulünden sonra SkinsBack, proje ayarlarında belirtilen Result URL adresine in_hold durumlu WebHook isteği gönderir.
• Webhook gövdesi, yatırım bilgisi nesnesini ve fon onay kararı için kullanıcı verilerini (user_risk alanı) içerecektir.

Ek kullanıcı verileri:

• Kullanıcının tüm projelerde tüm dönem boyunca toplam yatırım miktarı.
• Kullanıcının tüm projelerde tüm dönem boyunca toplam yatırım sayısı.
• Kullanıcının projelerden avans ödemeler aldığı geri alınan yatırımların miktarı ve sayısı.
• Kullanıcının sistemimize kayıt tarihi
• Kullanıcı envanter değeri.
• Son yatırım tarihi.

Veri örneği:

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

Şu anda bu, karar vermeye yardımcı olacağına inandığımız bir test veri setidir. 5 yıllık operasyon süresince 6 milyondan fazla kullanıcının geçmişi bulunmaktadır. Bu bilgiyi platformunuzdaki müşteri geçmişiyle birleştirerek, erken fon tahsisi hakkında karar verebilirsiniz.

3. Durum geçiş şeması

• Yatırım, offer_approve metoduna istek gönderene kadar 8 günlük Steam Trade Protection tamamlanması için bekleme durumunda kalacaktır. İstek gönderildikten sonra, yatırım sayfası nihai başarı durumunu gösterecek, yatırım durumu hold_approved olarak değişecek ve sistem güncellenmiş durumla Result URL adresine Webhook gönderecektir.
• Kullanıcı 8 gün içinde takası iptal etmezse, Result URL durumu sonlandıran ve fonları proje bakiyesine aktaran success durumlu bir webhook alacaktır.
• Kullanıcı tarafından takas iptali durumunda, Result URL hold_returned durumlu bir webhook alacak ve fonlar tahsis edilmeyecektir.

Olası yatırım durumu (status alanı) geçiş varyantları:

• pending → in_hold → success veya fail (standart şema)
• pending → in_hold → hold_approved → success veya hold_returned (offer_approve kullanan şema)

4. Tahsis ve kullanıcı iadesi

hold_approved ve hold_returned durumlarını aldığınızda, uygun yatırım işleme mantığını uygulayın. Bu şunları içerebilir:

• kullanıcı bakiyesinin kilidini açma veya kilitleme.
• platform politikasına göre diğer yaptırımları uygulama.

5. Örnek senaryolar

• Müşteri daha önce fon aldıktan sonra ödemeleri iptal ettiyse - bu bir uyarı işaretidir, işlem bekletilmelidir.
• Müşterinin $2000 değerinde envanteri varsa ve $50 yatırım yapan düzenli müşterinizse, envanteri bloke etmek ve hizmetinizde itibarını zedelemek dezavantajlı olacağından işlem onaylanabilir.
• Risk departmanınız müşteri bilgilerini kontrol etti, muhtemelen KYC talep etti ve personeliniz müşteriye fon tahsis etmeye karar verdikten sonra, 8 gün içinde herhangi bir zamanda offer_approve metoduna istek gönderebilirsiniz

Böylece birçok küçük yatırım otomatik olarak işlenebilir. Bu yaklaşımın etkinliği operasyon sırasında analiz edilecektir.

6. Önemli bilgi

Yatırımın tahsis edilmesine ilişkin nihai karar sizin tarafınızdan verilir. 8 gün sonra fonlar tahsis edilecek veya müşterinin dolandırıcılık eylemleri nedeniyle takasın iptal edildiğine dair bilgi sağlanacaktır.