Modo de configuración de los redireccionamientos

Descripción general

Para redirigir a los usuarios a otra página después de finalizar el pago, puede configurar redireccionamientos en Cuenta del editor o mediante API. Para los 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 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

Si un usuario cierra la pestaña de la interfaz de pago antes de realizar el pago, se le redirige a la URL de redireccionamiento especificada con el formato de: {Return URL}?user_id=[value]&invoice_id=. Si la interfaz de pago se abre con Pay Station Embed, al cerrar la interfaz de pago, el widget se cierra y el usuario vuelve al juego.

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 Payments > Payment interface > General settings.
    2. Vaya a la sección Redirect policy.
    1. En el campo Return URL introduzca una dirección URL o una ruta (un enlace profundo) a la que se redirigirá al usuario tras efectuar un pago. Para mejorar la experiencia cuando un usuario abre la interfaz de pago en una aplicación móvil de juegos, le recomendamos especificar un enlace profundo como URL de retorno.
    2. En la lista desplegable, seleccione Automatic redirect condition:
      • None — do not redirect.
      • Successful payment — redirect when a payment is successful.
      • Successful or canceled payment — redirect when a payment is successful or canceled.
      • Any payment — redirect for any payment status.
    3. En el campo Delay, introduzca un tiempo de espera para la redirección en segundos. Por defecto, la redirección se activa en 0 segundos.
    4. Si quiere configurar solo la redirección automática sin añadir un botón de redirección, en la lista desplegable Manual redirect condition, elija None — do not redirect.
    5. Haga clic en Save changes.

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

    Nota
    Si prefiere especificar distintas URL de redireccionamiento, p. ej., para distintas plataformas, tendrá que crear un token específico para cada caso concreto.

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

    ParámetroDescripción
    settings.return_urlUna dirección URL o una ruta (un enlace profundo) a la que se redirigirá al usuario tras efectuar un pago. Para mejorar la experiencia cuando un usuario abre la interfaz de pago en una aplicación móvil, le recomendamos especificar un enlace profundo como URL de retorno.
    settings.redirect_policy.redirect_conditionsCondiciones de redirección:
    • none: no redirigir.
    • successful: redirigir cuando se realiza un pago correctamente.
    • successful_or_canceled: redirigir cuando se realiza o se cancela un pago.
    • any: redirigir para cualquier estado de pago.
    settings.redirect_policy.delayUn tiempo de espera en segundos cuando se activa una redirección a la URL transmitida en el parámetro settings.return_url. Por defecto, la redirección 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 Payments > Payment interface > General settings.
    2. Vaya a la sección Redirect policy.
    1. En el campo Return URL introduzca una dirección URL o una ruta (un enlace profundo) a la que se redirigirá al usuario tras efectuar un pago. Para mejorar la experiencia cuando un usuario abre la interfaz de pago en una aplicación móvil de juegos, le recomendamos especificar un enlace profundo como URL de retorno.
    2. Si quiere configurar solo la redirección manual, en la lista desplegable Automatic redirect condition, elija None — do not redirect.
    3. Deje el campo Delay vacío.
    4. En la lista desplegable Manual redirect condition, elija un estado de pago para cuando aparezca el botón de redirección:
      • None — do not redirect.
      • Successful payment — redirect when a payment is successful.
      • Successful or canceled payment — redirect when a payment is successful or canceled.
      • Any payment — redirect for any payment status.
    5. En el campo Redirect button caption, introduzca el texto del botón que redirigirá al usuario a la URL de retorno.
    6. Haga clic en Save changes.
    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

    Nota
    Si prefiere especificar distintas URL de redireccionamiento, p. ej., para distintas plataformas, tendrá que crear un token específico para cada caso concreto.

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

    ParámetroDescripción
    settings.return_urlUna dirección URL o una ruta (un enlace profundo) a la que se redirigirá al usuario tras efectuar un pago. Para mejorar la experiencia cuando un usuario abre la interfaz de pago en una aplicación móvil, le recomendamos especificar un enlace profundo como URL de retorno.
    settings.redirect_policy.manual_redirection_actionEl comportamiento de la interfaz de pago que se activa cuando el usuario hace clic en el botón para cerrar o en el botón de retorno:
    • redirect (por defecto): se redirige al usuario a la URL de retorno.
    • postmessage: al hacer clic en el icono para cerrar se inicia el envío del evento close, y al hacer clic en el botón de retorno, el evento return. En este caso, no se redirige al usuario a la URL de retorno. Debe configurar el procesamiento de eventos para cerrar la interfaz de pago o la redirección. Esta configuración solo está disponible cuando se utiliza la API.
    settings.redirect_policy.redirect_button_captionEl texto del botón que redirigirá al usuario a la URL de retorno.
    settings.redirect_policy.status_for_manual_redirectionEstado del pago cuando aparece el botón de redirección:
    • none: no redirigir.
    • successful: redirigir cuando se realiza un pago correctamente.
    • successful_or_canceled: redirigir cuando se realiza o se cancela un pago.
    • 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
     1{
     2    "user": {
     3        "country": {
     4            "value": "US"
     5        },
     6        "id": {
     7            "value": "1234abCd"
     8        },
     9        "name": {
    10            "value": "John Smith"
    11        }
    12    },
    13    "settings": {
    14        "currency": "USD",
    15        "project_id": 123456,
    16        "language": "en",
    17        "return_url": "myapp://payment/successful",
    18        "ui": {
    19            "desktop": {
    20                "header": {
    21                    "visible_logo": true
    22                }
    23            }
    24        },
    25        "redirect_policy": {
    26            "redirect_conditions": "any",
    27            "redirect_button_caption": "Back to Store",
    28            "manual_redirection_action": "redirect",
    29            "status_for_manual_redirection": "any"
    30        },
    31        "external_id": "1a2b3c"
    32    },
    33    "custom_parameters": {
    34        "timestamp": 1234512345123,
    35        "sku": "testSKU",
    36        "amount": "10"
    37    },
    38    "purchase": {
    39        "virtual_items": {
    40            "items": [
    41                {
    42                    "sku": "testSKU",
    43                    "amount": 1
    44                }
    45            ]
    46        }
    47    }
    48}
    
    ¿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.
    Última actualización: 5 de Noviembre de 2025

    ¿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!
    No hemos podido enviar sus comentarios
    Vuelva a intentarlo más tarde o escríbanos a doc_feedback@xsolla.com.