Como integrar um sistema de pagamento no Kwiga

A plataforma Kwiga permite configurar a receção de pagamentos de alunos através de integrações com sistemas de pagamento. Com a integração, pode aceitar pagamentos com cartão dos alunos, oferecer pagamentos em prestações e acesso por subscrição.

Para configurar a integração, vá ao menu superior Definições - Integrações - Sistemas de pagamento:

Selecione na lista o nome do sistema que precisa de configurar.

Na nova janela, preencha as definições e Guarde.

Neste momento, os seguintes sistemas de pagamento estão disponíveis para integração, e a lista está a expandir-se gradualmente. Se não encontrar o sistema de pagamento de que precisa, escreva-nos no Telegram.

plata by mono (acquiring do monobank)

Abra uma conta de empresário em nome individual na app monobank ou uma conta empresarial no Universal Bank ligando para 0 800 300 200.
(A abertura e manutenção de contas de empresário em nome individual no Monobank é gratuita. A abertura demora 2 minutos). 

Para abrir uma conta de empresário em nome individual:
1. Abra a app monobank
2. Deslize para baixo

3. Toque em “abrir um cartão ou conta de empresário em nome individual”

4. Selecione “conta de empresário em nome individual”

5. Preencha o formulário e envie o pedido. Preencha o formulário de pedido de ligação. Demora 2 minutos. Depois de preencher o formulário, no prazo de 24 horas receberá uma mensagem de confirmação da ligação e instruções.

Aguarde até que o acquiring seja ligado. Receberá uma notificação push na app monobank.

Vá para a conta de empresário em nome individual

Selecione a secção Acquiring->internet

*Se não tiver a página "internet", isto significa:
Que não deixou um pedido para ligar o internet acquiring do monobank? Pode enviá-lo através da ligação https://www.monobank.ua/e-comm
Или Ainda não lhe foi concedido acesso para receber pagamentos. Por favor, aguarde :)

Na janela que abrir, clique em criar token e depois copie-o

Especifique o Alias da conta, ou seja, como esta integração será apresentada na plataforma Kwiga, cole o token copiado no campo API Token e clique em Guardar.

O sistema de pagamento plata by mono permite aceitar pagamentos apenas em três moedas: EUR, USD, UAH

PayPal

Clique no ícone do logótipo PayPal, depois clique no botão +Conta e preencha as definições básicas:

Para ligar o PayPal à plataforma, precisa de ter uma conta business registada em paypal.com. Inicie sessão na sua conta PayPal e siga a ligação. Depois, na parte inferior da página, encontre Connect to an e-commerce platform e clique em Get Started.

Para integrar este sistema de pagamento, precisa de obter identificadores únicos – Client ID e Secret – e introduzir estes dados nos campos de definições correspondentes no Kwiga. Certifique-se de que copia os dados (client ID e secret key) de Live (a posição do seletor é mostrada pela seta vermelha na captura de ecrã), e não de Sandbox. Se vir a mensagem You're in sandbox mode, precisa de mudar o seletor para Live.

Especifique também o Alias da conta - o nome desta integração no Kwiga, como a conta será apresentada na plataforma, e clique em Guardar.

WayForPay

Clique no bloco WayForPay e clique no botão +Conta.

Para configurar a integração, deve ter uma conta no site WayForPay. Vá para a página Definições da loja e selecione a loja necessária. Depois, no bloco Detalhes do comerciante, copie os dados.

Introduza os valores MERCHANT LOGIN e MERCHANT SECRET KEY nos campos correspondentes do formulário de definições de integração no Kwiga.

MERCHANTPASSWORD - este campo é opcional. É utilizado apenas quando planeia aceitar pagamentos recorrentes (subscrições) e permitir que os clientes cancelem os pagamentos recorrentes por si próprios na sua conta de aluno. Para obter esta palavra-passe, contacte o apoio da Wayforpay.

Certifique-se de que o envio de Post para returnUrl ao redirecionar o cliente da página de pagamento está desativado nas definições da sua loja, no bloco Notifications (o interruptor assinalado deve estar desligado, cinzento).

LIQPAY

Clique no bloco com o nome LiqPay e depois no botão +Conta.

