Configuración de 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.

• 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:

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:

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.

2. 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.
3. 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.
4. En el campo Delay, introduzca un tiempo de espera de redireccionamiento en segundos. Por defecto, un redireccionamiento se activa en 0 segundos.
5. 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.
6. 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:

• en Cuenta del editor
• a través de la API

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.

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.

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:

{
    "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
                }
            ]
        }
    }
}