Empiece por el dueño del saldo

En el modelo de billetera por callback que usa WGC, la plataforma del casino guarda la billetera del jugador. WGC llama a su plataforma para pedir un saldo o el resultado de una transacción de juego. WGC no almacena billeteras de jugadores; la única excepción es un cliente de demo creado por el personal de WGC, que usa una billetera de prueba.

La referencia del jugador identifica a un jugador en el sistema propio del casino, como una cadena de 1 a 64 caracteres ASCII imprimibles. No es la cuenta comercial que se usa para acceder a WGC. Acuerde primero este límite, de modo que ambos equipos sepan qué sistema manda cuando una solicitud falla o se discute un importe. Sin ese acuerdo, cada discrepancia obliga a comparar desde cero los registros de ambos equipos.

Siga una transacción por los sistemas

Una integración típica necesita una consulta de saldo y una forma de registrar una apuesta y su resultado. El contrato de callback de WGC nombra tres comandos: getBalance para leer el saldo, writeBet para registrar una apuesta con su ganancia en una sola solicitud, y rollback para cancelar una apuesta. Cuando un estudio envía la apuesta y el resultado por separado, WGC los une en una sola ronda con un identificador de ronda, y ambas llamadas viajan dentro de ella.

Mantenga juntas en sus registros las referencias del jugador, la moneda, el juego, la ronda y la transacción. Un enlace de lanzamiento es solo el punto de entrada a un juego; no confirma que se haya completado una consulta de saldo ni una liquidación. Por eso, en las solicitudes de soporte, apóyese en los números de transacción y de ronda y no solo en el enlace de lanzamiento.

Trate un reintento como la misma transacción

Un tiempo de espera de red puede ocurrir después de que una operación fue aceptada, pero antes de que la respuesta llegara a quien llamó. Repetir esa operación a ciegas puede cobrar dos veces al jugador. Un manejador idempotente reconoce el mismo identificador de transacción y devuelve el resultado registrado en lugar de aplicar los importes otra vez. Con WGC esto es una condición de la integración: writeBet se registra una vez por identificador de transacción, y una llamada repetida devuelve el mismo saldo.

Los tiempos de espera también tienen reglas. WGC espera su respuesta durante tres segundos, y una respuesta cuenta solo con un estado 2xx. Si no hay respuesta a tiempo, la apuesta se rechaza al estudio, la operación queda desconocida y sigue un rollback. El rollback se repite según un calendario hasta por 30 días, así que conserve sus registros de operaciones al menos ese tiempo.

Incluya en sus pruebas de aceptación los duplicados concurrentes, las respuestas demoradas y un reintento después de un tiempo de espera. Los reintentos de apertura de sesión son un contrato aparte, y no debe suponer que la billetera funciona igual. Tratar ambos contratos como escenarios distintos en sus pruebas facilita encontrar el origen de los errores.

Escriba con claridad la moneda y los importes

Una billetera de jugador puede usar una moneda distinta de la cuenta comercial del operador. Cada operación debe identificar su moneda y seguir las reglas de precisión acordadas. Un importe es un número, o una cadena con punto, y una sola operación puede ser, como máximo, de un millón de USD al tipo de la ronda.

El saldo comercial con WGC se lleva en USD y no es el saldo disponible del jugador. No deduzca uno a partir del otro. Tampoco suponga que una moneda que aparece en un back office es compatible con todos los juegos: un juego que no se abre en una moneda queda marcado en el catálogo. Confirme las combinaciones previstas antes de probar; así, un rechazo en la prueba puede ser un límite de combinación y no un error de billetera.

Pruebe los fallos, no solo el juego exitoso

Prepare comprobaciones para los casos que más importan:

  • Fondos insuficientes. Un rechazo se escribe en el cuerpo, por ejemplo con un error de fondos insuficientes y estado 200.
  • Un jugador desconocido o una moneda no admitida.
  • Una firma no válida. Cada llamada se firma con HMAC-SHA256; compruebe la firma sobre el cuerpo sin procesar, compare en tiempo constante y rechace llamadas de más de cinco minutos.
  • Una respuesta demorada y una entrega duplicada.

Guarde en sus propios registros la referencia de la transacción y un número de solicitud de soporte, y compare las transacciones aceptadas en ambos lados, no solo los saldos finales.

Una prueba en seco puede validar la forma de un mensaje, pero no puede demostrar que un estudio real y su billetera se liquidan correctamente juntos. Para ensayar, una clave de prueba abre un juego de prueba que hace llamadas reales a su Callback URL sin dinero, y una opción para perder la respuesta comprueba su rollback. En el back office, la verificación de integración muestra un registro en vivo de cada llamada, y la prueba de integración ejecuta 14 comprobaciones de su billetera.

Confirme la preparación de cada conexión

WGC ofrece un contrato de callback y un probador para preparar este trabajo, y el Callback de billetera funciona. Los ejemplos de manejadores para Node.js, PHP y Python y una lista de verificación de salida en vivo de 14 puntos son públicos. La preparación de cada conexión se confirma igualmente por proyecto: converse con el equipo de integración sobre el flujo admitido, la política de fallos y los criterios de aceptación. Su gerente le entrega directamente los datos de acceso; esos datos no figuran en las páginas públicas.

Para el contrato completo, lea la página de billetera seamless; para los pasos que la rodean, la página de integración, el modo demo y de prueba y la descripción general de la API de casino.