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:
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.
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
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ámetro | Tipo | Descripción |
|---|---|---|
user.id | string | ID único de usuario en su sistema. |
user.email | string | Correo 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 | integer | ID 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ámetro | Tipo | Descripción |
|---|---|---|
user.name | string | Nombre de pantalla del usuario que aparece en los recibos. |
settings.currency | string | Moneda de pago preferida. |
settings.language | string | Idioma de la interfaz. |
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
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:
- 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. - En el bloque
Security , en el campoBearer Token , introduzca el token obtenido al transmitir el procedimiento de autenticación. - 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. - 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).
En la respuesta, recibirá los datos que necesita para seguir trabajando:
token- token de pago
¿Te ha resultado útil este artículo?
Valore esta página
Prefiero no responder
¡Gracias por tu mensaje!
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.
