Modo de configuración de los redireccionamientos

Descripción general

Para redirigir a los usuarios a otra página después de realizar el pago, puede configurar redireccionamientos en Cuenta del editor o mediante API. Para diferentes estados de pago (pago aceptado o cancelado), puede configurar los siguientes redireccionamientos:

  • automatic: un redireccionamiento en un tiempo de retardo definido.
  • manual: un redireccionamiento después de que el usuario cierre la interfaz de pago o pulse en el botón de redireccionamiento.

Puede configurar simultáneamente redireccionamientos automáticos y manuales. Un usuario seguirá teniendo la opción de pulsar en el botón de redireccionamiento para regresar a la aplicación. Si no lo hace, será redirigido automáticamente cuando termine el tiempo de retardo definido.

Aviso
Limitaciones:
  • Las configuraciones de redireccionamiento transmitidas mediante API tienen prioridad sobre las definidas en Cuenta del editor.
  • Las configuraciones de redireccionamiento automático tienen prioridad sobre las definidas para los redireccionamientos manuales. Por ejemplo, si ambos, el redireccionamiento manual y el redireccionamiento automático, con el tiempo de retardo de 0 segundos, se configuran para los pagos aceptados, se ejecutará el redireccionamiento automático.
Los siguientes parámetros GET se agregan automáticamente a la URL a la que se redirige a un usuario:
  • user_id - ID de usuario
  • foreigninvoice - ID de transacción transmitido en el parámetro external_id
  • invoice_id - ID de la transacción
  • status - estado de la transacción. Puede tener los siguientes valores:
Estado de la transacciónDescripción
doneEl pago se efectuó correctamente.
invoiceSe generó la factura correspondiente al pago.
deliveringEl pago se está procesando en el lado de Xsolla.
troubledSe produjo un error al procesar el pago o durante el proceso de reembolso.
full_changeEl pago se realizó con saldo de Xsolla.
Ejemplo de URL a la que se redirige a un usuario: {Return URL}?user_id=[value]&foreignInvoice=[value]&invoice_id=[value]&status=done

Configurar redireccionamientos automáticos

