INXY payments

Registro

Após se registrar no serviço https://auth.inxy.io/ vá ao menu API do gateway de pagamento e preencha as seguintes informações:

1. Nome e descrição da carteira, ícone.

2. O link para o site é colocado a seu pedido.

Todos os tipos de criptomoedas aceitos devem ser marcados e clique em Salvar alterações

Após salvar, será aberto um campo de dados de comunicação.

Em seguida, gere uma chave de API clicando em Gerar(1) e insira o código enviado para o seu e-mail.

A variável recebida deve ser armazenada em um local seguro. Copie também a Chave Secreta para lá.

As chaves, em caso de perda, podem ser regeneradas (se isso acontecer, não esqueça de alterar os dados no projeto).

No campo Postback Url (2), especifique a url para webhooks https://chatter.salebot.pro/inxy_callback/result

Configurações de conexão

Em seguida, vá para a seção Mavibot → "Aquisição" → INXY e clique em conectar. Insira as chaves de API e Secreta recebidas nos campos.

seção "Aquisição" no Mavibot

Configurações do INXY na seção "Aquisição" no Mavibot

Gerando um link de pagamento

Para gerar um link de pagamento, você precisa definir o valor da variável payment_sum (por exemplo, 1). Depois disso, a variável inxy_pay_url aparecerá. Essa variável pode ser exibida com um link ou colocada no botão "Pagar".

ATENÇÃO!!! O sistema funciona com dólares! O valor especificado em payment_sum será aceito pelo sistema de pagamento INXY como dólares.

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

Além disso, antes de definir o valor da variável payment_sum, você pode definir as seguintes variáveis opcionais para configurar o pagamento: inxy_currency - a criptomoeda em que o pagamento será feito.

Você pode especificar uma das criptomoedas possíveis que você marcou ao criar a chave de API. Se deixar em branco, o pagador escolherá a criptomoeda entre as que foram marcadas..

Valores disponíveis: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'

inxy_description – descrição do pagamento

Atenção! Primeiro, variáveis adicionais são definidas para as configurações, depois payment_sum.

As variáveis podem ser definidas mais cedo na cadeia, em vez de todas em um único bloco. E a variável inxy_pay_url, que contém o link, deve ser exibida no local correto. Ao clicar nele, um formulário de pagamento será aberto.

Atenção! A linha do valor total contém um valor em dólares igual a payment_sum. Abaixo, no total em criptomoeda - está o valor na criptomoeda selecionada. Ele muda frequentemente dependendo da taxa de câmbio atual. Este é o valor que o cliente precisa lhe pagar da carteira dele.

Atenção!!! O endereço da carteira para pagamento, dentro de uma sessão, é reservado para o cliente por apenas 2 horas. Recomende ao cliente que ele/ela se certifique de que o tempo não expirou e que o endereço da carteira esteja atualizado no momento do pagamento. Se o tempo da sessão terminar, então você precisa reiniciar o processo de pagamento.

Processamento do resultado do pagamento (callback de pagamento)

Após um pagamento bem-sucedido, um callback será enviado ao bot, que informará 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á-las. Esse callback NÃO É VISTO pelo próprio usuário, ele é exibido apenas para o operador. O INXY tem vários tipos de callbacks:

1. Callbacks bem-sucedidos consistem nos primeiros 10 caracteres do token e no sufixo de sucesso, por exemplo: uc8zsjNN1x_success

Um callback de pagamento bem-sucedido em um diálogo com o cliente

Esse callback é recebido se o cliente tiver pago integralmente o valor e não houver problemas com o pagamento. Junto com esse callback, inxy_payment_completed será adicionada às variáveis do projeto, com o valor True. E também inxy_payment_status a variável assumirá o valor paid.

A variável inxy_payment_status pode mudar de valor durante todo o período de processamento do pagamento. Depois que o usuário abrir o formulário, ela assumirá o status waiting_payment, depois durante o processamento do pagamento assumirá o valor waiting_confirmation e, após o processamento bem-sucedido, terá o valor paid ou partially_paid.

Ao processar um callback, o tipo de comparação deve ser "Correspondência exata".

Por exemplo, você pode processar um pagamento bem-sucedido em um bloco condicional e exibir a mensagem correspondente ao usuário:

2. Há casos em que a taxa de câmbio da cripto mudou ou a carteira descontou uma comissão da operação, resultando em um valor incompleto creditado na sua conta. Nesse caso, a variável inxy_payment_status assumirá o valor partially_paid e um callback será enviado ao sistema.

Nesse caso, você precisará enviar uma notificação ao cliente solicitando um pagamento adicional.

Por exemplo, você pode definir uma condição para o início do callback e, depois de recebê-lo, enviar novamente ao cliente a URL já gerada com um link de pagamento, ou definir uma condição para que o bloco seja acionado quando a variável inxy_payment_status for igual a partially_paid.

Observe que o link de pagamento é somente válido por 2 horas! Se o cliente não tiver tempo de pagar a parte restante, ele/ela não poderá mais abri-lo. Como o INXY já processará o primeiro pagamento incompleto nesta etapa, o dinheiro não será reembolsado ao cliente. Para devolvê-lo, você precisará acessar sua conta pessoal no INXY e realizar uma operação de reembolso.

Criando assinatura

Assinaturas podem ser criadas no sistema INXY. Para isso, atribua qualquer valor à inxy_subscription_payment variável, e então uma assinatura mensal será criada.

Se você quiser especificar um período diferente, use as seguintes variáveis: inxy_subscription_interval igual a ‘day' - define o intervalo em dias (por padrão, é um mês) inxy_subscription_period - especifique um valor de 1 a 30 para definir a frequência.

Por exemplo, para criar uma cobrança de assinatura uma vez a cada 15 dias, você precisa definir inxy_subscription_interval =’day’ e inxy_subscription_period=15, e para que o pagamento seja cobrado a cada seis meses, você só precisa especificar inxy_subscription_period=6 (já que inxy_subscription_interval é um mês por padrão)

Ao seguir o link, o usuário verá a mesma página de pagamento, mas com algumas diferenças: primeiro, haverá uma observação na lateral indicando que o pagamento faz parte de uma assinatura com a frequência especificada; e segundo, a página de pagamento oferecerá ao cliente a opção de pagar duas ou três parcelas adiantadas.

Funcionalidades do sistema de pagamento INXY: Se o cliente pagar x2 ou x3 do valor, o Mavibot receberá uma notificação sobre o pagamento de apenas uma delas. O valor restante será enviado para o saldo do cliente, de onde será descontado nas cobranças subsequentes. Como a taxa de câmbio da criptomoeda está em constante mudança, esse valor pode não ser suficiente para a cobrança subsequente, o que levará a uma situação de assinatura parcialmente paga. Nesse caso, você receberá um callback “fail” e poderá configurar um lembrete para o cliente.

Não pode haver pagamento parcial de acordo com o cronograma. O saldo é verificado antes do pagamento e, se o saldo não for suficiente, o dinheiro não será debitado da conta do cliente.

Após a assinatura bem-sucedida, a inxy_subscription_id variável aparecerá nas variáveis do cliente, indicando o número da assinatura e inxy_subscription_status com seu status.

Cancelando assinatura

Para cancelar sua assinatura, use a função inxy_remove_subscription(inxy_subscription_id). Insira o ID da assinatura inxy_subscription_id na função, e a assinatura será cancelada.

Em caso de sucesso, você receberá um callback ‘Status da assinatura inxy_subscription_id - deleted’ e o inxy_subscription_status a variável mudará para o valor apropriado.