# INXY Payments

## 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

<br>

<figure><img src="/files/653fb1b24caa6798854c058454a74d66beaf2eee" alt=""><figcaption></figcaption></figure>

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).

<br>

<figure><img src="/files/d54cf2b65e81cb46ce05a1dbe20130a798e575c8" alt=""><figcaption></figcaption></figure>

## 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.

{% hint style="warning" %} <mark style="color:vermelho;">**ATENÇÃO!**</mark> O sistema funciona com USD! O valor na variável payment\_sum é considerado como USD no sistema de pagamento INXY.
{% endhint %}

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

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’

<figure><img src="/files/e085243f5d0c95d1689db2e160e26640bcd52e04" alt=""><figcaption></figcaption></figure>

**inxy\_description** – descrição do pagamento.

<figure><img src="/files/cb77eb8596bf721ddef1977a0e33e482d6be8dcb" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:vermelho;">**ATENÇÃO!**</mark> Primeiro você insere variáveis opcionais para a configuração e depois a payment\_sum.
{% endhint %}

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.

<figure><img src="/files/e1b278ffd6b77960171949f84382e21a7a062a15" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:vermelho;">**ATENÇÃO!**</mark> 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.
{% endhint %}

<figure><img src="/files/0beac98b1d3c5779c4f96ff8ff3ee86c1229eaa1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:vermelho;">**ATENÇÃO!**</mark> 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.
{% endhint %}

## 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

<figure><img src="/files/c9d93c0cee4c06ec99552b7b5d9324d00c543e29" alt=""><figcaption></figcaption></figure>

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.

{% hint style="warning" %}
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.
{% endhint %}

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:

<figure><img src="/files/dbf82d173fae3ce94fee62b53e8a3c8a61e7fa9b" alt=""><figcaption></figcaption></figure>

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**.

<figure><img src="/files/ec7d08de08b1afe54f0530a6d55507e445097076" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
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.
{% endhint %}

## 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)

<figure><img src="/files/dd1fa6ce0b1fe1454cad3ce110f7c729c0d8ef2c" alt=""><figcaption></figcaption></figure>

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.

{% hint style="warning" %}
**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.
{% endhint %}

{% hint style="warning" %}
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.
{% endhint %}

<figure><img src="/files/081a0cb82cb436e5bac8502a07d103a6ac2ab742" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/f417b33821307de43ca67792a06c5744ab6e199c" alt=""><figcaption></figcaption></figure>

## 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.

<figure><img src="/files/dd386faf94f9104d665070ecb67a85b17e6af654" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/814b2fb9bab17ab892d8fb30ec56aef0c88f8802" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/integrations/payment/inxy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.