SDK para Cocos Creator / Información general
  Volver a Documentos

SDK para Cocos Creator

Información general

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.

El SDK admite la compra de artículos del catálogo en 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 sólo 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.

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 hecho el pago, puede configurar dos tipos de redireccionamientos:

  • automático: un redireccionamiento con un tiempo de retardo establecido.
  • manual: un redireccionamiento después de que un usuario 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:

  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

Transmita los parámetros de redireccionamiento al método init. Para ello, añada las líneas en el código fuente de su proyecto en Cocos Creator de acuerdo con el ejemplo para la compilación de Android que aparece a continuación. Establezca los parámetros de redireccionamiento:

  1. En el parámetro useSettingsFromPublisherAccount transmita false.
  2. En el parámetro returnUrl, transmita una URL o una ruta a la que se redirigirá a 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:

  1. Para establecer parámetros de redireccionamiento automático:
    1. En el parámetro redirectCondition, transmita las condiciones cuando se active un redireccionamiento:
      • PaymentRedirectCondition.none: no redirigir.
      • PaymentRedirectCondition.successful: redirigir cuando se acepta un pago.
      • PaymentRedirectCondition.successful_or_canceled: redirige cuando un pago se realiza correctamente o se cancela.
      • PaymentRedirectCondition.any: redirige para cualquier estado de pago.
    2. En el parámetro redirectDelay, introduzca un tiempo de espera de redireccionamiento en segundos.

  1. Para establecer los parámetros de redireccionamiento manual:
    1. En el parámetro redirectStatusManual, introduzca un estado de pago cuando aparezca el botón de redireccionamiento:
      • PaymentRedirectCondition.none: no redirigir.
      • PaymentRedirectCondition.successful: redirigir cuando un pago se realice correctamente.
      • PaymentRedirectCondition.successful_or_canceled: redirige cuando un pago se realiza correctamente o se cancela.
      • PaymentRedirectCondition.any: redirige para cualquier estado de pago.
    2. En el parámetro redirectButtonCaption, introduzca el texto para el botón que redirige a un 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.

Ejemplo de configuración de redireccionamientos para una compilación de Android:

Copy
Full screen
Small screen
let redirectPolicySettingsAndroid: RedirectPolicySettings = {
                useSettingsFromPublisherAccount: false,
                returnUrl: 'app://xpayment.com.example.myapp',
                redirectCondition: PaymentRedirectCondition.successful,
                redirectDelay: 0,
                redirectStatusManual: PaymentRedirectStatusManual.successful,
                redirectButtonCaption: 'Back to the game'
        };
var settings: XsollaSettings = {
            loginId: '<yourLoginId>',
            projectId: '<yourProjectId>',
            clientId: '<yourClientId>',
            enableSandbox: IsSandbox,
            redirectPolicySettingsAndroid: redirectPolicySettingsAndroid
        }

        Xsolla.init(settings);
Nota
Puede establecer diferentes parámetros de redireccionamiento para diferentes plataformas de compilación para su aplicación. Para ello, utilice los parámetros:
  • redirectPolicySettingsAndroid
  • redirectPolicySettingsIOS
  • redirectPolicySettingsWebGL
¿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: 6 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!