API

Quy trình tương tác:

1. Xử lý giao dịch

• Người dùng nạp tiền vào tài khoản thông qua SkinsBack.
• Chọn skin CS2 để gửi và chấp nhận giao dịch.
• Sau khi chấp nhận giao dịch, SkinsBack sẽ gửi yêu cầu WebHook với trạng thái in_hold đến Result URL được chỉ định trong cài đặt dự án.
• Trong nội dung webhook sẽ chứa đối tượng với thông tin về tiền gửi và dữ liệu người dùng (trường user_risk) để quyết định việc ghi có.

Thông tin bổ sung về người dùng:

• Tổng số tiền gửi của người dùng trong toàn bộ thời gian trên tất cả các dự án.
• Tổng số lần gửi tiền của người dùng trong toàn bộ thời gian trên tất cả các dự án.
• Số tiền và số lần gửi tiền bị hoàn trả, trong đó người dùng nhận thanh toán trước từ các dự án.
• Ngày đăng ký của người dùng trong hệ thống của chúng tôi
• Giá trị kho đồ của người dùng.
• Ngày gửi tiền gần nhất.

Ví dụ dữ liệu:

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

Hiện tại đây là bộ dữ liệu thử nghiệm mà chúng tôi tin rằng sẽ giúp bạn trong việc ra quyết định. Trong 5 năm làm việc, chúng tôi có lịch sử của hơn 6 triệu người dùng. Kết hợp thông tin này với lịch sử của khách hàng trên nền tảng của bạn, bạn có thể quyết định việc ghi có sớm.

3. Sơ đồ chuyển đổi trạng thái

• Tiền gửi sẽ ở trạng thái chờ hoàn tất Bảo vệ giao dịch Steam 8 ngày cho đến khi bạn gửi yêu cầu đến phương thức offer_approve. Sau khi gửi yêu cầu, trên trang tiền gửi, khách hàng sẽ nhận được trạng thái thành công cuối cùng và trạng thái tiền gửi sẽ được chuyển thành hold_approved và hệ thống sẽ gửi Webhook đến Result URL với trạng thái cập nhật.
• Nếu người dùng không hủy giao dịch trong vòng 8 ngày, Result URL sẽ nhận được webhook với trạng thái success, có nghĩa là xác nhận trạng thái cuối cùng và ghi có vào tài khoản dự án.
• Trong trường hợp hủy giao dịch bởi người dùng, Result URL sẽ nhận được webhook với trạng thái hold_returned và tiền sẽ không được ghi có.

Có một số cách chuyển đổi trạng thái (trường status) của tiền gửi:

• pending → in_hold → success hoặc fail (quy trình tiêu chuẩn)
• pending → in_hold → hold_approved → success hoặc hold_returned (quy trình sử dụng offer_approve)

4. Ghi có và hoàn trả cho người dùng

Khi nhận được trạng thái hold_approved và hold_returned, cần triển khai logic xử lý tiền gửi tương ứng. Điều này có thể bao gồm:

• mở khóa hoặc khóa số dư người dùng.
• áp dụng các biện pháp khác theo chính sách nền tảng.

5. Ví dụ kịch bản

• Nếu khách hàng đã hủy thanh toán sau khi nhận tiền — đây là dấu hiệu cảnh báo, nên giữ lại giao dịch.
• Nếu khách hàng có kho đồ trị giá 2000$, và đây là khách hàng thường xuyên của bạn, gửi tiền 50$, thì có thể phê duyệt giao dịch vì việc khóa kho đồ và làm xấu danh tiếng trên dịch vụ của bạn là không có lợi cho họ.
• Bộ phận rủi ro của bạn đã kiểm tra thông tin khách hàng, có thể yêu cầu KYC, và sau khi nhân viên của bạn quyết định ghi có cho khách hàng, bạn có thể gửi yêu cầu đến phương thức offer_approve bất kỳ lúc nào trong vòng 8 ngày

Như vậy, nhiều khoản gửi nhỏ có thể được xử lý tự động. Hiệu quả của phương pháp này sẽ được phân tích trong quá trình làm việc.

6. Thông tin quan trọng

Quyết định cuối cùng về việc ghi có tiền gửi thuộc về phía bạn. Sau 8 ngày, tiền sẽ được ghi có hoặc sẽ có thông tin về việc hủy giao dịch do hành vi không trung thực của khách hàng.