# INXY payments

## Registro

Después de registrarse en el servicio [https://auth.inxy.io/ ](<https://auth.inxy.io/ >) vaya al menú de la API de la pasarela de pago y complete la siguiente información:

1. Nombre y descripción de la billetera, icono.
2. El enlace al sitio web se coloca a petición suya.

Debe marcarse todos los tipos de criptomonedas aceptados y hacer clic en Guardar cambios

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

<figure><img src="/files/80dd0f8f946c78ab75b4b014300213c908a46219" alt=""><figcaption></figcaption></figure>

Después de guardar, se abrirá un campo de datos de comunicación.

A continuación, genere una clave API haciendo clic en Generar(1) e ingrese el código enviado a su correo electrónico.

La variable recibida debe almacenarse en un lugar seguro. Copie también allí la Clave secreta.

{% hint style="success" %}
Las claves, en caso de pérdida, pueden regenerarse (si esto ocurre, no olvide cambiar los datos en el proyecto).
{% endhint %}

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

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

## Configuración de conexión&#x20;

Luego vaya a Mavibot → sección "Acquiring" → INXY y haga clic en <mark style="color:predeterminado;background-color:blue;">**conectar**</mark>. Ingrese las claves API y Secreta recibidas en los campos.

<figure><img src="/files/ae6a4a931a54638e00bf1858202a98353bf541de" alt=""><figcaption><p>sección "Acquiring" en Mavibot </p></figcaption></figure>

<figure><img src="/files/8745b9edb392975f86c8451fe9bd35fa0c60db5c" alt=""><figcaption><p>Configuración de INXY en la sección "Acquiring" en Mavibot</p></figcaption></figure>

## Generación de un enlace de pago

Para generar un enlace de pago, debe establecer el valor de la variable payment\_sum (por ejemplo, 1). Después de eso, aparecerá la variable inxy\_pay\_url. Esta variable puede mostrarse con un enlace o colocarse en el botón "Pagar".

{% hint style="warning" %} <mark style="color:rojo;">**¡PRESTE ATENCIÓN!!!**</mark> ¡El sistema funciona con dólares! El importe especificado en payment\_sum será aceptado por el sistema de pagos INXY como dólares.
{% endhint %}

El enlace se ve así: [https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1 ](https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1)

Además, **antes de establecer el valor de la variable payment\_sum**, puede configurar las siguientes **variables opcionales** para configurar el pago:\
**inxy\_currency** - la criptomoneda en la que se realizará el pago.

{% hint style="info" %}
Puede especificar una de las posibles criptomonedas que marcó al crear la clave API. Si lo deja en blanco, el pagador elegirá la criptomoneda entre las que se hayan marcado.&#x20;
{% endhint %}

Valores disponibles: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'

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

**inxy\_description** – descripción del pago

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

{% hint style="warning" %} <mark style="color:rojo;">**Presta atención**</mark>¡ Primero, se establecen variables adicionales para la configuración, luego payment\_sum.
{% endhint %}

Las variables pueden establecerse antes en la cadena, en lugar de todas en un solo bloque. Y la variable inxy\_pay\_url, que contiene el enlace, debe mostrarse en el lugar correcto. Cuando haga clic en ella, se abrirá un formulario de pago.

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

{% hint style="warning" %} <mark style="color:rojo;">**¡Atención!**</mark> La línea del importe total contiene un valor en dólares igual a payment\_sum. Debajo, en importe total en cripto, está el valor en la criptomoneda seleccionada. Cambia con frecuencia según el tipo de cambio actual. Este es el valor que el cliente debe pagarle desde su billetera.
{% endhint %}

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

{% hint style="warning" %} <mark style="color:rojo;">**¡Preste atención!!!**</mark> La dirección de la billetera para el pago, dentro de una misma sesión, queda reservada para el cliente solo durante 2 horas. Recomendamos al cliente que se asegure de que el tiempo no haya expirado y de que la dirección de la billetera siga vigente en el momento del pago. Si el tiempo de la sesión termina, deberá reiniciar el proceso de pago.
{% endhint %}

## Procesamiento del resultado del pago (callback de pago)

Después de un pago exitoso, se enviará un callback al bot, que le informará que el pago fue exitoso. Usted ve este callback en el sistema como un mensaje del usuario, para que el usuario no pueda enviarlos. Este callback NO LO VE el propio usuario, solo se muestra al operador. INXY tiene varios tipos de callbacks:

1. Los callbacks exitosos constan de los primeros 10 caracteres del token y del sufijo de éxito, por ejemplo: uc8zsjNN1x\_success

<figure><img src="/files/46e9303bfc158d8e847249c49246fe0c816153cd" alt=""><figcaption><p>Un callback de pago exitoso en una conversación con el cliente</p></figcaption></figure>

Este callback se recibe si el cliente ha pagado completamente la suma y no hay problemas con el pago. Junto con este callback, **inxy\_payment\_completed** se añadirá a las variables del proyecto, donde se establece en True. Y además **inxy\_payment\_status** la variable tendrá el valor paid.

{% hint style="warning" %}
La variable inxy\_payment\_status puede cambiar su valor durante todo el período de procesamiento del pago. Después de que el usuario abra el formulario, tomará el estado waiting\_payment, luego durante el procesamiento de su pago tomará el valor waiting\_confirmation, y después del procesamiento exitoso tendrá el valor paid o partially\_paid.
{% endhint %}

Al procesar un callback, el tipo de comparación debe ser "Coincidencia exacta".

Por ejemplo, puedes procesar un pago exitoso en un bloque condicional y mostrar el mensaje correspondiente al usuario:

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

2\. Hay casos en los que el tipo de cambio de la criptomoneda ha cambiado o la billetera ha cobrado una comisión por la operación, como resultado de lo cual se acredita a su cuenta un importe incompleto. En este caso, la variable inxy\_payment\_status tomará el valor partially\_paid y se enviará un callback al sistema.

<figure><img src="/files/5db216da3aba1de71a26b2c78aa9f96b85ecfcc9" alt=""><figcaption></figcaption></figure>

En este caso, deberá enviar una notificación al cliente solicitando un pago adicional.

Por ejemplo, puede establecer una condición para el inicio del callback y, después de recibirlo, enviar nuevamente al cliente la url ya generada con un enlace de pago, o establecer una condición para que el bloque se active cuando la variable inxy\_payment\_status sea igual a partially\_paid.

<figure><img src="/files/9d4838a63ea15d35869d7f3ecec698556b7c5181" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Tenga en cuenta que el enlace de pago **solo** es válido **¡durante 2 horas!** Si el cliente no tiene tiempo para pagar la parte restante, ya no podrá abrirlo. Dado que INXY ya procesará el primer pago incompleto en esta etapa, el dinero no será reembolsado al cliente. Para devolverlo, deberá ir a su cuenta personal de INXY y realizar una operación de reembolso.
{% endhint %}

## Creación de suscripción

Las suscripciones se pueden crear en el sistema INXY. Para ello, asigne cualquier valor a la **inxy\_subscription\_payment** variable, y luego se creará una suscripción mensual.

Si desea especificar un período diferente, use las siguientes variables: **inxy\_subscription\_interval** igual a ‘day' - establece el intervalo en días (por defecto, es un mes)\
**inxy\_subscription\_period** - especifique una variable de 1 a 30 para establecer la frecuencia.

Por ejemplo, para crear un cargo de suscripción una vez cada 15 días, debe establecer inxy\_subscription\_interval =’day’ e inxy\_subscription\_period=15, y para que el pago se cobre cada seis meses, solo necesita especificar inxy\_subscription\_period=6 (ya que inxy\_subscription\_interval es un mes por defecto)

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

Al seguir el enlace, el usuario verá la misma página de pago, pero con algunas diferencias: en primer lugar, habrá una nota al lado indicando que el pago forma parte de una suscripción con la frecuencia especificada; y en segundo lugar, la página de pago ofrecerá al cliente la opción de pagar dos o tres sumas por adelantado.

{% hint style="warning" %}
C**aracterísticas del sistema de pago INXY:** Si el cliente paga x2 o x3 de la suma, Mavibot recibirá una notificación sobre el pago de solo una de ellas. La suma restante se enviará al saldo del cliente, de donde se descontará en débitos posteriores. Dado que el tipo de cambio de la criptomoneda cambia constantemente, como resultado, esta suma puede no ser suficiente para el débito posterior, lo que dará lugar a una situación de suscripción parcialmente pagada. En este caso, recibirá un callback “fail” y podrá configurar un recordatorio para el cliente.
{% endhint %}

{% hint style="warning" %}
No puede haber pago parcial según el calendario. El saldo se comprueba antes del pago, y si el saldo no es suficiente, el dinero **no se debitará** de la cuenta del cliente.
{% endhint %}

<figure><img src="/files/067101923d3359689b88d0e72c8e71c20e801215" alt=""><figcaption></figcaption></figure>

Después de una suscripción exitosa, la **inxy\_subscription\_id** variable aparecerá en las variables del cliente, indicando el número de suscripción y **inxy\_subscription\_status** con su estado.

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

## Cancelación de suscripción

Para cancelar su suscripción, use la función **inxy\_remove\_subscription(inxy\_subscription\_id)**. Inserte en la función el ID de suscripción inxy\_subscription\_id, y la suscripción se cancelará.

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

En caso de éxito, recibirá un callback **‘Subscription status inxy\_subscription\_id - deleted’** y el **inxy\_subscription\_status** la variable cambiará al valor correspondiente.

<figure><img src="/files/ff8c3e9de244399428ec0897001af6daa20af1f5" 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/es/pago/inxy-payments.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.