Wigos - Logrand TheOneRewards v1.1

Logrand - The One Rewards
Wigos
v1.1
9/21/2020
Copyright © 2008-2020 Win Technologies Limited
Control del documento
Fecha Versión Autor Revisión Notas
AGO-2020 1.0 Toni Jordà Andreu Julià
SEP-2020 1.1 Toni Jordà Andreu Julià
Contenidos
1 Introducción ................................................................................................................................- 3 -
2 Propuesta ....................................................................................................................................- 3 -
3 Arquitectura ................................................................................................................................- 3 -
4 Encriptación ................................................................................................................................- 4 -
5 Activación de Cuentas .................................................................................................................- 5 -
6 Web Service ................................................................................................................................- 6 -
6.1. Seguridad ............................................................................................................................- 6 -
6.2. Transferencias .....................................................................................................................- 6 -
6.2.1 C2GOCloseloopToOpenloopTransfer ..........................................................................- 6 -
6.2.2 C2GOOpenloopToCloseloopTransfer ..........................................................................- 8 -
6.3. Consulta del balance de créditos y puntos de una cuenta Wigos ......................................- 9 -
6.3.1 C2GOAccountBalance .................................................................................................- 9 -
6.3.2 C2GOOpenloopToCloseloopTaxPreview ...................................................................- 10 -
6.3.3 C2GOCloseloopToOpenloopTaxPreview ...................................................................- 11 -
6.3.4 C2GOAccountLoyaltyPoints ......................................................................................- 13 -
6.4. Bloqueo de cuentas Wigos................................................................................................- 13 -
6.4.1 C2GOAccountLock.....................................................................................................- 13 -
6.4.2 C2GOAccountUnLock ................................................................................................- 14 -
2-15
1 Introducción
El propósito de este documento es proveer una solución que permita a Wigos interactuar
con la plataforma bancaria de un proveedor externo a fin de transferir de manera ágil
montos de la cuenta del sistema del casino a una cuenta externa y viceversa.
2 Propuesta
La idea consiste en facilitar la transferencia de datos entre el sistema Wigos y un sistema
externo. Logrand desarrollará una App que se comunicará con el sistema Wigos de una sala
a través de la plataforma The One Rewards (TOR) llamando a los métodos propios de Wigos
facilitados por Win Systems.
Los métodos actuales permiten vincular una cuenta del proveedor externo con una cuenta
de cliente del sistema Wigos. En caso de que se considere necesario, se valorará establecer
el ID de la cuenta de cliente de Wigos como ID único para las cuentas del sistema externo.
3 Arquitectura
La interacción entre el proveedor externo y Wigos se realiza mediante un Web service que
ofrece una serie de métodos que se detallan más adelante.
Adicionalmente, se requieren nuevos servicios en el backoffice de Wigos que convivirán con

los ya conocidos:
• Auth service
• Data Center service
3-15
• Site service
4 Encriptación
Determinados datos en las transacciones entre la plataforma del proveedor externo y Wigos
viajan encriptados con el algoritmo de cifrado AES-256-CBC.
4-15
En concreto, la encriptación es requerida en los siguientes datos:
• El Password en la solicitud de token al Auth Service de Wigos.
• El AccountID en cualquier llamada al Web Service de Wigos.
La pareja de claves utilizadas para la encriptación es la misma para ambos servicios y se

define en los archivos de configuración de cada uno de ellos:
• Auth Service
o Archivo: WSI.OCLAuthService.exe.config
o Claves
WIGOSAESkey, clave en hexadecimal de longitud máxima de 256 bits.
WIGOSAESiv, vector de inicialización en hexadecimal de longitud
máxima de 16 caracteres.
• Web Service
o Archivo: WSI.OCLDataCenterHub.exe.config
o Claves
C2GOAESKey, clave en hexadecimal de longitud máxima de 256 bits.
C2GOAESiv, vector de inicialización en hexadecimal de longitud
máxima de 16 caracteres.
La clave y el vector pueden ser generadas en C# con los métodos GenerateKey y GenerateIV
de la clase Aes (System.Security.Cryptography). En cualquier caso, se facilita la herramienta
de generación de claves GenerateAESKeys.exe, basada en los métodos indicados.
5 Activación de Cuentas
TOR activará sus cuentas con la ayuda de SP_TOR_LinkAccount, una Stored Procedure en la
base de datos OCL que establecerá un vínculo entre una cuenta TOR y una cuenta Wigos.
La implementación se basa en el establecimiento, acordado con Logrand, de una relación