Para integrar o LiqPay com o Kwiga, precisa de criar e ativar uma conta no LiqPay. Após ativar a empresa, vá para a página principal. Copie os valores das chaves pública e privada e cole-os nos campos correspondentes do formulário de Definições do LiqPay, especifique o alias da conta (como esta integração será chamada na plataforma) e clique em Guardar.

Stripe

Clique no bloco com o nome Stripe e depois em +Conta.

Para integrar o Stripe com o Kwiga, terá de criar e ativar uma conta Stripe. Depois de a criar, vá para a secção “Developers” e abra o separador “API keys”.

Copie os valores Publishable key e Secret key, depois cole-os nos campos correspondentes para configurar a integração. Especifique também o alias da conta (como esta integração será chamada na plataforma) e clique em Guardar.

Adicionar IVA ao pagar via Stripe

O sistema de pagamento Stripe permite adicionar automaticamente IVA ao preço do curso. Nas definições do Stripe, pode especificar uma lista de países aos quais o imposto deve ser aplicado. Ao avançar para o pagamento, o cliente poderá escolher o seu país e, dependendo dessa escolha, o Stripe irá adicionar IVA ao montante ou não.

Para que isto funcione corretamente na plataforma Kwiga, ao configurar a oferta, precisa de desativar a opção “o preço inclui IVA”. Isto permitirá que o Stripe determine a localização do cliente por conta própria e, se necessário, cobre o imposto adequado.

FONDY

Clique no bloco correspondente com o logótipo da Fondy e clique em +Conta.

Para integrar, você precisa estar registado no sistema Fondy. E preencher as configurações no Kwiga:

Alias da conta - o nome da conta no Kwiga, como será exibido na lista de contas na plataforma.

Merchant ID - o serviço Fondy atribui este parâmetro a você; ele pode ser encontrado na sua conta Fondy na página Configurações do comerciante → Técnico. Copie o valor do campo Merchant ID e insira-o no campo correspondente nas configurações do Kwiga.

Chave de pagamento - vá para a sua conta Fondy e abra a página Configurações do comerciante → Técnico. Em seguida, copie o valor do campo Payment key.

Moedas permitidas - selecione a moeda na qual a sua conta de comerciante no Fondy está ligada; você pode уточнить estes detalhes com o suporte.

E clique em Salvar.

Além disso, certifique-se de que o método de redirecionamento correto está definido para você. Isso pode ser feito indo para Fondy -> Merchant settings -> Technical > payment page settings, no campo "Redirect method to the result page" deve ser POST (se outro valor estiver definido, ele deve ser alterado para  POST). 

Coin Payments

Para configurar a integração, clique no bloco chamado Coin Payments e depois no botão +Conta.

Para integrar, você precisa estar registado no CoinPayments. E preencher as configurações no Kwiga:

Alias da conta - o nome da conta na plataforma Kwiga, que será exibido na lista de sistemas de pagamento adicionados.

Chave pública - copie o valor do campo Public Key na sua conta na página https://www.coinpayments.net/acct-api-keys

Chave privada - copie o valor do campo Private Key na sua conta na página https://www.coinpayments.net/acct-api-keys

IPN Secret - especifique e copie o valor do campo IPN Secret na página de configurações do comerciante https://www.coinpayments.net/acct-settings.

Seu Merchant ID - copie o valor do campo Your Merchant ID na página de configurações básicas https://www.coinpayments.net/acct-settings

Depois que todos os campos estiverem preenchidos, clique em Salvar.

Na sua conta Coinpayments, abra Merchant Settings e insira https://cryptobalance.kwiga.com/coinpayment/ipn no campo IPN Secret

InterKassa

Alias da conta - este é o nome visível apenas para você para identificar este sistema de pagamento. Ele é exibido nos relatórios de pagamento e nas ofertas. 

Client ID pode ser encontrado no link https://portal.interkassa.com/account/checkout

Client Secret - está localizado no campo Secret key 

API Key - está localizado na seção API

Chave secreta - deve ser obtida na seção de verificação de propriedade do site. Você não precisa adicionar um arquivo com o conteúdo especificado; basta copiar o valor indicado para a plataforma Kwiga, salvar a adição da conta e, depois disso, clicar em Confirm no InterKassa.

