🧩 Resumen del Flujo de Integración (S2S)
El modelo Server-to-Server garantiza que la **gestión del saldo y las transacciones críticas** se manejen directamente entre tu Backend y la API de Pley2.Win, proporcionando seguridad total y una experiencia de usuario fluida en el iframe.
1 Depósito (S2S)
Tu servidor envía fondos a la billetera temporal de Pley2.Win.
2 Carga (Frontend)
El juego se carga en el Iframe con el saldo depositado.
3 Jugabilidad (Iframe)
El jugador interactúa y juega con el saldo interno.
4 Retiro (S2S)
Tu servidor recupera el saldo final del juego.
¡La comunicación crítica siempre ocurre Server-to-Server!
⚙️ Paso 1: Configuración Inicial
Antes de realizar cualquier llamada a la API, debes asegurar la lista blanca y obtener tus credenciales:
Requisitos del Cliente:
- Dominio para Iframe (ej.
juegos.tuplataforma.com) - IP Pública de tu Servidor Backend
Credenciales de Pley2.Win:
- `API_KEY` (Secreta)
- `URL_BASE_IFRAME`
- `URL_API_BILLETERA`
💰 Paso 2: Depositar Fondos (Backend S2S)
Llamada **POST** para transferir fondos del balance real de tu usuario a la billetera interna del juego.
Request JSON:
POST https://[URL_API_BILLETERA]/wallet/deposit
Content-Type: application/json
{
"api_key": "TU_API_KEY_SECRETA",
"user_id": "ID_UNICO_DE_TU_JUGADOR",
"amount": 1000.50,
"currency": "VES",
"transaction_id": "TU_ID_DE_TRANSACCION_UNICO"
}Respuesta Exitosa:
{
"success": true,
"message": "Depósito exitoso",
"new_balance": 1000.50
}Respuesta con Error:
{
"success": false,
"message": "Error: Fondos insuficientes del anfitrión"
}🖼️ Paso 3: Cargar el Iframe (Frontend)
Después del depósito exitoso, tu Frontend debe construir la URL del juego con los parámetros de la sesión:
Estructura del Iframe (HTML/PHP):
<iframe
src="https://[URL_BASE_IFRAME]/race?api_key=TU_API_KEY&user_id=JUGADOR_123¤cy=VES&balance=1000.50"
width="100%"
height="800px"
frameborder="0"
allowfullscreen>
</iframe>**NOTA:** Los parámetros `api_key` y `balance` son cruciales. Asegúrate de que tu backend envíe el `balance` devuelto en el Paso 2.
📤 Paso 4: Retirar Fondos (Backend S2S)
Llamada **POST** obligatoria al finalizar la sesión de juego. Recupera el saldo final (ganancia/pérdida) para actualizar la billetera real de tu usuario.
Request JSON (Retiro Total):
POST https://[URL_API_BILLETERA]/wallet/withdraw
Content-Type: application/json
{
"api_key": "TU_API_KEY_SECRETA",
"user_id": "ID_UNICO_DE_TU_JUGADOR",
"withdraw_all": true,
"currency": "VES",
"transaction_id": "TU_ID_DE_TRANSACCION_UNICO_RETIRO"
}Respuesta Exitosa:
{
"success": true,
"message": "Retiro exitoso",
"amount_withdrawn": 1250.00,
"remaining_balance": 0.00
}El `amount_withdrawn` es el monto que debes **abonar** al saldo final de tu jugador.