1:1 entre las cuentas TOR y las cuentas Wigos, ya que una cuenta TOR solamente puede
vincularse a una cuenta Wigos.
SP_TOR_LinkAccount - Input
WigosAccountId Wigos Account ID to be Bigint Not encrypted.
linked to the external
provider’s account.
Una cuenta TOR se construye con el siguiente formato: TOR:xxxxxxxxxxxxxxxx

• Donde “TOR” indica el proveedor externo (=Logrand) y “:” actúa como separador.
• En el caso de TOR, xxxxxxxxxxxxxxxx es el número de la cuenta Wigos vinculada. Se
trata de 16 dígitos numéricos con ceros a la izquierda.
• La longitud total de la cuenta queda fijada a 20 caracteres.
5-15
E.g.: La siguiente llamada vincularía la cuenta Wigos 1086034 con la cuenta
TOR:0000000001086034: exec SP_TOR_LinkAccount 1086034.
Hasta que no se establezca la vinculación con la cuenta Wigos, no será posible realizar
operaciones de consulta, de transferencia o de bloqueo de cuentas.
La plataforma de Logrand invocará la SP a su conveniencia, según la disponibilidad que

precisen. Por ejemplo, cada 5 minutos para todas las cuentas Wigos registradas en las
últimas 2 horas o bien al final del día para todas las cuentas Wigos que registraron actividad
en esa fecha.
6 Web Service
La funcionalidad cubierta por los métodos ofrecidos cubre los siguientes aspectos:
• Transferencias monetarias entre la plataforma del proveedor externo y el sistema
Wigos de la sala.
• Consulta del balance de crédito y puntos de cuentas Wigos de la sala.
• Bloqueo de cuentas Wigos de la sala.
La nomenclatura actual de los métodos denomina Openloop al circuito del proveedor

externo y Closeloop al circuito interno de la sala Wigos.
6.1. Seguridad
Los métodos del Web Service de Wigos delegan la autorización de acceso al servicio de
autentificación de Wigos implementado con el framework OAuth.
Cualquier transacción de la plataforma externa hacia Wigos debe incluir un token activo
facilitado por la autentificación. Los tokens, encriptados, tienen una vigencia limitada por lo
que se recomienda no reusarlos y solicitar uno nuevo al iniciar cada transacción.
La solicitud de tokens al Auth Service deben incluir las credenciales definidas en el archivo
de configuración del propio servicio (WSI.OCLAuthService.exe.config):
• UserApp
• PassApp
También se definen en el fichero de configuración las claves utilizadas en la encriptación de

las peticiones tal y como se explica en el apartado Encriptación de este documento.
6.2. Transferencias
Este apartado detalla los métodos que implementan las transferencias entre una cuenta
Wigos y otra cuenta del proveedor externo.
6.2.1 C2GOCloseloopToOpenloopTransfer
Transfiere un monto de la cuenta de Wigos al Sistema del proveedor externo.
6-15
En caso de que la transferencia no sea del balance total de la cuenta, es necesario habilitar
la configuración de retiros parciales correspondiente al C2GO en la configuración propia de
la sala.
C2GOCloseloopToOpenloopTransfer - Input
C2GOAccountId Account ID provided by the String Encrypted using AES 256 - CBC
external provider. 64 bits
SiteId Wigos Site ID Int Optional
32 bits if not specified the account origin
site id is used
C2GOTransactionId Transaction ID provided by Long
the external provider. 64 bits
Amount Amount to transfer Decimal

32 bits
Token Token generated by the String
AuthService
C2GOCloseloopToOpenloopTransfer - Output
Account Account ID provided by the String Not encrypted.
Site Wigos Site ID Int
32 bits
Transaction Transaction ID provided by Long

