Configuração de pagamentos

Validação do usuário

O que é o ID de usuário?

O ID do usuário é um parâmetro que permite identificar um usuário em um jogo. Você pode armazenar IDs de usuário em um banco de dados. Ao receber IDs de usuário inválidos, lance uma exceção. Consulte o repositório do GitHub para obter um exemplo de validação do usuário.

Quais dados devo retornar após a conclusão da validação?

Quando a validação for bem-sucedida, retorne o código HTTP 200. Em caso de erro, o código 400 (INVALID_USER).

Personalização

Posso personalizar o tema da interface de pagamento?

Você pode habilitar um tema escuro enviando o parâmetro settings.ui.theme = default_dark no token. O tema escuro permite que você defina a imagem de fundo ou altere a cor do plano de fundo (como é na demonstração). Para alterar outras configurações, entre em contato com o Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.

Posso alterar a aparência dos e-mails enviados aos usuários?

Sim. Siga as instruções sobre como personalizar e-mails para os usuários. A ordem dos elementos de e-mail não pode ser alterada, pois eles fazem parte de um modelo padrão. Isso é exigido de acordo com o contrato de licenciamento com a Xsolla, que atua como comerciante legal de registros.

Testes

Posso usar cartões bancários de teste para testar o processo de pagamento?

Sim, mas somente quando você executa seu aplicativo ou a demonstração do Pay Station no modo sandbox. Consulte a lista geral de cartões bancários de teste de diferentes marcas e países emissores.

Posso testar o fluxo de pagamento PayPal no modo sandbox?

Sim. Veja informações detalhadas na instrução.

Como posso testar os reembolsos de pagamento?

Você pode testar reembolsos por meio da chamada de API Solicitar reembolso. Consulte as instruções para obter mais informações.

O que é o Xsolla Invoice ID e o Invoice ID na aba de teste do webhook na Conta de Distribuidor?

O Xsolla Invoice ID é o ID da transação do lado Xsolla. Para testes, você pode usar qualquer valor numérico.

O Invoice ID é um ID de transação opcional no seu jogo. Para o teste, você pode inserir qualquer combinação de letras e números.

Payments

Como posso validar uma solicitação de pagamento recebida em um webhook?

Primeiro, verifique se existe um ID de usuário especificado em seu projeto. Em seguida, retorne o código 200 para validar o pagamento.

Posso redirecionar um usuário para uma forma de pagamento específica?

Ao abrir a interface da loja, você pode passar o ID da forma de pagamento no parâmetro settings.payment_method. Nesse caso, os usuários são redirecionados para a forma de pagamento do método de pagamento selecionado. Você pode encontrar a lista de IDs de forma de pagamento na Conta de Distribuidor na seção Payments > Payment methods.

Posso redirecionar automaticamente um usuário para uma página de pagamento bem-sucedida/falha após o processamento de um pagamento, dependendo do resultado?

Sim, você pode configurar condições de redirecionamento. Consulte as instruções para obter mais informações.

Nosso sistema de faturamento define automaticamente o order_id para cada pedido. Posso usar order_id em vez de user_id ao receber um token?

Não, você precisa user_id para tudo funcionar corretamente.

Você também pode passar o order_id no parâmetro external_id. Para fazer isso:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Pay Station > Payment interface > Settings.
2. No bloco Additional settings, defina a opção Transaction external IDcomo On.

Posso substituir o URL do webhook para cada transação?

Não, o URL do webhook para todas as transações é definido nas configurações do projeto na Conta de Distribuidor.

Receberei os detalhes das transações falhas?

Não, a Xsolla só envia webhooks para transações bem-sucedidas. Se você recebeu uma notificação sobre um pagamento, isso significa que a transação foi bem-sucedida.

Como posso adicionar o VAT ao valor total do pagamento?

O que significa PID?

PID é o identificador do método de pagamento do lado da Xsolla.

O que é um ID externo?

O ID externo é o ID de uma transação no jogo que é atribuído a um pedido em seu sistema. No lado da Xsolla, o ID externo está vinculado a um ID de transação. É por isso que um ID externo habilitado permite que a Xsolla impeça pagamentos repetidos para a mesma transação.

1. Abra seu projeto dentro da Conta de Distribuidor e acesse a seção Project settings > Integration settings.
2. Na seção Payments, selecione a caixa de seleção necessária:
   • Use external ID — para tornar a validação do ID Externo obrigatória ao criar um token.
   • Skip verification for external ID — para desativar a validação do ID Externo ao criar um token.

3. Selecione Save.

Observação

Quando a configuração Use external ID está ativada, não é possível fazer um pagamento de teste pela Conta de Distribuidor. Para fazer um pagamento de teste com sucesso, desative essa configuração temporariamente.

Preciso gerar um novo ID externo para cada transação?

Sim. O ID externo tem que ser exclusivo para cada pagamento.

Que valor preciso definir para o método setExternalPaymentId?

O método setExternalPaymentId deve ter o mesmo valor que o external_id, se você tiver um.

O que são os portais?

Depois de assinar um contrato com sistemas de pagamento, você pode usar portais para exibir essas opções de pagamento na interface de pagamento. Os jogadores ainda podem pagar por suas compras usando métodos de pagamento selecionados, e você receberia pagamentos diretamente desses provedores de sistema de pagamento. Para conectar portais, abra seu projeto na Conta de Distribuidor e vá para a seção Payments > Payments settings > Gateways.

A Xsolla atua como um provedor de serviços técnicos e tem uma participação de receita reduzida: 1,25% do valor da transação + US$ 0,10. Você terá acesso total a todas as soluções Xsolla, mas deve fazer o seguinte:

• gerenciar questões relacionadas a impostos
• assinar contratos separados com cada sistema de pagamento
• reter o fluxo de dinheiro direto dos sistemas de pagamento
• gerenciar taxas de sistema de pagamento, estornos, reembolsos, comissões de proventos e custos operacionais

Por exemplo, se você trabalha com PayPal e deseja defini-lo como uma forma de pagamento direto, você pode conectar um portal. A interface de pagamento não será alterada — as alterações afetarão apenas o processo de pagamento. Depois de processar um pagamento, o dinheiro de um jogador será transferido para a sua conta PayPal. Neste caso, a Xsolla não está envolvida no processo de pagamento de proventos.

Como posso migrar os dados do usuário (contas de pagamento salvas, assinaturas, etc.) para a Xsolla?

Entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com. Certifique-se de usar a criptografia PGP para fornecer segurança de dados.

Parâmetros-chave Xsolla PGP:

• Key ID: FBA38225
• Tipo de chave: RSA
• Comprimento da chave: 4096
• Assinatura digital: 4D63 4B67 B265 5464 D39D 7228 67B0 672A FBA3 8225
• ID de usuário: admins@xsolla.com

 1-----BEGIN PGP PUBLIC KEY BLOCK-----
 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
49=7AyM
50-----END PGP PUBLIC KEY BLOCK-----

Como é determinado o país de um usuário?

Ao usar a chamada de API do lado do cliente para gerar o token de pagamento, a Xsolla determina o país do usuário a partir do endereço IP da solicitação.

Ao utilizar a chamada de API do lado do servidor para gerar o token de pagamento, o país é determinado pela conferência sequencial de:

• o valor do parâmetro user.country.value no corpo da solicitação
• o endereço IP no cabeçalho X-User-Ip

Se nenhum desses valores for passado, aparecerá um erro. Se ambos esses valores forem passados, a informação do corpo de solicitação será utilizada.