Cómo implementar la venta de moneda virtual Metaframe en su interfaz de usuario

Puede vender moneda virtual sin usar el widget de Metaframe. Por ejemplo, si quiere implementar su propia interfaz de usuario de tienda o usar otro servicio de autorización. Para ello, debe implementar la lógica para hacer compras, la recarga automática de moneda virtual y mostrar el saldo del usuario empleando la API de Metaframe.

Requisitos previos

Antes de comenzar, configure los ajustes necesarios del proyecto:

1. Crear un proyecto.
2. Crear paquetes de monedas virtuales en la Cuenta del editor.
3. Obtenga los ID y la clave secreta necesarios. Para ello, contacte con su gestor del éxito del cliente, envíe un correo electrónico a csm@xsolla.com o a integration@xsolla.com. Facilite la siguiente información de Cuenta del editor:

• ID de comerciante, que se encuentra:
  • Junto al nombre de su empresa.
  • En la sección Company settings > Company.
  • En la URL de la barra de direcciones del navegador en cualquier página de Cuenta del editor. La URL tiene el siguiente formato: https:​//publisher.xsolla.com/ID de comerciante/Cuenta del editor sección.

• ID del proyecto, que puede encontrarse junto al nombre del proyecto.

• Una clave secreta para firmar los webhooks del proyecto, que puede encontrarse en la sección Project settings > Webhooks.

• La clave de API, que se muestra en Cuenta del editor solamente una vez cuando se crea, debe almacenarse en su servidor. Puede crear una nueva clave en la siguiente sección:
  • Company settings > API keys.
  • Project settings > API keys.

El equipo de Xsolla le proporcionará la siguiente información necesaria para realizar una configuración más avanzada:

• ID del host
• ID de cliente OAuth 2.0 de la cuenta de Xsolla
• Clave secreta del cliente OAuth 2.0 de la cuenta de Xsolla

Obtener el token del servidor

Se requiere el token del servidor para obtener el token de acceso del usuario y para la recarga automática.

En el back-end de su aplicación, implemente un método para obtener el Token web JSON (JWT) del servidor utilizando la llamada API Generate JWT. La solicitud debe contener los siguientes parámetros:

• grant_type es el tipo de JWT, transmita el valor client_credentials.
• client_secret es la clave secreta que se recibe de Xsolla.
• client_id es el ID de cliente que se recibe de Xsolla.

Obtener token de acceso del usuario

El token de autorización del usuario es necesario para generar un token de pago y solicitar el saldo de moneda virtual del usuario.

Si usa su propio sistema de autorización, puede obtener un token de autorización adecuado utilizando:

• token de acceso de la red social
• ID personalizado - ID de usuario generado en su servidor

Obtener token durante el inicio de sesión mediante red social

1. Establecer la autorización de usuario mediante una red social en su Cuenta del editor.

1. 1. Abra su proyecto en Cuenta del editor.
   2. Pulse en Login en el menú lateral.
   3. Pulse en Create Login project.
   4. Seleccione Standard Login project y haga clic en Create and set up. Una vez creado su nuevo proyecto de Login, podrá ver la página con la configuración del proyecto de Login.
   5. En el bloque Login methods, seleccione Social login y pulse en Configure.
   6. Conecte las redes sociales que utiliza para el inicio de sesión mediante redes sociales en su aplicación.
   7. Haga clic en el nombre de su proyecto de Login en la pista de la ruta de navegación para volver a la página de navegación.
   8. Vaya al bloque Security y seleccione la sección JWT signature.
   9. Seleccione RS256 como el algoritmo de generación de firmas y pulse en Save changes.

2. En el lado del cliente de su aplicación, implemente la recepción y actualización de un token usando la llamada API Auth via access token of social network.

Obtener token con un ID personalizado

En el back-end de su aplicación, implemente un método para obtener y actualizar el token utilizando la llamada API Auth by custom ID. La solicitud debe contener el encabezado X-Server-Authorization: <server_JWT>, en el cual <server_JWT> es el JWT del servidor obtenido en el paso anterior.

Gestionar moneda virtual con llamadas API