Status Operation status Values

• OK
• In progress
• Error
• Unknown
Amount Amount transferred Decimal

32 bits
FederalTax Amount corresponding to Decimal
the Federal tax applied to 32 bits
the operation.
StateTax Amount corresponding to Decimal

the State tax applied to the 32 bits
operation.
Currency Currency used in the String
operation.
7-15
Voucher Id of the voucher created Long
by Wigos related to the 64 bits
operation.
VoucherHTML HTML contents of the String

voucher created by Wigos.
6.2.2 C2GOOpenloopToCloseloopTransfer
Transfiere un monto del Sistema del proveedor externo a la cuenta de Wigos realizando una
operación de depósito en cuenta.
C2GOOpenloopToCloseloopTransfer - Input
site id is used
Amount Amount to transfer Decimal

32 bits
AuthService
C2GOOpenloopToCloseloopTransfer - Output
32 bits


• OK
• In progress
• Error
• Unknown
Amount Amount transferred Decimal

32 bits
8-15
FederalTax Amount corresponding to Decimal
the Federal tax applied to 32 bits
the operation.
StateTax Amount corresponding to Decimal

the State tax applied to the 32 bits
operation.
operation.
operation.

6.3. Consulta del balance de créditos y puntos de una cuenta Wigos

Se detallan en este apartado los métodos que permiten obtener información precisa y
previa a cualquier operación de transferencia entre la cuenta de la plataforma del
proveedor externo y la cuenta Wigos asociada.
En otros términos, los métodos permiten consultar de antemano el detalle completo de un

depósito (C2GOOpenloopToCloseloopTaxPreview) o de un retiro
(C2GOCloseloopToOpenloopTaxPreview) de una cuenta Wigos. El detalle incluye todos los
conceptos configurados en la sala y aplicables a las operaciones (cargo por servicio,
impuestos, etc.).
6.3.1 C2GOAccountBalance
Permite consultar el saldo de una cuenta Wigos asociada a la cuenta del proveedor externo.
C2GOAccountBalance - Input
site id is used

AuthService
C2GOAccountBalance - Output
9-15
32 bits


• OK
• In progress
• Error
• Unknown
Amount Wigos account balance Decimal

32 bits
Fields Account balance concepts String Dictionary keys

Dictionary CurrentBalance - Money
CurrentBalance_1 - Money
MaxDevolution - Money
PromoNotRedeemable - Money
PromoRedeemable - Money
Redeemable - Money
Detained - Money
Reserved - Money
BucketNRCredit - Money
BucketRECredit - Money
RedeemLimit - Money

operation.
6.3.2 C2GOOpenloopToCloseloopTaxPreview
Permite consultar el detalle de todos los conceptos aplicables al depósito en una cuenta
Wigos a partir de una transferencia desde la cuenta del proveedor externo.
C2GOOpenloopToCloseloopTaxPreview - Input
site id is used
10-15
Amount Amount to be transferred Decimal

from the external provider 32 bits
to the Wigos account.
AuthService
C2GOOpenloopToCloseloopTaxPreview - Output
32 bits


• OK
• In progress
• Error
• Unknown
Fields Operation detail String Dictionary keys

Redeemable - Money
Detained - Money
Reserved - Money
RedeemLimit - Money

operation.
6.3.3 C2GOCloseloopToOpenloopTaxPreview
Permite consultar el detalle de todos los conceptos aplicables al retiro de una cuenta Wigos
que será transferido a la cuenta del proveedor externo.
11-15
C2GOCloseloopToOpenloopTaxPreview - Input
site id is used
Amount Amount to be transferred Decimal

from the Wigos account to 32 bits
the external provider.
AuthService
C2GOCloseloopToOpenloopTaxPreview - Output
32 bits


• OK
• In progress
• Error
• Unknown
Fields Operation detail String Dictionary keys

Redeemable - Money
Detained - Money
Reserved - Money
RedeemLimit - Money

operation.
12-15
6.3.4 C2GOAccountLoyaltyPoints
Devuelve el balance de la cuenta Wigos asociada al identificador de cuenta del proveedor

