Kits SDK para Unity / Información general
  Volver a Documentos

Kits SDK para Unity

Información general

El SDK admite la compra de artículos del catálogo con un solo clic o mediante la cesta de la compra.

Para probar el proceso de compra, puede utilizar el modo de aislador de proceso (sandbox) de la interfaz de pago y las tarjetas de prueba. El modo sandbox solamente simula el comportamiento de un método de pago; no hay dinero real involucrado. Para probar sandbox, no necesita firmar ningún acuerdo con Xsolla ni pagar ninguna cuota.

Aviso
Después de realizar el primer pago real, entra en vigor una estricta política de pagos en modo sandbox. Los pagos realizados en modo sandbox solo están disponibles para los usuarios especificados en Cuenta del editor en la sección Company settings > Users.

La interfaz de pago se basa en el producto Pay Station. La elección de los métodos de pago disponibles y otros ajustes están disponibles en Cuenta del editor en la sección Pay Station.

La forma de abrir la interfaz de pago depende de la plataforma para la que se haya creado su aplicación:

  • Para aplicaciones de escritorio, el SDK permite abrir la interfaz de pago en el navegador integrado.
  • Para aplicaciones móviles, la interfaz de pago se abre en un navegador externo.
  • Para WebGL, el widget de la interfaz de pago se abre en un iframe en la misma página del navegador.

Si abre la interfaz de pago en una WebView en su aplicación móvil, agregue el icono para que el usuario pueda cerrar la interfaz de pago en cualquier fase de la compra. Para ello, utilice el parámetro close_button en las instancias de la clase PurchaseParams cuando llame al método del SDK XsollaCatalog.Purchase o XsollaCart.Purchase.

Ejemplo de uso del parámetro close_button en WebView:

Instrucciones

Conozca más sobre las configuraciones avanzadas en nuestros procedimientos.

Cómo configurar el redireccionamiento del usuario a su aplicación tras el pago

Para redirigir a los usuarios a otra página después de que hayan realizado el pago, puede configurar dos tipos de redireccionamientos:

  • automático - un redireccionamiento con un tiempo de retraso establecido.
  • manual - un redireccionamiento después de que un usuario cierre la interfaz de pago o pulse el botón de redireccionamiento.

Puede configurar un redireccionamiento de las siguientes formas:

  • en la Cuenta del editor: use esta opción si está configurando un proyecto para una única aplicación y no prevé crear compilaciones para diferentes plataformas.

  • en la configuración del SDK: utilice esta opción si prevé:
    • utilizar el proyecto para varias aplicaciones
    • crear compilaciones para distintas plataformas
    • vender artículos del juego a través del sitio web.
Aviso
Si los redireccionamientos están configurados en la Cuenta del editor y en la configuración del SDK, se utilizan los parámetros especificados en la configuración del SDK.

Configurar redireccionamientos en la Cuenta del editor

  1. Abra su proyecto en Cuenta del editor.
  2. Pulse en Pay Station en el menú lateral.
  3. Vaya a la sección Settings > Redirect policy.
  1. En el campo Return URL, introduzca la URL o ruta a la que es redirigido un usuario después de realizar un pago.
Nota

Para redirigir a los usuarios a una aplicación móvil, la URL debe coincidir con uno de los siguientes esquemas:

Puede encontrar el valor <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> en la configuración del proyecto de Unity (Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

  1. Para configurar los parámetros de redireccionamiento automático:
    1. En la lista desplegable, elija Automatic redirect condition:
      • None — do not redirect.
      • Successful payment - redirigir cuando un pago se realiza con éxito.
      • Successful or canceled payment - redirige cuando un pago se realiza correctamente o se cancela.
      • Any payment - redirige para cualquier estado de pago.
    2. En el campo Delay, introduzca un tiempo de espera de redireccionamiento en segundos. Por defecto, un redireccionamiento se activa en 0 segundos.

  1. Para establecer los parámetros de redireccionamiento manual:
    1. En la lista desplegable, elija Manual redirect condition:
      • None — do not redirect.
      • Successful payment - el botón de redireccionamiento aparece cuando un pago se realiza correctamente.
      • Successful or canceled payment - el botón de redireccionamiento aparece cuando un pago se realiza correctamente o se cancela.
      • Any payment - el botón de redireccionamiento aparece para cualquier estado de pago.
    2. En el campo Redirect button caption, introduzca el texto del botón que redirige al usuario a la URL de retorno.
Aviso

Por defecto, el texto del botón de redireccionamiento es Volver al juego. Está traducido a todos los idiomas de Pay Station.

Si su proyecto admite varios idiomas, puede especificar el texto del botón de redireccionamiento para cada uno de ellos en los respectivos campos.

Cuando un usuario cierra la interfaz de pago, también se le redirige a la URL de retorno especificada.

  1. Haga clic en Save.

Configurar redireccionamientos en los ajustes del SDK

  1. Abra su proyecto de Unity.
  2. Haga clic en Window > Xsolla > Edit Settings en el menú principal.
  3. Abra el panel Inspector y vaya a la sección Pay Station > Redirect Policy.
  4. Vaya a la sección correspondiente a la plataforma de compilación de su aplicación (Desktop, WebGL, Android o iOS) y especifique los parámetros de redireccionamiento:

    1. Desmarque la casilla Use setting from Publisher Account.
    2. En el campo Return URL, introduzca una URL o una ruta a la que se redirigirá al usuario después de realizar un pago.
Nota

Para redirigir a los usuarios a una aplicación móvil, la URL debe coincidir con uno de los siguientes esquemas:

Puede encontrar el valor <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> en la configuración del proyecto de Unity (Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

    1. Para establecer los parámetros de redireccionamiento automático:
      1. En la lista desplegable, elija Redirect Conditions:
        • None - no redirigir.
        • Successful payment - redirigir cuando un pago se realiza con éxito.
        • Successful or canceled payment - redirige cuando un pago se realiza correctamente o se cancela.
        • Any payment - redirige para cualquier estado de pago.
      2. En el campo Redirect Timeout, introduzca un tiempo de espera de redireccionamiento en segundos.

    1. Para establecer los parámetros de redireccionamiento manual:
      1. En la lista desplegable, elija Status for Manual Redirection:
        • None - no redirigir.
        • Successful payment - el botón de redireccionamiento aparece cuando un pago se realiza correctamente.
        • Successful or canceled payment - el botón de redireccionamiento aparece cuando un pago se realiza correctamente o se cancela.
        • Any payment - el botón de redireccionamiento aparece para cualquier estado de pago.
      2. En el campo Redirect Button Caption, introduzca el texto del botón que redirige al usuario a la URL de retorno.
Aviso

Por defecto, el texto del botón de redireccionamiento es Volver al juego. Está traducido a todos los idiomas de Pay Station.

Si su proyecto admite varios idiomas, puede especificar el texto del botón de redireccionamiento para cada uno de ellos en los respectivos campos.

Cuando un usuario cierra la interfaz de pago, también se le redirige a la URL de retorno especificada.

¿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.
Ocultar

Seguir leyendo

Última actualización: 26 de Abril 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!