Configuração da exibição do widget de pagamento

Para adicionar uma interface de widget de pagamento à sua plataforma, você precisa adicionar a biblioteca de widgets. Você também pode ajustar a altura do widget e a manipulação de eventos para melhorar a experiência do usuário.

Adicione a biblioteca de widgets de pagamento

Observação
Para abrir o widget de pagamento no modo sandbox, consulte estas instruções.

Configuração usando script

Adicione o script à página do site da sua plataforma. Nos parâmetros de inicialização do script, passe o token de autorização obtido na etapa de integração anterior. O script é executado sempre que a página é carregada.
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>
    

    Configure usando o pacote npm

    1. Execute o comando npm install @xsolla/payouts-sdk e configure a biblioteca de widgets.
    2. Adicione um link na biblioteca para o site da sua plataforma. Na solicitação, passe o token de autorização obtido na etapa de integração anterior.
    Perguntas Frequentes
    Consulte as respostas para resolver problemas comuns.
    Use o seguinte código de inicialização:
    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');
      });
      

      Configurações adicionais

      Altura

      Você pode ajustar a altura do widget de pagamento passando o seguinte parâmetro no código de inicialização:
      ParâmetroTipoDescrição
      size
      stringA altura do widget de pagamento:
      • fixed — altura fixa do widget de 600 px.
      • auto — altura do widget dinâmico que muda dependendo do tamanho da tela.

      Manipulação de eventos

      Você pode configurar a manipulação dos seguintes eventos:

      • loaded — carregamento de widget em um iframe.
      • tokenExpired — expiração de um token.
      • requestWithdrawal — solicitação bem-sucedida para receber o saque.
      • heightResize — alteração de altura do widget. O evento é manipulado somente quando o parâmetro size==‘auto’ é passado.

      Exemplo de configuração de manipulação 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}`);
        });
        
        Seu progresso
        Obrigado pelo seu feedback!
        Última atualização: 22 de Janeiro de 2024

        Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

        Relatar um problema
        Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
        Forneça um e-mail para que possamos responder
        Obrigado pelo seu feedback!