API

Esquema de interacción:

1. Procesamiento de intercambio

• Usuario recarga saldo a través de SkinsBack.
• Selecciona skins CS2 para depósito y acepta intercambio.
• Tras aceptación de intercambio, SkinsBack envía solicitud WebHook con estado in_hold a Result URL especificado en configuración del proyecto.
• Cuerpo de webhook contendrá objeto con información de depósito y datos de usuario (campo user_risk) para decisión de aprobación de fondos.

Datos adicionales de usuario:

• Suma total de depósitos del usuario en todos los proyectos durante todo el período.
• Número total de depósitos del usuario en todos los proyectos durante todo el período.
• Suma y cantidad de depósitos con reversión donde usuario recibió pagos anticipados de proyectos.
• Fecha de registro de usuario en nuestro sistema
• Valor de inventario del usuario.
• Fecha del último depósito.

Ejemplo de datos:

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

Actualmente este es un conjunto de datos de prueba que creemos ayudará en la toma de decisiones. En 5 años de operación tenemos historial de más de 6 millones de usuarios. Combinando esta información con historial del cliente en su plataforma, puede tomar decisión sobre acreditación temprana de fondos.

3. Esquema de transición de estados

• Depósito permanecerá en estado pendiente para completar Steam Trade Protection de 8 días hasta que envíe solicitud al método offer_approve. Tras enviar solicitud, página de depósito mostrará estado final exitoso, estado de depósito cambiará a hold_approved y sistema enviará Webhook a Result URL con estado actualizado.
• Si usuario no cancela intercambio en 8 días, Result URL recibirá webhook con estado success, finalizando estado y acreditando fondos a balance del proyecto.
• En caso de cancelación de intercambio por usuario, Result URL recibirá webhook con estado hold_returned y fondos no serán acreditados.

Posibles variantes de transición de estado (campo status) para depósitos:

• pending → in_hold → success o fail (esquema estándar)
• pending → in_hold → hold_approved → success o hold_returned (esquema usando offer_approve)

4. Acreditación y reembolso a usuario

Al recibir estados hold_approved y hold_returned, implemente lógica de procesamiento adecuada. Esto puede incluir:

• desbloquear o bloquear saldo de usuario.
• aplicar otras sanciones según política de plataforma.

5. Escenarios de ejemplo

• Si cliente canceló previamente pagos tras recibir fondos - esto es señal de alerta, transacción debe retenerse.
• Si cliente tiene inventario valorado en $2000 y es cliente frecuente haciendo depósito de $50, transacción puede aprobarse ya que bloquear inventario y dañar reputación en su servicio sería desventajoso.
• Su departamento de riesgo verificó información del cliente, posiblemente solicitó KYC, y tras decisión de su personal de acreditar fondos al cliente, puede enviar solicitud al método offer_approve en cualquier momento dentro de 8 días

Así, muchos depósitos pequeños pueden procesarse automáticamente. Efectividad de este enfoque se analizará durante operación.

6. Información importante

Decisión final sobre acreditación de depósito la toma su parte. Tras 8 días fondos serán acreditados o se proporcionará información sobre cancelación de intercambio por acciones fraudulentas del cliente.