Establecer la visualización del widget de pago

Para agregar una interfaz de widget de pago a su plataforma, debe agregar la biblioteca de widgets. También puede ajustar la altura del widget y el control de eventos para mejorar la experiencia del usuario.

Añadir biblioteca de widgets de pago

Nota
Para abrir el widget de pago en modo Aislador de proceso (sandbox), consulte estas instrucciones.

Establecerlo mediante script

Añade el script a la página del sitio web de su plataforma. En los parámetros de inicialización del script, transmita el token de autorización obtenido en el paso de integración anterior. El script se ejecuta cada vez que se carga la página.
Copy
Full screen
Small screen
    <script>
        var s = document.createElement('script');
        s.type = "text/javascript";
        s.async = true;
        s.src = "https://static.xsolla.com/payouts/v0/_bundles/santorelli.min.js";
        s.addEventListener('load', function () {
            const widget = new XPayoutsWidget.Widget({
    					token: '<auth token>',
    					theme: 'black',
    					size: 'fixed'  
    				});
    
            widget.show('<container_id>');
    
    		widget.addEventListener('load', () => {
    			console.log('loaded');
    		});
        }, false);
        var head = document.getElementsByTagName('head')[0];
        head.appendChild(s);
    </script>
    

    Establecerlo mediante npm-package

    1. Ejecute el comando npm install @xsolla/payouts-sdk y establezca la biblioteca de widgets.
    2. Añada un enlace a la biblioteca en el sitio web de su plataforma. En la solicitud, transmita el token de autorización obtenido en el paso de integración anterior.
    Preguntas frecuentes
    Consulte las respuestas para resolver problemas comunes.
    Utilice el siguiente código de inicialización:
    Copy
    Full screen
    Small screen
      import {Widget} from '@xsolla/payouts-sdk';
      
      const widget = new Widget({
      	token: '<auth token>',
      	theme: 'black',
      	size: 'fixed'  
      });
      
      widget.show('<container_id>');
      
      widget.addEventListener('load', () => {
      	console.log('loaded');
      });
      

      Ajustes adicionales

      Altura

      Puede ajustar la altura del widget de pago transmitiendo el siguiente parámetro en el código de inicialización:
      ParámetroTipoDescripción
      size
      stringLa altura del widget de pago:
      • fixed - altura fija del widget de 600 px.
      • auto - altura dinámica del widget que cambia en función del tamaño de la pantalla.

      Control de eventos

      Puede establecer el control de los siguientes eventos:

      • loaded - carga de widgets en un iframe.
      • tokenExpired - expiración de un token.
      • requestWithdrawal - solicitud aceptada para recibir reintegros.
      • heightResize - cambio de altura del widget. El evento se controla solamente cuando se transmite el parámetro size==‘auto’.

      Ejemplo de configuración del control de eventos:

      Copy
      Full screen
      Small screen
        widget.addEventListener('tokenExpired', () => {
        	console.log('tokenExpired');
        });
        widget.addEventListener('heightResize', ({ height }) => {
        	console.log(`height resize to: ${height}`);
        });
        widget.addEventListener('requestWithdrawal', ({ amount }) => {
        	console.log(`success request withdrawal, amount: ${amount}`);
        });
        
        Tu progreso
        ¡Gracias por tu mensaje!
        Ú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!