Como abrir a interface de pagamento

Observação

Antes de assinar um contrato com a Xsolla, teste do seu processo de pagamento só está disponível no modo sandbox. Em caso de erros, consulte suas descrições.

Para abrir a interface de pagamento no modo sandbox, use o seguinte URL: https://sandbox-secure.xsolla.com/paystation4/?token=ACCESS_TOKEN, onde ACCESS_TOKEN é o token obtido na etapa anterior.

Nova janela

Para abrir a interface de pagamento em uma nova janela, use o seguinte URL: https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN, onde TOKEN é o token obtido.

Observação
Use o link acima para abrir a interface de pagamento no modo sandbox. Após o lançamento do projeto, use este URL https://secure.xsolla.com/paystation4/?token=TOKEN.
Você também pode abrir a interface de pagamento usando outras opções:
  • Com a Pay Station Embed. Limitação: podem haver problemas ao abrir no navegador do jogo (WebView).
  • No iframe. Limitação: podem haver problemas ao abrir no navegador do jogo (WebView) e na versão móvel do seu aplicativo.

Pay Station Embed

Aviso
Essa maneira de abrir a interface de pagamento não oferece suporte à venda de chaves de jogo. Para vender chaves de jogo, siga a instrução.
EXEMPLO: CARREGAMENTO DE SCRIPT ASSÍNCRONO
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>

A Pay Station Embed permite obter eventos da interface de pagamento via postMessage. Você pode enviar esses eventos para sistemas de análise. Para configurar o processamento de eventos em seu sistema de análise, entre em contato com seu Gerente de Sucesso da Conta ou envie um e-mail para csm@xsolla.com.

A equipe Xsolla criou um widget que simplifica a integração da interface de pagamento em seu site. O script do widget está disponível em nosso repositório GitHub.

Parâmetros de inicialização do script:

ParâmetroTipoDescrição
access_token
stringToken, recebido via API. Obrigatório.
sandbox
booleanDefina como true para testar o processo de pagamento: sandbox-secure.xsolla.com será usado em vez de secure.xsolla.com.
lightbox
objectParâmetros da lightbox (objeto; somente versão desktop).
lightbox.width
stringLargura do quadro da lightbox. Se null, depende da largura do Pay Station. O padrão é null.
lightbox.height
stringAltura do quadro da lightbox. Se null, depende da altura do Pay Station. O padrão é 100%.
lightbox.zIndex
integerDefine a ordem do arranjo. O padrão é 1000.
lightbox.overlayOpacity
integerOpacidade do plano de fundo do widget (0 — totalmente transparente, 1 — completamente opaco). O valor padrão é 60% (.6).
lightbox.overlayBackground
stringCor de fundo da sobreposição. O padrão é #000000.
lightbox.modal
booleanSe true, o quadro lightbox não poderá ser fechado. O padrão é false.
lightbox.closeByClick
booleanSe true, clicar na sobreposição fechará a lightbox. O padrão é true.
lightbox.closeByKeyboard
booleanSe true, pressionar ESC fechará a lightbox. O padrão é true.
lightbox.contentBackground
stringCor de fundo do quadro. O padrão é #ffffff. Observe que essas mudanças de cor não afetam o iframe do Pay Station em si, apenas as configurações da lightbox que o contém.
lightbox.contentMargin
stringMargem do quadro. O padrão é 10px.
lightbox.spinner
stringTipo de indicador de carregamento animado. Pode ser xsolla ou round. O padrão é xsolla.
lightbox.spinnerColor
stringCor do cata-vento. Sem valor padrão.
childWindow
objectOpções para a janela filho que contém a interface do Pay Station. Suportado na versão móvel.
childWindow.target
stringOnde abrir a janela do Pay Station. Pode ser _blank, _self, _parent. O padrão é _blank.

O script permite que você acompanhe eventos da interface de pagamento. Dependendo do tipo de evento, você pode executar várias ações na página da web.

Lista de eventos:

ParâmetroDescrição
initWidget inicializado.
openWidget aberto.
loadInterface de Payments (Pay Station) carregada.
closeInterface de Pagamento (Pay Station) fechada.
statusO usuário está na página de status.
status-invoiceO usuário está na página de status; pagamento em andamento.
status-deliveringEvento em que o usuário foi movido na página de status, o pagamento foi concluído e estamos enviando uma notificação de pagamento.
status-doneO usuário está na página de status; pagamento creditado na conta do usuário.
status-troubledEvento em que o usuário foi movido na página de status, mas o pagamento falhou.
Se você quiser inicializar a abertura da interface de pagamento, use o seguinte link: https://secure.xsolla.com/paystation4/?token=TOKEN.
Observação
É necessário usar o link com o prefixo https:// apenas para a abertura da interface de pagamento.
Use o seguinte URL para fins de teste: https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN.
Aviso
O parâmetro access_token contém dados privados do usuário. Certifique-se de usar a comunicação de servidor para servidor ao obter esse parâmetro.

Iframe

Para abrir a interface de pagamento em um iframe:

  1. Implemente o mecanismo postMessage para receber eventos da interface de pagamento.
  2. Abra a interface de pagamento seguindo o link https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN, onde TOKEN é o token recebido.

Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Avalie esta página
Avalie esta página
Podemos melhorar alguma coisa?

Não quero responder

Obrigado pelo seu feedback!

Continuar lendo

Ú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!