Cómo abrir la interfaz de pago

Nota

Antes de firmar un contrato con Xsolla, probar su proceso de pago solo está disponible en modo aislador de proceso (Sandbox). Si se produce cualquier error, vea sus descripciones.

Para abrir la interfaz de pago en el modo de aislador de proceso (Sandbox), use la siguiente URL: https://sandbox-secure.xsolla.com/paystation4/?token=ACCESS_TOKEN, en la cual ACCESS_TOKEN es el token obtenido en el paso previo.

Nueva ventana

Para abrir la interfaz de pago en una nueva ventana, use la siguiente URL: https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN, en la cual TOKEN es el token obtenido.

Nota
Utilice el enlace anterior para abrir la interfaz de pago en modo sandbox. Tras el lanzamiento del proyecto, utilice esta URL https://secure.xsolla.com/paystation4/?token=TOKEN.
También puede abrir la interfaz de pago usando otras opciones:
  • Con Pay Station Embed. Limitación: puede haber problemas al abrirla en el navegador del juego (WebView).
  • Con iframe. Limitación: puede haber problemas al abrirla en el navegador del juego (WebView) y en la versión móvil de su aplicación.

Pay Station Embed

Aviso
Esta forma de abrir la interfaz de pago no permite vender claves del juego. Para vender claves del juego, siga las instrucciones.
EJEMPLO: CARGA ASINCRÓNICA DE SCRIPTS
Copy
Full screen
Small screen
<script>
   var options = {
       access_token: 'ACCESS_TOKEN', //TODO use access token, received on previous step
       sandbox: true //TODO please do not forget to remove this setting when going live
   };
   var s = document.createElement('script');
   s.type = "text/javascript";
   s.async = true;
   s.src = "https://static.xsolla.com/embed/paystation/1.0.7/widget.min.js";
   s.addEventListener('load', function (e) {
       XPayStationWidget.init(options);
   }, false);
   var head = document.getElementsByTagName('head')[0];
   head.appendChild(s);
</script>

<button data-xpaystation-widget-open>Buy Credits</button>

Pay Station Embed permite obtener eventos de la interfaz de pago a través de postMessage. Puede enviar estos eventos a sistemas de análisis. Para configurar el procesamiento de eventos en su sistema analítico, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.

El equipo de Xsolla ha creado un widget que simplifica la integración de la interfaz de pago en su sitio web. El script del widget está disponible en nuestro repositorio de GitHub.

Parámetros de inicialización del script:

ParámetroTipoDescripción
access_token
stringToken, recibido a través de API. Obligatorio.
sandbox
booleanEstablécelo en true para probar el proceso de pago: sandbox-secure.xsolla.com se utilizará en lugar de secure.xsolla.com.
lightbox
objectParámetros del Lightbox (objeto, solo versión de escritorio).
payment_widget_ui.lightbox.width
stringAnchura del marco del Lightbox. Si es null, depende de la altura de Pay Station. Por defecto es null.
payment_widget_ui.lightbox.height
stringAltura del marco del Lightbox. Si es null, depende de la altura de Pay Station. Por defecto es 100%.
payment_widget_ui.lightbox.zIndex
integerDefine el orden de disposición. Por defecto es 1000.
payment_widget_ui.lightbox.overlayOpacity
integerOpacidad del fondo del widget (0 - totalmente transparente, 1 - totalmente opaco). El valor por defecto es 60 % (.6).
payment_widget_ui.lightbox.overlayBackground
stringColor de fondo de la superposición. Por defecto es #000000.
payment_widget_ui.lightbox.modal
booleanSi es true, el marco del Lightbox no se puede cerrar. Por defecto es false.
lightbox.closeByClick
booleanSi es true, al hacer clic en la superposición se cerrará el Lightbox. Por defecto es true.
lightbox.closeByKeyboard
booleanSi es true, al pulsar ESC se cerrará el Lightbox. Por defecto es true.
payment_widget_ui.lightbox.contentBackground
stringColor de fondo del marco. Por defecto es #ffffff. Tenga en cuenta que estos cambios de color no afectan al propio iframe de Pay Station, solo a la configuración del Lightbox que lo contiene.
payment_widget_ui.lightbox.contentMargin
stringMargen del marco. Por defecto es 10px.
payment_widget_ui.lightbox.spinner
stringTipo de indicador de carga animado. Puede ser xsolla o round. Por defecto es xsolla.
payment_widget_ui.lightbox.spinnerColor
stringColor del indicador giratorio. Sin valor por defecto.
childWindow
objectOpciones para la ventana secundaria que contiene la interfaz de usuario de Pay Station. Compatible con la versión móvil.
childWindow.target
stringDónde abrir la ventana de Pay Station. Puede ser _blank, _self, _parent. Por defecto es _blank.

El script permite realizar un seguimiento de los eventos de la interfaz de pago. En función del tipo de evento, puede realizar diversas acciones en la página web.

Lista de eventos:

ParámetroDescripción
initWidget inicializado.
openWidget abierto.
loadInterfaz de pago (Pay Station) cargada.
closeInterfaz de pago (Pay Station) cerrada.
statusEl usuario está en la página de estado.
status-invoiceEl usuario está en la página de estado; pago en curso.
status-deliveringEvento cuando el usuario se movió en la página de estado, el pago se finalizó, y estamos enviando la notificación de pago.
status-doneEl usuario está en la página de estado; pago abonado en la cuenta del usuario.
status-troubledEvento cuando el usuario se movió en la página de estado, pero el pago no se pudo procesar.
Si desea inicializar la apertura de la interfaz de pago, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token=TOKEN.
Nota
Es necesario utilizar el enlace con el prefijo https:// solamente para la apertura de la interfaz de pago.
Utilice la siguiente URL para hacer pruebas: https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN.
Aviso
El parámetro access_token contiene datos privados del usuario. Asegúrese de utilizar la comunicación de servidor a servidor al obtener este parámetro.

Iframe

Para abrir la interfaz de pago en un iframe:

  1. Implemente el mecanismo postMessage para recibir eventos de la interfaz de pago.
  2. Abra la interfaz de pago pulsando en el enlace https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN, en el cual TOKEN es el token recibido.

Problema potencial: si no aparece un botón para copiar un código de confirmación de pago requerido por algunos sistemas de pago al abrir la interfaz de pago en un iframe, transmita el atributo allow=“clipboard-read; clipboard-write; payment” al iframe.

Ejemplo:

Copy
Full screen
Small screen
<iframe
  src="https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN"
  width="800"
  height="700"
  allow="clipboard-read; clipboard-write; payment"
></iframe>
¿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.

Seguir leyendo

Última actualización: 22 de Enero 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!