SDK para o Cocos Creator / Informações gerais
  Voltar aos Documentos

SDK para o Cocos Creator

Informações gerais

A interface de pagamento é baseada no produto Pay Station. A escolha dos métodos de pagamento disponíveis e outras configurações estão disponíveis na Conta de Distribuidor na seção Pay Station.

O SDK suporta a compra de itens do catálogo com um clique ou através do carrinho de compras.

Para testar o processo de compra, você pode usar o modo sandbox da interface de pagamento e cartões de teste. O modo sandbox apenas simula o comportamento de uma forma de pagamento; não há dinheiro real envolvido. Para experimentar o sandbox, você não precisa assinar nenhum contrato com a Xsolla ou pagar nenhuma taxa.

Aviso
Depois que o primeiro pagamento real é feito, uma política rigorosa de pagamento sandbox entra em vigor. Os pagamentos feitos no modo sandbox estão disponíveis apenas para usuários especificados na Conta de Distribuidor na seção Company settings > Users.

Guias

Saiba mais sobre configurações avançadas em nossos guias.

Como configurar o redirecionamento de usuários para seu aplicativo após o pagamento

Para redirecionar os usuários para outra página depois que eles concluírem o pagamento, você pode configurar dois tipos de redirecionamentos:

  • automático — um redirecionamento com um atraso definido.
  • manual — um redirecionamento depois que o usuário fecha a interface de pagamento ou clica no botão de redirecionamento.

Você pode configurar um redirecionamento das seguintes maneiras:

  • na Conta de Distribuidor — use essa opção se estiver configurando um projeto para um único aplicativo e não planeja criar compilações para plataformas diferentes.

  • nas configurações do SDK — use esta opção se você planeja:
    • usar o projeto para vários aplicativos
    • criar compilações para diferentes plataformas
    • vender itens no jogo através do site
Aviso
Se os redirecionamentos estiverem configurados nas opções da Conta de Distribuidor e do SDK, os parâmetros especificados nas configurações do SDK serão usados.

Configure os redirecionamentos na Conta de Distribuidor

  1. Abra seu projeto na Conta de Distribuidor.
  2. Clique em Pay Station no menu lateral.
  3. Vá para a seção Settings > Redirect policy.
  1. No campo Return URL, insira o URL ou o caminho para o qual o usuário será redirecionado após fazer um pagamento.
Observação
Para redirecionar os usuários para um aplicativo móvel, o URL deve corresponder a um dos seguintes esquemas:

  1. Para definir parâmetros de redirecionamento automático:
    1. Na lista suspensa, escolha a Automatic redirect conditiono:
      • None — do not redirect.
      • Successful payment — redirecionar quando um pagamento for bem-sucedido.
      • Successful or canceled payment — redirecionar quando um pagamento for bem-sucedido ou cancelado.
      • Any payment — redirecionar para qualquer status de pagamento.
    2. No campo Delay, insira um tempo limite de redirecionamento em segundos. Por padrão, um redirecionamento é ativado em 0 segundos.

  1. Para definir parâmetros de redirecionamento manual:
    1. Na lista suspensa, escolha a Manual redirect condition:
      • None — do not redirect.
      • Successful payment — o botão de redirecionamento aparece quando um pagamento é bem-sucedido.
      • Successful or canceled paymen — o botão de redirecionamento aparece quando um pagamento é bem-sucedido ou cancelado.
      • Any payment — o botão de redirecionamento aparece para qualquer status de pagamento.
    2. No campo Redirect button caption, insira o texto do botão que redireciona o usuário para o URL de retorno.
Aviso

O texto do botão de redirecionamento é Voltar para o jogo por padrão. Ele está traduzido em todos os idiomas do Pay Station.

Se o seu projeto suporta vários idiomas, você pode inserir o texto do botão de redirecionamento para cada um deles nos respectivos campos.

Quando um usuário fecha a interface de pagamento, ele também é redirecionado para o URL de retorno especificada.

  1. Clique em Save.

Configure redirecionamentos nas configurações do SDK

Passe os parâmetros de redirecionamento para o método init. Para fazer isso, adicione as linhas no código-fonte do seu projeto no Cocos Creator de acordo com o exemplo para a compilação Android abaixo. Defina os parâmetros de redirecionamento:

  1. Em useSettingsFromPublisherAccount, passe false.
  2. No parâmetro returnUrl, passe um URL ou um caminho para o qual um usuário será redirecionado depois de fazer um pagamento.
Observação
Para redirecionar os usuários para um aplicativo móvel, o URL deve corresponder a um dos seguintes esquemas:

  1. Para definir parâmetros de redirecionamento automático:
    1. No parâmetro redirectCondition, passe condições quando um redirecionamento for ativado:
      • PaymentRedirectCondition.none — não redirecionar.
      • PaymentRedirectCondition.successful — redirecionar quando um pagamento for bem-sucedido.
      • PaymentRedirectCondition.successful_or_canceled — redirecionar quando um pagamento for bem-sucedido ou cancelado.
      • PaymentRedirectCondition.any — redirecionar para qualquer status de pagamento.
    2. No parâmetro redirectDelay, passe um tempo limite de redirecionamento em segundos.

  1. Para definir parâmetros de redirecionamento manual:
    1. No parâmetro redirectStatusManual, passe um status de pagamento quando o botão de redirecionamento aparecer:
      • PaymentRedirectCondition.none — não redirecionar.
      • PaymentRedirectCondition.successful — redirecionar quando um pagamento for bem-sucedido.
      • PaymentRedirectCondition.successful_or_canceled — redirecionar quando um pagamento for bem-sucedido ou cancelado.
      • PaymentRedirectCondition.any — redirecionar para qualquer status de pagamento.
    2. No parâmetro redirectButtonCaption, passe o texto do botão que redireciona o usuário para o URL de retorno.
Aviso

O texto do botão de redirecionamento é Voltar para o jogo por padrão. Ele está traduzido em todos os idiomas do Pay Station.

Se o seu projeto suporta vários idiomas, você pode inserir o texto do botão de redirecionamento para cada um deles nos respectivos campos.

Quando um usuário fecha a interface de pagamento, ele também é redirecionado para o URL de retorno especificada.

Exemplo de configuração de redirecionamentos para compilações Android:

Copy
Full screen
Small screen
let redirectPolicySettingsAndroid: RedirectPolicySettings = {
                useSettingsFromPublisherAccount: false,
                returnUrl: 'app://xpayment.com.example.myapp',
                redirectCondition: PaymentRedirectCondition.successful,
                redirectDelay: 0,
                redirectStatusManual: PaymentRedirectStatusManual.successful,
                redirectButtonCaption: 'Back to the game'
        };
var settings: XsollaSettings = {
            loginId: '<yourLoginId>',
            projectId: '<yourProjectId>',
            clientId: '<yourClientId>',
            enableSandbox: IsSandbox,
            redirectPolicySettingsAndroid: redirectPolicySettingsAndroid
        }

        Xsolla.init(settings);
Observação
Você pode definir diferentes parâmetros de redirecionamento para diferentes plataformas de compilação para o seu aplicativo. Para fazer isso, use os parâmetros:
  • redirectPolicySettingsAndroid
  • redirectPolicySettingsIOS
  • redirectPolicySettingsWebGL
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.
Ocultar

Continuar lendo

Última atualização: 6 de Março 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!