Allpay

Inicie sessão na sua conta, vá para Settings->API Integration->Create login\/key pair.

Depois disso, vá para a plataforma Kwiga, abra Settings - Integrations - Payment systems - Allpay e clique em adicionar. Preencha os campos obrigatórios para adicionar:

Alias da conta - o nome da conta na plataforma Kwiga, que será exibido na lista de sistemas de pagamento adicionados. Pode ser qualquer nome que seja claro para você. 

Login da API - Copie o que é exibido na linha correspondente no Allpay

Chave da API - Copie o que é exibido na linha correspondente no Allpay

PayU

Inicie sessão na sua conta, abra Online Payments - My shops. 

Clique no nome da loja que você deseja conectar. 

Depois disso, vá para a aba POS e clique no nome da loja mais uma vez:

As configurações e os parâmetros necessários serão carregados para você (destacados em azul). 

Alias da conta - o nome da conta na plataforma Kwiga, que será exibido na lista de sistemas de pagamento adicionados. Pode ser qualquer nome que seja claro para você. 

POS ID - Copie o que é exibido na linha correspondente ao lado de POS ID (pos_id).

Segunda chave (MD5) - Copie o que é exibido na linha correspondente no PayU. 

Przelewy 24

Após se registar no sistema Przelewy24, precisa de ir às definições e criar uma integração de API. Tenha em atenção que, para operar e aceitar pagamentos, precisa de usar o serviço Przelewy24 - versão de produção. Use as instruções do sistema de pagamentos https://developers.przelewy24.pl/index.php?en#tag/Set-up-and-test-your-accounts/Build-API-integration. 

Depois disso, vá à plataforma Kwiga, abra Definições - Integrações - Sistemas de pagamento - Przelewy24 e clique em adicionar. Preencha os campos obrigatórios para o adicionar:

Alias da conta - o nome da conta na plataforma Kwiga que será apresentado na lista de sistemas de pagamento adicionados. Pode ser qualquer nome que lhe seja claro.

MerchantId - este é o seu login para aceder à sua conta Przelewy24; deve ter sido enviado no e-mail de registo que confirma o seu registo (e-mail de confirmação após o processo de registo). 

API key -  copie o valor do campo API key (clicando no botão mostrar para o visualizar). 

Crc - copie o valor do campo CRC key (clicando no botão mostrar para o visualizar). 

Recomenda-se adicionar o IP 159.69.103.40 à lista branca no sistema de pagamentos.

Klarna

Inicie sessão na sua conta Klarna e abra a secção Payment Settings (na parte inferior).

Selecione Klarna API Credentials

Clique em +Generate new Klarna API credentials

Depois disso, vá à plataforma Kwiga, abra Definições - Integrações - Sistemas de pagamento - Kalrna e clique em adicionar. Preencha os campos obrigatórios para o adicionar:

Alias da conta - o nome da conta na plataforma Kwiga que será apresentado na lista de sistemas de pagamento adicionados. Pode ser qualquer nome que lhe seja claro.

UID - copie e cole o valor indicado no campo Username (UID) no Klarna.

Password -  copie e cole o valor indicado no campo Password no Klarna.

RedSys

Recebe os detalhes da ligação no e-mail ao abrir a conta. 

Alias da conta - o nome da conta na plataforma Kwiga que será apresentado na lista de sistemas de pagamento adicionados. Pode ser qualquer nome que lhe seja claro.

DS_MERCHANT_MERCHANTCODE - número do comerciante

DS_MERCHANT_TERMINAL e DS_MERCHANT_CURRENCY são preenchidos conforme indicado no e-mail. Se já não tiver o e-mail, contacte o suporte da RedSys.

Também chamamos a sua atenção para o facto de que uma conta RedSys é inicialmente aberta em modo de teste, o que significa que não poderá aceitar pagamentos reais. Para aceitar pagamentos, a conta deve ser alterada para o modo Live no módulo de administração. Depois disso, receberá outro e-mail do suporte técnico da BBVA com instruções adicionais para configurar o ambiente real (Production) e ativar o seu TPV virtual.