externo.
C2GOAccountLoyaltyPoints - Input
site id is used

AuthService
C2GOAccountLoyaltyPoints - Output
32 bits


• OK
• In progress
• Error
• Unknown
Points Amount of points available Decimal

in the Wigos account. 32 bits
6.4. Bloqueo de cuentas Wigos

Se ofrece la posibilidad de bloquear o desbloquear la cuenta Wigos asociada para evitar
usos indebidos del saldo de la cuenta del casino.
6.4.1 C2GOAccountLock
Bloquea la cuenta Wigos.
13-15
C2GOAccountLock - Input
site id is used
Reason Lock reason Enumeratio Values:

n • Ordered by the user (app).
• Ordered by the external
platform.
Comment Remarks String

AuthService
C2GOAccountLock - Output
32 bits


• OK
• In progress
• Error
• Unknown

operation.

6.4.2 C2GOAccountUnLock
Desbloquea la cuenta Wigos.
14-15
C2GOAccountUnLock - Input
site id is used
Reason Unlock reason Enumeratio Values:

n • Ordered by the user (app).
• Ordered by the external
platform.
Comment Remarks String

AuthService
C2GOAccountUnLock - Output
32 bits


• OK
• In progress
• Error
• Unknown

operation.

15-15

Wigos - Logrand TheOneRewards v1.1

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Wigos - Logrand TheOneRewards v1.1

Cargado por

Copyright:

Formatos disponibles

Logrand - The One Rewards

Adicionalmente, se requieren nuevos servicios en el backoffice de Wigos que convivirán con

La pareja de claves utilizadas para la encriptación es la misma para ambos servicios y se

La implementación se basa en el establecimiento, acordado con Logrand, de una relación

Una cuenta TOR se construye con el siguiente formato: TOR:xxxxxxxxxxxxxxxx

La plataforma de Logrand invocará la SP a su conveniencia, según la disponibilidad que

La nomenclatura actual de los métodos denomina Openloop al circuito del proveedor

También se definen en el fichero de configuración las claves utilizadas en la encriptación de

Transfiere un monto de la cuenta de Wigos al Sistema del proveedor externo.

Amount Amount to transfer Decimal

Transaction Transaction ID provided by Long

Status Operation status Values

Amount Amount transferred Decimal

StateTax Amount corresponding to Decimal

VoucherHTML HTML contents of the String

Amount Amount to transfer Decimal

Transaction Transaction ID provided by Long

Status Operation status Values

Amount Amount transferred Decimal

StateTax Amount corresponding to Decimal

VoucherHTML HTML contents of the String

6.3. Consulta del balance de créditos y puntos de una cuenta Wigos

En otros términos, los métodos permiten consultar de antemano el detalle completo de un

Token Token generated by the String

Transaction Transaction ID provided by Long

Status Operation status Values

Amount Wigos account balance Decimal

Fields Account balance concepts String Dictionary keys

Currency Currency used in the String

Amount Amount to be transferred Decimal

Transaction Transaction ID provided by Long

Status Operation status Values

Fields Operation detail String Dictionary keys

Currency Currency used in the String

Amount Amount to be transferred Decimal

Transaction Transaction ID provided by Long

Status Operation status Values

Fields Operation detail String Dictionary keys

Currency Currency used in the String

Devuelve el balance de la cuenta Wigos asociada al identificador de cuenta del proveedor

Token Token generated by the String

Transaction Transaction ID provided by Long

Status Operation status Values

Points Amount of points available Decimal

6.4. Bloqueo de cuentas Wigos

Bloquea la cuenta Wigos.

Reason Lock reason Enumeratio Values:

Comment Remarks String

Token Token generated by the String

Transaction Transaction ID provided by Long

Status Operation status Values

Voucher Id of the voucher created Long

VoucherHTML HTML contents of the String

Desbloquea la cuenta Wigos.

Reason Unlock reason Enumeratio Values:

Comment Remarks String

Token Token generated by the String

Transaction Transaction ID provided by Long

Status Operation status Values

Voucher Id of the voucher created Long

VoucherHTML HTML contents of the String

También podría gustarte