Payments / Personalización del tema de la interfaz de pago

Personalización del tema de la interfaz de pago

Cómo funciona

Hay dos temas disponibles por defecto para la interfaz de pago: claro y oscuro. Para alternar entre estos temas sin utilizar el personalizador, introduzca 63295a9a2e47fab76f7708e1 para el tema claro o 63295aab2e47fab76f7708e3 para el tema oscuro en el parámetro settings.ui.theme cuando reciba el token.

Para adaptar la interfaz de pago al diseño del juego, puede crear un tema personalizado y configurar las siguientes características:

Puede utilizar un tema personalizado como tema predeterminado para todos sus proyectos en la Cuenta del editor. Si desea especificar diferentes temas para juegos individuales, introduzca estos ajustes en el token.

Aviso
Las configuraciones de tema transmitidas en el token gozan de prioridad sobre las configuraciones especificadas en Cuenta del editor.
Nota
Para que el logotipo y los botones de Xsolla se visualicen correctamente al elegir un método de pago, consulte las directrices.

Configurar la personalización en Cuenta del editor

Nota
Puede crear un tema personalizado en un proyecto y utilizarlo en todos los proyectos de esta Cuenta del editor.
  1. Abra su proyecto en Cuenta del editor y vaya a la sección Pay Station > UI theme.
  1. Haga clic en Create new theme.
  2. Haga clic en el icono del lápiz para cambiar el nombre del tema.
  1. Para cambiar los colores de los elementos de la interfaz, vaya a la pestaña Colors. Puede cambiar la paleta de colores de las superficies, los textos y los controles, así como los colores que aparecen en las notificaciones de estado.
  1. Para establecer el tamaño de la fuente, vaya a la pestaña Typography. Utilice los campos correspondientes para cambiar el tamaño de fuente de los siguientes elementos de la interfaz de usuario:
CampoElemento de interfaz
Title 1Encabezado de la página de estado del pago.
Title 2Valor del importe total.
Title 3Encabezados de sección (p. ej., Pago con tarjeta).
Title 4Actualmente no se utiliza.
Cuerpo L
  • encabezados de subsección
  • encabezados en instrucciones para pagos en efectivo
  • texto del botón
  • Total
Cuerpo M
  • nombre del proyecto (se muestra cuando no hay logotipo del proyecto)
  • texto en tooltips y descripciones
  • mensaje en la página de estado del pago
  • texto en la lista de métodos de pago (la lista desplegable de la versión móvil)
Texto menor
  • nombre de usuario
  • textos legales
  • información en la cesta (p. ej., el nombre de un artículo, el importe del IVA)
EncabezadoActualmente no se utiliza.
  1. Para configurar el ancho del borde y el radio de las esquinas de los elementos de la interfaz, vaya a la pestaña Borders y realice los cambios.
Nota
Ancho máximo del borde: 3 px
Radio máximo de la esquina: 16 px
  1. Para ver cómo se ve el logotipo del juego en la interfaz de pago, en la sección Preview, marque la casilla Show logo. Para configurar la visualización de un logotipo del juego en la interfaz de pago, introduzca los parámetros necesarios en el token.
  1. Para ver cómo aparece un tema en las versiones móvil y de escritorio de la interfaz de pago, alterne entre pestañas en la sección Preview.
Aviso
Los botones y enlaces no funcionan en el modo de vista previa.
  1. Para ver diferentes estados de la interfaz de pago, alterne entre las pestañas Payment by card, Payment methods y Payment status.
  1. Haga clic en Publish.
  2. Para aplicar este tema a todos sus proyectos en la Cuenta del editor, establezca el conmutador Set as default en On en la ventana modal que se abre. No afectará a los proyectos en los que el tema se haya introducido en el token.
  3. Haga clic en Publish.
Aviso
Cuando el tema esté publicado, puede editarlo en cualquier momento. El tema no se aplica a la interfaz de pago a menos que lo establezca como tema predeterminado o lo active mediante la configuración de tókenes.
En la pestaña UI theme, al hacer clic en ••• en el bloque de un tema concreto, están disponibles las siguientes acciones rápidas:
  • Customize: abre el personalizador para realizar cambios.
  • Edit: cambiar el nombre de un tema y establecer el conmutador Set as default en On u Off.
  • Duplicate: duplica un tema para crear uno nuevo basado en él.
  • Delete theme.

Configurar la personalización mediante API

Cambiar la disposición visual

Puede cambiar la disposición visual de la interfaz de pago para adaptarla a la interfaz de su juego. Para ello, transmita el parámetro settings.ui.layout cuando cree un token. Este parámetro puede tener los siguientes valores:
  • embed - en este caso, la interfaz de pago se abre dentro de su juego: el relleno de la interfaz de pago se recorta en los bordes para ajustarse a otros elementos de la interfaz.
  • column_reverse - en este caso, el orden de las columnas en la interfaz de pago cambia: la información sobre los métodos de pago se visualiza en la parte izquierda y la información sobre un pedido, en la parte derecha.
  • embed_column_reverse - en este caso, la interfaz de pago se abre dentro de su juego y el orden de las columnas en la interfaz de pago cambia: la información sobre los métodos de pago se muestra en el lado izquierdo, y la información sobre un pedido en el lado derecho.

Configurar la visualización de los métodos de pago

Para configurar el modo en que se muestran los métodos de pago al abrir la interfaz de pago, puede transmitir los siguientes parámetros en el token:
  • is_payment_methods_list_mode le permite mostrar la lista de métodos de pago disponibles en el país del usuario al abrir la interfaz de pago.
  • settings.ui.gp_quick_payment_button le permite configurar la visualización del método de pago Google Pay en la interfaz de pago. Este parámetro puede tener los siguientes valores:
    • true - en este caso, el botón de pago rápido mediante Google Pay aparece en la parte superior de la interfaz de pago.
    • false (por defecto) - en este caso, Google Pay se muestra en la lista de métodos de pago conforme al algoritmo PayRank.

Transmitir la configuración del tema personalizado de la interfaz de usuario en el token

Para aplicar los ajustes personalizados a un juego concreto, transmite el ID del tema personalizado publicado en el parámetro settings.ui.theme al crear el token.

Puedes encontrar el ID del tema:

  • En la lista de todos los temas en la pestaña UI theme.

  • En el personalizador, con el nombre del tema.
Aviso
Las configuraciones de tema transmitidas en el token gozan de prioridad sobre las configuraciones especificadas en Cuenta del editor.

Para mostrar un logotipo de su juego en la interfaz de pago:

  1. Abra su proyecto en Cuenta del editor y suba una imagen en la sección Pay Station > Settings.

Nota
Tamaño máximo del archivo: 1 MB.
Formatos admitidos: JPEG, PNG y SVG.

  1. En la solicitud para crear un token, transmita true en los parámetros settings.ui.desktop.header.is_visible y settings.ui.desktop.header.visible_logo. En función de su escenario de integración, puede invocar el método del lado del servidor o el del lado del cliente para crear un token.

Ejemplo de visualización del logotipo de un juego en la interfaz de pago:

¿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: 3 de Octubre 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!