MyQ X Server

Recarga de crédito via Stripe

O Stripe é um provedor de pagamentos que oferece suporte a diversos métodos de pagamento, incluindo cartões de crédito, cartões de débito e transferências bancárias. Você configura e gerencia esses métodos a partir do seu painel do Stripe.

Com uma conta do Stripe ativada, você pode permitir que os usuários recarreguem seu crédito do MyQ por meio de pagamentos do Stripe diretamente da MyQ Web Interface.

Para evitar taxas de conversão de moeda, certifique-se de que o código de moeda de três letras definido em MyQ > Configurações > Geral também esteja incluído entre suas moedas de liquidação no Stripe.


Configurando os pagamentos via Stripe

Para configurar o Stripe como provedor de pagamentos no MyQ, basta inserir sua chave secreta do Stripe no MyQ. Não é necessário criar nenhum item especial no catálogo de produtos – os pagamentos do MyQ são processados automaticamente no Stripe como Crédito MyQ.

Embora você possa usar a chave secreta padrão do Stripe (seja para ambientes de teste ou de produção), recomendamos gerar uma chave restrita exclusiva para cada instância do servidor de impressão. Chaves restritas são mais seguras, pois as permissões devem ser concedidas explicitamente. Usar uma chave separada por instância permite que você revogue ou alterne uma única chave sem afetar as outras e limita o impacto caso uma chave seja comprometida.

Use uma chave de teste do Stripe para validar a integração com o MyQ. Quando estiver pronto, gere uma chave restrita a partir do seu ambiente de produção do Stripe e configure-a no MyQ.

Para obter mais informações, consulte os seguintes recursos na documentação do Stripe:

Criar uma chave restrita no Stripe

Você gera uma chave restrita no seu Painel do Stripe.

  1. Faça login na sua conta do Stripe em https://dashboard.stripe.com/ e selecione o ambiente que deseja usar com o MyQ.

  2. Acesse a página “Chaves de API” na seção “Desenvolvedores” do seu painel do Stripe.

  3. Na seção “Chaves restritas”, clique em “+ Criar chave restrita”.

  4. Escolha “Criando sua própria integração” e clique em “Continuar”.

  5. Insira um nome descritivo para a chave (por exemplo, “Integração com o MyQ”).

  6. Defina as seguintes permissões para Write:

    • Intents de pagamento

    • Sessões de checkout

  7. Certifique-se de que todas as outras permissões estejam definidas como None.

  8. Clique em “Criar chave”.

  9. Copie o token da sua chave.
    Você precisará desse token ao configurar o Stripe no MyQ.

Configure o Stripe no MyQ

  1. Faça login na interface do usuário da Web como administrador e acesse Configurações > Contabilização > Crédito.

  2. Em Provedores de pagamento, clique duas vezes em Stripe.

  3. Insira o valor mínimo de crédito que um usuário pode comprar.

  4. Insira sua chave secreta do Stripe na íntegra (ou o token da sua chave restrita) no campo Chave de segurança e clique em Salvar.

image-20251111-151637.png

Recarregar o crédito do usuário com o Stripe

Para atualizar seu crédito com o Stripe, o usuário deve seguir estas etapas na MyQ Web Interface.

  1. Faça login na MyQ Web Interface.

  2. Vá para “Crédito” e clique em “Recarregar crédito”.

  3. Selecione o Stripe como provedor de pagamento e insira o valor de crédito que deseja adquirir.

  4. Clique em “Recarregar crédito”.
    Uma janela de checkout do Stripe será aberta, onde você concluirá o pagamento. Após o pagamento ser concluído com sucesso, você será direcionado para a página de confirmação. O crédito será adicionado automaticamente à sua conta.

  5. Se o novo saldo de crédito não for exibido, atualize o MyQ no seu navegador.