` es el token del usuario. El token identifica al usuario y proporciona acceso a datos personalizados.\nComo alternativa, puede utilizar un [token para abrir la interfaz de pago](/es/api/pay-station/token/create-token).\n\n2. **Modo simplificado sin encabezado \"Authorization\".** Este modo se utiliza solo para usuarios no autorizados y puede aplicarse solo para [ventas de claves de juego](/es/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). En lugar de un token, la solicitud debe incluir los siguientes encabezados:\n - `x-unauthorized-id` con un ID de solicitud\n - `x-user` con la dirección de correo electrónico del usuario codificada en Base64\n\n## Enlaces útiles\n\n- [Llamadas API por modelo de interacción](https://developers.xsolla.com/es/api/catalog/)\n- [Tipos de puntos finales](https://developers.xsolla.com/es/api/catalog/)\n- [Gestión de errores](https://developers.xsolla.com/es/api/catalog/)\n- [Claves de API](https://developers.xsolla.com/es/api/catalog/)\n\n# Estructura de la entidad principal\n\nLos artículos de todos los tipos (artículos virtuales, lotes, moneda virtual y claves) emplean una estructura de datos similar. Comprender la estructura básica simplifica el trabajo con la API y le ayuda a orientarse más fácilmente en la documentación.\n\nNota:
Algunas llamadas pueden incluir campos adicionales, pero no cambian la estructura básica.
\n\n**Identificación**\n\n- `merchant_id` — ID de la empresa en [Cuenta del editor](https://publisher.xsolla.com/)\n- `project_id` — ID del proyecto en Cuenta del editor\n- `sku` — SKU del artículo, único dentro del proyecto\n\n**Visualización en la tienda**\n\n- `name` — nombre del artículo\n- `description` — descripción del artículo\n- `image_url` — URL de la imagen\n- `is_enabled` — disponibilidad del artículo\n- `is_show_in_store` — si el artículo se muestra o no en el catálogo\n\nPara obtener más información sobre la gestión de la disponibilidad de artículos en el catálogo, consulte la [documentación](/es/items-catalog/catalog-features/items-availability/).\n\n**Organización**\n\n- `type` — tipo de artículo, p. ej., un artículo virtual (`virtual_item`) o lote (`bundle`)\n- `groups` — grupos a los que pertenece el artículo\n- `order` — orden de visualización en el catálogo\n\n**Condiciones de venta**\n\n- `prices` — precios en moneda real o virtual\n- `limits` — límites de compra\n- `periods` — periodos de disponibilidad\n- `regions` — restricciones regionales\n\n**Ejemplo de estructura de entidad principal:**\n\n```json\n{\n \"attributes\": [],\n \"bundle_type\": \"virtual_currency_package\",\n \"content\": [\n {\n \"description\": {\n \"en\": \"Main in-game currency\"\n },\n \"image_url\": \"https://.../image.png\",\n \"name\": {\n \"en\": \"Crystals\",\n \"de\": \"Kristalle\"\n },\n \"quantity\": 500,\n \"sku\": \"com.xsolla.crystal_2\",\n \"type\": \"virtual_currency\"\n }\n ],\n \"description\": {\n \"en\": \"Crystals x500\"\n },\n \"groups\": [],\n \"image_url\": \"https://.../image.png\",\n \"is_enabled\": true,\n \"is_free\": false,\n \"is_show_in_store\": true,\n \"limits\": {\n \"per_item\": null,\n \"per_user\": null,\n \"recurrent_schedule\": null\n },\n \"long_description\": null,\n \"media_list\": [],\n \"name\": {\n \"en\": \"Medium crystal pack\"\n },\n \"order\": 1,\n \"periods\": [\n {\n \"date_from\": null,\n \"date_until\": \"2020-08-11T20:00:00+03:00\"\n }\n ],\n \"prices\": [\n {\n \"amount\": 20,\n \"country_iso\": \"US\",\n \"currency\": \"USD\",\n \"is_default\": true,\n \"is_enabled\": true\n }\n ],\n \"regions\": [],\n \"sku\": \"com.xsolla.crystal_pack_2\",\n \"type\": \"bundle\",\n \"vc_prices\": []\n}\n```\n\n# Flujo de compra básico\n\nLa API de Xsolla le permite implementar la lógica de una tienda en el juego, incluyendo la recuperación del catálogo de artículos, la gestión de la cesta, la creación de pedidos y el seguimiento de su estado. Dependiendo del escenario de integración, las llamadas API se dividen en subsecciones de **Admin** y **Catálogo**, que usan diferentes [esquemas de autenticación](/es/api/catalog/section/authentication).\n\nEl siguiente ejemplo muestra un flujo básico para establecer y operar una tienda, desde la creación de artículos hasta la compra.\n\n## Crear artículos y grupos (Admin)\n\nCree un catálogo de artículos para su tienda, como artículos virtuales, lotes o moneda virtual.\n\nEjemplos de llamadas API:\n- [Crear artículo virtual](/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-item)\n- [Crear lote](/es/api/catalog/bundles-admin/admin-create-bundle)\n- [Crear moneda virtual](/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency)\n\n## Establecer promociones, cadenas y límites (Admin)\n\nConfigure herramientas de adquisición de usuarios y monetización, como descuentos, bonificaciones, recompensas diarias o cadenas de ofertas.\n\nEjemplos de llamadas API:\n- [Crear promoción de bonificación](/es/api/liveops/promotions-bonuses/create-bonus-promotion)\n- [Crear recompensa diaria](/es/api/liveops/daily-chain-admin/admin-create-daily-chain)\n- [Crear promoción de oferta única del catálogo](/es/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer)\n\n## Obtener información del artículo (cliente)\n\nConfigure la visualización de artículos en su aplicación.\n\n\n
Aviso:\n No utilice llamadas API de la subsección Admin para crear un catálogo de usuarios. Estas llamadas API tienen
límites de frecuencia y no están destinadas para el tráfico de usuarios.\n
\n\nEjemplos de llamadas a la API:\n- [Obtener lista de artículos virtuales](/es/api/catalog/virtual-items-currency-catalog/get-virtual-items)\n- [Obtener lista de grupos de artículos](/es/api/catalog/virtual-items-currency-catalog/get-item-groups)\n- [Obtener lista de lotes](/es/api/catalog/bundles-catalog/get-bundle-list)\n- [Obtener lista de artículos vendibles](/es/api/catalog/common-catalog/get-sellable-items)\n\n\n Nota:
\n Por defecto, las llamadas API del catálogo devuelven artículos que están actualmente disponibles en la tienda en el momento de la solicitud. Para recuperar artículos que aún no están disponibles o que ya no lo están, incluya el parámetro \"show_inactive_time_limited_items\": 1 en la solicitud del catálogo.\n
\n\n## Vender artículos\n\nPuede vender artículos utilizando los siguientes métodos:\n- Compra rápida: venda un código de artículo (SKU) varias veces.\n- Compra con cesta: el usuario añade artículos a la cesta, elimina artículos y actualiza cantidades dentro de un solo pedido.\n\nSi un artículo se compra utilizando moneda virtual en lugar de dinero real, utilice la llamada API [Crear pedido con artículo especificado comprado con moneda virtual](/es/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency). La interfaz de pago no es necesaria, ya que el cargo se procesa cuando se ejecuta la llamada API.\n\nPara la compra de artículos gratuitos, utilice la llamada API [Crear pedido con artículo gratuito especificado](/es/api/catalog/free-item/create-free-order-with-item) o la llamada API [Crear pedido con cesta gratuita](/es/api/catalog/free-item/create-free-order). La interfaz de pago no es necesaria: el pedido se establece inmediatamente con el estado done.\n\n### Compra rápida\n\nUtilice la llamada API del lado del cliente para [crear un pedido con un artículo especificado](/es/api/catalog/payment-client-side/create-order-with-item). La llamada devuelve un token utilizado para abrir la interfaz de pago.\n\n\n Nota:
\n La información de descuento está disponible para el usuario únicamente en la interfaz de pago. Los códigos promocionales no son compatibles.\n
\n\n### Compra con cesta\n\nLa configuración y compra de la cesta se puede realizar en el cliente o en el lado del servidor.\n\n**Configurar y comprar una cesta en el cliente**\n\nImplemente la lógica de añadir y eliminar artículos por usted mismo. Antes de llamar a la API para establecer una cesta, no tendrá información sobre qué promociones se aplicarán a la compra. Esto implica que el coste total y los detalles de los artículos de bonificación añadidos no se conocerán.\n\nImplemente la siguiente lógica de cesta:\n1. Después de que el jugador haya llenado una cesta, utilice la llamada API [Llenar la cesta con artículos](/es/api/shop-builder/operation/cart-fill/). La llamada devuelve la información actual sobre los artículos seleccionados (precios antes y después de descuentos y artículos de bonificación).\n2. Actualice el contenido de la cesta basándose en las acciones de los usuarios:\n - Para añadir un artículo o cambiar la cantidad del artículo, utilice la llamada API [Actualizar artículo de la cesta por ID de la cesta](/es/api/shop-builder/operation/put-item-by-cart-id/).\n - Para eliminar un artículo, utilice la llamada API [Eliminar artículo de la cesta por ID de la cesta](/es/api/shop-builder/operation/delete-item-by-cart-id/).\n\n\n Nota:
\n Para obtener el estado actual de la cesta, utilice la llamada API Obtener la cesta del usuario actual.\n
\n\n3. Utilice la llamada API [Crear pedido con todos los artículos de la cesta actual](/es/api/shop-builder/operation/create-order/). La llamada devuelve el ID del pedido y el token de pago. El pedido recién creado se establece por defecto con el estado new.\n\n**Configurar y comprar una cesta en el servidor**\n\nEsta opción de configuración puede requerir más tiempo para configurar la cesta, ya que cada modificación que se realice en ella debe ir acompañada de llamadas API.\n\nImplemente la siguiente lógica de cesta:\n1. Después de que el jugador haya llenado una cesta, utilice la llamada API [Llenar la cesta con artículos](/es/api/catalog/cart-server-side). La llamada devuelve la información actual sobre los artículos seleccionados (precios antes y después de descuentos, y artículos de bonificación).\n2. Utilice la llamada API [Crear pedido con todos los artículos de la cesta actual](/es/api/shop-builder/operation/create-order/). La llamada devuelve el ID del pedido y el token de pago. El pedido recién creado se establece por defecto con el estado new.\n\n## Abrir interfaz de pago\n\nUtilice el token devuelto para abrir la interfaz de pago en una nueva ventana. Otras formas de abrir la interfaz de pago se describen en la [documentación](/es/payment-ui-and-flow/payment-ui/how-to-open-payment-ui/#open_payment_ui).\n\n| Acción | Punto final |\n|:--------------------------------|:--------------------------------------------------------------------------|\n| Abrir en entorno de producción. | https://secure.xsolla.com/paystation4/?token={token} |\n| Abrir en modo sandbox. | https://sandbox-secure.xsolla.com/paystation4/?token={token} |\n\n\n
Nota:\n Utilice el modo sandbox durante el desarrollo y las pruebas. Las compras de prueba no hacen cargos en cuentas reales. Puede usar
tarjetas bancarias de prueba.\n\n Tras realizar el primer pago real, se aplica una política estricta de pagos en aislador de proceso (sandbox). Un pago en modo sandbox está disponible solo para los usuarios especificados en [Cuenta del Editor > Configuración de la empresa > Usuarios](https://publisher.xsolla.com/0/settings/users).\n\n Comprar moneda virtual y artículos con moneda real es posible solamente después de firmar un acuerdo de licencia con Xsolla. Para hacerlo, en [Cuenta del editor](https://publisher.xsolla.com/), vaya a **Acuerdos e impuestos > Acuerdos**, rellene el formulario de acuerdo y espere la confirmación. La revisión del acuerdo puede tardar hasta tres días laborables.\n