Cómo obtener un token de pago

Para abrir la interfaz de pago, debe obtener un token. Un token es una cadena (string) que incluye datos cifrados sobre un juego y un usuario. Tiene que implementar la obtención de un token para identificar al usuario y permitir la compra.

Para obtener un token de pago:

1. Obtenga un token de autorización de usuario.
2. Cree un pedido.

Obtener token de autorización de usuario

El ciclo de vida del token es de 24 horas a partir de la última llamada a la API de Xsolla. Implemente la lógica de recepción de un nuevo token tras su expiración. Se recomienda obtener un nuevo token en segundo plano, para que el usuario no tenga que volver a iniciar sesión en la aplicación.

En el back-end de su aplicación, implemente la obtención de un token de autenticación de usuario. Para ello, utiliza una solicitud HTTP POST que incluya la autenticación HTTP básica y transmita los parámetros requeridos en el cuerpo de la solicitud.

Referencia de la API

Consulte la lista completa de parámetros.

Autenticación HTTP básica

La API de Xsolla usa la autenticación HTTP básica. Todas las solicitudes a la API debe contener el encabezado Authorization: Basic <your_authorization_basic_key>, en el cual <your_authorization_basic_key> es el par ID de comerciante:clave de API, codificado según el estándar Base64. Vaya a Cuenta del editor para localizar estos parámetros:

• Merchant ID se muestra:
  • en la sección Company settings > Company.
  • En la URL de la barra de direcciones del navegador de cualquier página de Cuenta del editor. La URL tiene el siguiente formato: https:​//publisher.xsolla.com/<merchant ID>/<Publisher Account section>.

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

Cuerpo de la solicitud

En el cuerpo de la solicitud, transmita los siguientes parámetros obligatorios:

Para mejorar la experiencia del usuario, también puede transmitir los siguientes parámetros:

curl -i -X POST \
  -u 2340:ZHgbSDVP6LtAJVWu \
  https://api.xsolla.com/merchant/v2/merchants/<merchant_id>/token \
  -H 'Content-Type: application/json' \
  -d '{
    "settings": {
      "currency": "USD",
      "language": "en",
      "project_id": <project_id>
      }
    },
    "user": {
      "email": {
        "value": "<user_email>"
      },
      "id": {
        "value": "<user_id>"
      },
      "name": {
        "value": "<user_name>"
      }
    }
  }'

Ejemplo de token de autenticación de usuario recibido en la respuesta

{
    "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
}

Obtener token de pago

En la respuesta, recibirá los datos que necesita para seguir trabajando:

• token - token de pago