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 14 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 Project settings > Webhooks.
    • En la sección Company settings > Company.
    • En la URL de la barra de direcciones del navegador de cualquier página de la Cuenta del editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/​merchant ID/Sección de Cuenta del editor`.

  • 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
Aviso

Para obtener más información sobre cómo trabajar con claves API, consulte la Referencia de la API.

Recomendaciones clave:

  • Guarde la clave de API generada en su servidor. Puede ver la clave de API en la Cuenta del editor solo una vez cuando se crea.
  • Mantenga su clave de API en secreto. Proporciona acceso a su cuenta personal y a sus proyectos en Cuenta del editor.
  • La clave de API debe almacenarse en su servidor y nunca en archivos binarios o en el front-end.

Cuerpo de la solicitud

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

ParámetroTipoDescripción
user.id
stringID único de usuario en su sistema.
user.email
stringCorreo electrónico del usuario para enviar recibos de compra. Si no se transmite el parámetro, en la página de pago aparece un campo obligatorio para introducir un correo electrónico.
settings.project_id
integerID del juego en Xsolla. Puede encontrar esta información en la sección de su proyecto en Cuenta del editor.

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

ParámetroTipoDescripción
user.name
stringNombre de pantalla del usuario que aparece en los recibos.
settings.currency
stringMoneda de pago preferida.
settings.language
stringIdioma de la interfaz.
Ejemplo de solicitud para obtener un token de autenticación de usuario
Copy
Full screen
Small screen
    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

    Copy
    Full screen
    Small screen
      {
          "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
      }
      

      Obtener token de pago

      Para obtener un token de pago, cree un pedido. Un pedido es un artículo que un usuario quiere comprar en la tienda. Tras pagar el pedido, el usuario recibe el artículo. Para probar el flujo de pago, cree un pedido usando la llamada API Create order with specified item:

      1. Si desea realizar una prueba en el sitio web de documentación de la API, haga clic en Try it para abrir la interfaz y crear una solicitud.
      2. En el bloque Security, en el campo Bearer Token, introduzca el token obtenido al transmitir el procedimiento de autenticación.
      3. En el bloque Body, transmita los detalles del pedido, p. ej., la cantidad de artículos. Para acceder al modo aislador de proceso (sandbox), introduzca "sandbox": true.
      4. En el bloque Parameters, transmita:
        • project_id - ID de proyecto que puede encontrar en Cuenta del editor.
        • item_sku - código de artículo (SKU).
      Nota
      Para llamar a la API de Xsolla, puede utilizar los métodos del SDK prediseñados para motores y plataformas de juegos:

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

      • token - token de pago

      ¿Te ha resultado útil este artículo?
      ¡Gracias!
      ¿Hay algo en lo que podamos mejorar? Mensaje
      Lo sentimos
      Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
      ¡Gracias por tu mensaje!
      Nos ayudará a mejorar tu experiencia.
      Valore esta página
      Valore esta página
      ¿Hay algo en lo que podamos mejorar?

      Prefiero no responder

      ¡Gracias por tu mensaje!
      Última actualización: 26 de Marzo de 2024

      ¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

      Informar de un problema
      Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
      Déjanos tu correo electrónico para que te podamos responder
      ¡Gracias por tu mensaje!