API

交互流程:

1. 交易处理

• 用户通过SkinsBack充值余额。
• 选择CS2皮肤进行存款并接受交易。
• 接受交易后，SkinsBack将发送状态为in_hold的WebHook请求到项目设置中指定的Result URL。
• WebHook正文将包含存款信息和用户数据（字段user_risk）以便决定是否入账。

用户附加数据:

• 用户在所有项目中的总存款金额。
• 用户在所有项目中的总存款次数。
• 用户获得项目预付款后发生回滚的存款金额和次数。
• 用户在我们系统中的注册日期
• 用户库存价值。
• 最后一次存款日期。

数据示例:

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

目前这是我们认为能帮助您决策的测试数据集。经过5年运营，我们拥有超过600万用户的历史数据。结合这些信息与客户在您平台上的历史记录，您可以决定是否提前入账。

3. 状态转换流程

• 存款将保持等待完成8天Steam交易保护的状态，直到您发送请求到offer_approve方法。发送请求后，存款页面将显示最终成功状态，存款状态将变为hold_approved，系统会发送Webhook到Result URL更新状态。
• 如果用户在8天内未取消交易，Result URL将收到状态为success的webhook，表示最终确认并将金额计入项目余额。
• 如果用户取消交易，Result URL将收到状态为hold_returned的webhook，金额将不会入账。

存款状态（字段status）可能有以下几种转换方式:

• pending → in_hold → success 或 fail (标准流程)
• pending → in_hold → hold_approved → success 或 hold_returned (使用offer_approve的流程)

4. 入账和用户退款

当收到hold_approved和hold_returned状态时，需要实现相应的存款处理逻辑。这可能包括:

• 解锁或锁定用户余额。
• 根据平台政策采取其他措施。

5. 场景示例

• 如果客户之前收到款项后取消支付——这是危险信号，建议保留交易。
• 如果客户库存价值2000美元，且是您的常客，存款50美元，则可以批准交易，因为锁定库存和损害在您服务中的声誉对他们不利。
• 您的风控部门检查了客户信息，可能要求KYC，在您的员工决定为客户入账后，您可以在8天内随时发送请求到offer_approve方法

这样，许多小额存款可以自动处理。这种方法的效果将在工作中进行分析。

6. 重要信息

存款入账的最终决定权在您。8天后款项将入账，或提供因客户不诚信行为取消交易的信息。