INXY Payments

Plataforma de criptoprocessamento com recursos recorrentes

Registro

Depois de se registrar no serviço https://auth.inxy.io/, vá até a API do gateway de pagamento no menu lateral esquerdo e preencha os seguintes dados — nome e descrição da carteira e ícone. O link para o seu site é opcional. Selecione todas as criptomoedas que você deseja aceitar com uma caixa de seleção e clique em Salvar alterações

Após salvar, será aberta a janela com os dados de conexão. Em seguida, gere a chave API clicando no botão Gerar (1) e informe o código enviado para o seu e-mail. Salve a variável resultante em um lugar seguro. Copie a Secret Key gerada para o mesmo lugar. As chaves, em caso de perda, podem ser regeneradas (nesse caso, lembre-se de alterar os dados no projeto). Insira a URL para webhooks https://chatter.salebot.pro/inxy_callback/result no campo Postback URL (2).

Configuração da conexão

Depois vá para Salebot — Sistemas de pagamento — INXY e clique no botão Conectar. Insira as chaves API e Secret recebidas nos campos.

captura de tela da conexão no Salebot

Gerando link de pagamento

Para gerar o link de pagamento, insira o valor da variável payment_sum (por exemplo: 1); depois disso, a variável inxy_pay_url aparecerá. Você pode adicionar essa variável na tela como um link ou colocá-la no botão Pagar.

ATENÇÃO! O sistema funciona com USD! O valor na variável payment_sum é considerado como USD no sistema de pagamento INXY.

O link fica assim: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1

Além disso, antes de inserir o valor para a variável payment_sum, você pode inserir o seguinte variáveis opcionais para a configuração do pagamento inxy_currency — criptomoeda que será usada para o pagamento. Você pode inserir uma das criptomoedas disponíveis que você escolheu com uma caixa de seleção durante a geração da chave API. Se deixado em branco, os jogadores escolhem a criptomoeda por conta própria a partir da lista das escolhidas. Valores disponíveis: ‘BTC’,‘ETH’,‘LTC’,‘DOGE’,‘USDT’,‘USDC’,‘DAI’

inxy_description – descrição do pagamento.

ATENÇÃO! Primeiro você insere variáveis opcionais para a configuração e depois a payment_sum.

As variáveis podem ser inseridas antes na sequência, e não em um único bloco. Já a variável inxy_pay_url, que inclui o link, deve ser colocada no lugar correto. Esse link abre o formulário de pagamento.

ATENÇÃO! A linha Valor total mostra o valor em USD, que equivale à payment_sum. A linha Valor total em cripto abaixo mostra o valor na criptomoeda escolhida. Ele varia com base na taxa de câmbio atual. Esse é o valor que seu cliente precisa pagar a partir da carteira dele.

ATENÇÃO! O endereço da carteira para o pagamento durante uma única sessão fica reservado apenas para o cliente por 2 horas. Recomenda-se que o cliente verifique se o tempo não acabou e se o endereço da carteira ainda é válido no momento do pagamento. Se o tempo da sessão tiver acabado — todo o processo de pagamento precisará ser iniciado novamente.

Callback de pagamento

Após o pagamento bem-sucedido, o bot receberá um callback informando que o pagamento foi realizado com sucesso. Você vê esse callback no sistema como uma mensagem do usuário, para que o usuário não possa enviá-la. Os próprios usuários NÃO PODEM VER o callback, apenas o operador pode vê-lo. O INXY tem vários tipos de callbacks:

1. Os callbacks de sucesso consistem nos primeiros 10 símbolos do token seguidos de ‘success’, por exemplo: uc8zsjNN1x_success

Esse callback é enviado se o cliente pagou o valor total e nenhum problema ocorreu durante o pagamento. Junto com esse callback, duas variáveis serão adicionadas ao projeto: inxy_payment_completed igual a True; e inxy_payment_status com o valor pago.

Durante o processo, a inxy_payment_status variável muda de valor. Depois que o usuário abre o formulário, ela mudará para waiting_payment; durante o processamento do pagamento, mudará para waiting_confirmation; e, após o processamento bem-sucedido, terá o valor paid ou partially_paid.

Durante o processamento do callback, o tipo de comparação deve ser Correspondência exata. Ex.: você pode fazer o processamento bem-sucedido do pagamento como um bloco com condição e mostrar a mensagem relevante para o usuário:

2. Às vezes as taxas de câmbio das criptomoedas mudam ou as carteiras cobram uma taxa extra nas operações, de modo que o valor resultante recebido por você não fica completo. Nesses casos, a variável inxy_payment_status terá o valor partially_paid e o sistema receberá um callback com a seguinte aparência:

Nesse caso, você precisará enviar uma mensagem ao cliente solicitando que cubra o valor faltante. Ex.: você pode definir uma condição para o início do seu callback e, ao recebê-lo, enviar ao cliente uma URL pré-gerada com um link de pagamento, ou pode definir uma condição para que o bloco seja ativado quando o valor da variável inxy_payment_status for partially_paid.

Lembre-se de que o link de pagamento é válido por apenas 2 horas! Se o cliente não fizer o pagamento do valor faltante a tempo, ele não poderá ser aberto. Como o INXY, nessa etapa, processará o primeiro pagamento parcial, o dinheiro não será devolvido ao cliente. Para devolvê-lo, você precisará acessar sua conta INXY e realizar a operação de reembolso.

Criando assinatura

O sistema INXY permite aos usuários criar assinaturas. Para fazer isso, adicione qualquer valor à inxy_subscription_payment variável, e uma assinatura mensal será criada. Se você quiser definir um período diferente, use as seguintes variáveis: inxy_subscription_interval igual a ‘day’ — criará um intervalo de assinatura igual a dias (o padrão é month) inxy_subscription_period — adicione uma variável igual de 1 a 30 para definir o período. Ex.: para criar um pagamento de assinatura a cada 15 dias, defina inxy_subscription_interval =‘day’ e inxy_subscription_period=15; e para o pagamento ser feito duas vezes por ano, defina inxy_subscription_period=6 (já que inxy_subscription_interval é month por padrão)

O link também abrirá o formulário de pagamento, mas ele será diferente: primeiro, ao lado, será mostrado que o pagamento é baseado em assinatura com o período exibido; segundo, o formulário sugerirá ao cliente adicionar um depósito para vários pagamentos antecipados.

Especificidades do INXY: Se o cliente pagar x2 ou x3 do valor, o Salebot receberá uma mensagem sobre um único valor. O restante será depositado no saldo do cliente e será usado para os próximos pagamentos. Como a taxa de câmbio da criptomoeda varia, no final esse valor pode ser insuficiente para um dos pagamentos seguintes, resultando em uma assinatura não paga. Nesse caso, você receberá um callback indicando ‘fail’ e poderá configurar um lembrete para o seu cliente.

A assinatura não pode ser paga parcialmente. O saldo do cliente é verificado antes do pagamento. Se não houver fundos suficientes, o pagamento não é feito.

Após a assinatura bem-sucedida, as variáveis do cliente incluirão inxy_subscribtion_id (número de referência) e inxy_subscription_status.

Cancelando assinatura

Para cancelar uma assinatura, use a seguinte função inxy_remove_subscription(inxy_subscription_id). Insira o número de ID da assinatura como inxy_subscribtion_id na função e a assinatura será cancelada.

Em caso de sucesso, você receberá um callback ‘Subscription status inxy_subscription_id - deleted’ e a variável inxy_subscription_status mudará para o valor correspondente.