Puede configurar redireccionamientos automáticos:

  • en Cuenta del editor
  • a través de la API
  • Configurar redireccionamientos automáticos en la Cuenta del editor

    1. Abra su proyecto en Cuenta del editor y vaya a Pay Station > Settings > Redirect policy.
    1. En el campo Return URL, introduzca una dirección URL o una ruta (un vínculo profundo) a la que se redirija a un usuario tras hacer un pago. Para mejorar la experiencia del usuario cuando abre la interfaz de pago en una aplicación móvil de juego, recomendamos especificar un vínculo profundo como URL de retorno.
    2. En la lista desplegable, elija Automatic redirect condition:
      • None — do not redirect.
      • Successful payment - redirige 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.
    3. En el campo Delay, introduzca un tiempo de espera de redireccionamiento en segundos. Por defecto, un redireccionamiento se activa en 0 segundos.
    4. Si solo desea configurar el redireccionamiento automático sin agregar un botón de redireccionamiento, en la lista desplegable Manual redirect condition, elija None — do not redirect.
    5. Pulse en Save.

    Configurar redireccionamientos automáticos a través de la API

    Para configurar los redireccionamientos, transmita los siguientes datos en la llamada API Crear token:

    • settings.return_url - Una dirección URL o una ruta (un vínculo profundo) a la que se redirige a un usuario tras hacer un pago. Para mejorar la experiencia del usuario cuando abre la interfaz de pago en una aplicación móvil de juego, recomendamos especificar un vínculo profundo como URL de retorno.
    • settings.redirect_policy.redirect_conditions - condiciones de redireccionamiento:
      • none - no redirigir.
      • successful - redirigir cuando un pago se realiza correctamente.
      • successful_or_canceled - redirige cuando un pago se realiza correctamente o se cancela.
      • any - redirige para cualquier estado del pago.
    • settings.redirect_policy.delay - un tiempo de espera en segundos cuando se activa un redireccionamiento a la URL transmitida en el parámetro settings.return_url. Por defecto, un redireccionamiento se activa en 0 segundos.

    Configurar redireccionamientos manuales

    Puede configurar redireccionamientos automáticos:

    Aviso
    Los ajustes de redireccionamiento transmitidos a través de la API tienen prioridad sobre los establecidos en la Cuenta del editor.

    Configurar redireccionamientos manuales en la Cuenta del editor

    1. Abra su proyecto en Cuenta del editor y vaya a Pay Station > Settings > Redirect policy.
    1. En el campo Return URL introduzca una dirección URL o una ruta (un vínculo profundo) a la que se redirija a un usuario tras hacer un pago. Para mejorar la experiencia del usuario cuando abre la interfaz de pago en una aplicación móvil de juego, recomendamos especificar un vínculo profundo como URL de retorno.
    2. Si desea configurar solo el redireccionamiento manual, en la lista desplegable Automatic redirect condition, elija None — do not redirect.
    3. Deje vacío el campo Delay.
    4. En la lista desplegable Manual redirect condition, elija un estado de pago cuando aparezca el botón de redireccionamiento:
      • None — do not redirect.
      • Successful payment — redirigir cuando se realice un pago correctamente.
      • Successful or canceled payment — redirigir cuando un pago se realice correctamente o se cancele.
      • Any payment — redirigir para cualquier estado de pago.
    5. En el campo Redirect button caption, introduzca el texto del botón que redirigirá al usuario a la URL de retorno.
    6. Pulse Save.
    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 introducir el texto del botón de redireccionamiento para cada uno de ellos en los campos respectivos.

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

    Configurar redireccionamientos manuales a través de la API

    Para configurar los redireccionamientos, transmita los siguientes datos en la llamada API Crear token:

    • settings.return_url: una dirección URL o una ruta (un vínculo profundo) a la que se redirige a un usuario tras hacer un pago. Para mejorar la experiencia de usuario cuando un usuario abre la interfaz de pago en una aplicación móvil de juego, recomendamos especificar un vínculo profundo como URL de retorno.
    • settings.redirect_policy.manual_redirection_action - el comportamiento de la interfaz de pago que se desencadena cuando el usuario pulsa en el botón de cierre o en el botón de retorno:
      • redirect (por defecto) - a un usuario se le redirige a la URL de retorno.
      • postmessage - al pulsar en el icono de cierre se inicia el envío del evento close-widget, y al pulsar en el botón de retorno - el evento return. En este caso, al usuario no se le redirige a la URL de retorno. Debe configurar el procesamiento de eventos para cerrar la interfaz de pago o redireccionamiento. Este ajuste solo está disponible cuando se usa la API.
    • settings.redirect_policy.redirect_button_caption - un texto para el botón que redirigirá a un usuario a la URL de retorno.
    • settings.redirect_policy.status_for_manual_redirection - un estado de pago cuando aparece el botón de redireccionamiento:
      • none - no redirigir.
      • successful - redirigir cuando un pago se realiza correctamente.
      • successful_or_canceled - redirigir cuando un pago es aceptado o se cancela.
      • any - redirigir para cualquier estado de pago.

    Aviso
    Si la interfaz de pago se abre en un iframe y el parámetro settings.ui.desktop.header.close_button está establecido como true, solo se envía el evento postmessage cuando un usuario pulsa en el icono de cierre. Permite procesar el evento y cerrar la interfaz de pago, y un usuario puede permanecer en la página desde la que se inició el pago.

    Ejemplo de configuración de redireccionamiento

    En Cuenta del editor, configuró redireccionamientos automáticos con un retardo de 3 segundos. Este comportamiento se aplica tanto a la versión móvil como a la versión de escritorio de la interfaz de pago. Las configuraciones definidas en Cuenta del editor tienen este aspecto:

    Si necesita actualizar los ajustes para abrir la interfaz de pago en la aplicación móvil de su juego; es decir, agregar el botón de redireccionamiento y especificar un vínculo profundo como URL de retorno, tendrá que actualizar los ajustes transmitidos en un token:

    ParámetroValor
    settings.return_urlUn vínculo profundo que redirige al usuario a una aplicación de juego.
    settings.redirect_policy.redirect_conditionsany
    settings.redirect_policy.manual_redirection_actionredirect
    settings.redirect_policy.redirect_button_captionIntroduzca el texto del botón de redireccionamiento
    Una solicitud para obtener un token deberá tener el siguiente aspecto:
    Copy
    Full screen
    Small screen
      {
          "user": {
              "country": {
                  "value": "US"
              },
              "id": {
                  "value": "1234abCd"
              },
              "name": {
                  "value": "John Smith"
              }
          },
          "settings": {
              "currency": "USD",
              "project_id": 123456,
              "language": "en",
              "return_url": "myapp://payment/successful",
              "ui": {
                  "desktop": {
                      "header": {
                          "visible_logo": true
                      }
                  }
              },
              "redirect_policy": {
                  "redirect_conditions": "any",
                  "redirect_button_caption": "Back to Store",
                  "manual_redirection_action": "redirect",
                  "status_for_manual_redirection": "any"
              },
              "external_id": "1a2b3c"
          },
          "custom_parameters": {
              "timestamp": 1234512345123,
              "sku": "testSKU",
              "amount": "10"
          },
          "purchase": {
              "virtual_items": {
                  "items": [
                      {
                          "sku": "testSKU",
                          "amount": 1
                      }
                  ]
              }
          }
      }
      
      ¿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!