# Pagamentos INXY

## Registro

Após se registrar no serviço [https://auth.inxy.io/ ](<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

<figure><img src="/files/6b647c32055c93ff01690d2f72d94f89359d440a" alt=""><figcaption></figcaption></figure>

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

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

{% hint style="success" %}
As chaves, em caso de perda, podem ser regeneradas (se isso acontecer, não esqueça de alterar os dados no projeto).
{% endhint %}

No campo Postback Url (2), especifique a url para webhooks <https://chatter.salebot.pro/inxy\\_callback/result>

<figure><img src="/files/98c43b8cf5fba49a93cac0c982545b7500ed626a" alt=""><figcaption></figcaption></figure>

## Configurações de conexão&#x20;

Em seguida, vá para a seção Mavibot → "Aquisição" → INXY e clique em <mark style="color:padrão;background-color:blue;">**conectar**</mark>. Insira as chaves de API e Secreta recebidas nos campos.

<figure><img src="/files/78e6c51ed1b8c99e382f67f355abb1f1354b09ae" alt=""><figcaption><p>seção "Aquisição" no Mavibot </p></figcaption></figure>

<figure><img src="/files/3e5040038aa981bb9db1d116d3138672b09b520c" alt=""><figcaption><p>Configurações do INXY na seção "Aquisição" no Mavibot</p></figcaption></figure>

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

{% hint style="warning" %} <mark style="color:vermelho;">**ATENÇÃO!!!**</mark> O sistema funciona com dólares! O valor especificado em payment\_sum será aceito pelo sistema de pagamento INXY como dólares.
{% endhint %}

O link é assim: [https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1 ](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.

{% hint style="info" %}
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..&#x20;
{% endhint %}

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

<figure><img src="/files/6de7a287d800ee790cf1602d5027796fcf5c67eb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/1c50a9ec46cdf3e52e80aa37b61c4c7749ded2d3" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:vermelho;">**Atenção**</mark>! Primeiro, variáveis adicionais são definidas para as configurações, depois payment\_sum.
{% endhint %}

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.

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

{% hint style="warning" %} <mark style="color:vermelho;">**Atenção!**</mark> 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.
{% endhint %}

<figure><img src="/files/62d237d92dd4818031dc35c2fe1899dc32e35afa" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:vermelho;">**Atenção!!!**</mark> 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.
{% endhint %}

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

<figure><img src="/files/2b029fb3c06bb38de1cc832a7f2bb6d602196701" alt=""><figcaption><p>Um callback de pagamento bem-sucedido em um diálogo com o cliente</p></figcaption></figure>

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.

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

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:

<figure><img src="/files/0052c70b74fd1ff47d66041146a657be2f9a3ff6" alt=""><figcaption></figcaption></figure>

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.

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

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.

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

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

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

<figure><img src="/files/21d7322e88ccaab511546b801ac39b19a6784d53" alt=""><figcaption></figcaption></figure>

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.

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

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

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

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.

<figure><img src="/files/ec171e7dbb9522bdf992d236e392d82ac3786054" alt="" width="385"><figcaption></figcaption></figure>

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

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

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.

<figure><img src="/files/0887b744ab77c6e0a31de33b056bd8880d3a25b0" 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/pagamento/pagamentos-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.