INXY Payments

Plataforma de criptoprocesamiento con funciones recurrentes

Registro

Después de registrarse en el servicio https://auth.inxy.io/, vaya a Payment gateway API en el menú lateral izquierdo y complete los siguientes datos: nombre y descripción de la cartera e icono. El enlace a su sitio es opcional. Seleccione todas las criptomonedas que desea aceptar con una casilla de verificación y haga clic en Guardar cambios

Después de guardar, se abrirá la ventana con los datos de conexión. A continuación, genere una clave API pulsando el botón Generate (1) e introduzca el código enviado a su correo electrónico. Guarde la variable resultante en un lugar seguro. Copie la Secret Key generada en el mismo lugar. Las claves, en caso de pérdida, pueden regenerarse (en este caso, recuerde cambiar los datos en el proyecto). Introduzca la URL para webhooks https://chatter.salebot.pro/inxy_callback/result en el campo Postback URL (2).

Configuración de la conexión

Luego vaya a Salebot — Sistemas de pago — INXY y pulse el botón Connect. Introduzca las claves API y Secret recibidas en los campos.

captura de pantalla de la conexión desde Salebot

Generación del enlace de pago

Para generar el enlace de pago, introduzca el valor de la variable payment_sum (p. ej.: 1); después de eso aparecerá la variable inxy_pay_url. Puede añadir esta variable en la pantalla como un enlace o ponerla en el botón Pay.

¡NOTA! ¡El sistema funciona con USD! El importe de la variable payment_sum se considera en USD en el sistema de pago INXY.

El enlace se ve así: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1

Además, antes de introducir el importe para la variable payment_sum, puede introducir lo siguiente variables opcionales para la configuración del pago inxy_currency — criptomoneda que se utilizará para el pago. Puede introducir una de las criptomonedas disponibles que haya elegido con una casilla de verificación durante la generación de la clave API. Si se deja vacío, los usuarios elegirán la criptomoneda ellos mismos de la lista de las seleccionadas. Valores disponibles: ‘BTC’,‘ETH’,‘LTC’,‘DOGE’,‘USDT’,‘USDC’,‘DAI’

inxy_description – descripción del pago.

¡NOTA! Primero introduce las variables opcionales para la configuración y luego payment_sum.

Las variables pueden introducirse antes en la cadena, y no en un solo bloque. Mientras que la variable inxy_pay_url, que incluye el enlace, debe mostrarse en el lugar correcto. Este enlace abre el formulario de pago.

¡NOTA! La línea Total amount muestra el valor en USD, que equivale a payment_sum. La línea Total crypto amount de abajo muestra el valor en la criptomoneda elegida. Varía según el tipo de cambio actual. Esta es la cantidad que su cliente tiene que pagarle desde su cartera.

¡NOTA! La dirección de la cartera para el pago durante una sola sesión queda reservada solo para el cliente durante 2 horas. Se recomienda al cliente asegurarse de que el tiempo no se haya agotado y de que la dirección de la cartera siga siendo válida cuando se realice el pago. Si el tiempo de la sesión se ha agotado, todo el proceso de pago deberá empezar de nuevo.

Callback de pago

Después del pago exitoso, el bot recibirá un callback que le indicará que el pago se realizó correctamente. Usted ve este callback en el sistema como un mensaje del usuario, para que el usuario no pueda enviarlo. Los usuarios NO PUEDEN VER el callback, solo el operador puede verlo. INXY tiene varios tipos de callbacks:

1. Los callbacks de éxito constan de los primeros 10 símbolos del token seguidos de ‘success’, p. ej.: uc8zsjNN1x_success

Este callback se envía si el cliente pagó el importe total y no surgió ningún problema durante el pago. Junto con este callback se añadirán dos variables al proyecto: inxy_payment_completed igual a True; y inxy_payment_status con el valor pagado.

Durante el proceso, la inxy_payment_status variable cambia su valor. Después de que el usuario abra el formulario cambiará a waiting_payment, durante el procesamiento del pago cambiará a waiting_confirmation, y después del procesamiento exitoso tendrá el valor paid o partially_paid.

Durante el procesamiento del callback, el tipo de comparación debe ser Full match. Por ejemplo: puede hacer el procesamiento del pago exitoso como un bloque con condición y mostrar un mensaje relevante al usuario:

2. A veces los tipos de cambio de las criptomonedas cambian o las carteras cobran una comisión adicional por las operaciones, de modo que el importe resultante que ha recibido no es completo. En tales casos, la variable inxy_payment_status tendrá el valor partially_paid y el sistema recibirá un callback que se verá así:

En este caso tendrá que enviar al cliente un mensaje solicitando que cubra el importe faltante. Por ejemplo: puede establecer una condición para el inicio de su callback y, al recibirlo, enviar al cliente una URL pregenerada con un enlace de pago o puede establecer una condición para que el bloque se active cuando el valor de la variable inxy_payment_status sea partially_paid.

¡Recuerde que el enlace de pago solo es válido durante 2 horas! Si el cliente no realiza el pago del importe faltante a tiempo, no se podrá abrir. Como INXY en esta etapa procesará el primer pago parcial, el dinero no se devolverá al cliente. Para devolverlo, deberá ir a su cuenta de INXY y realizar la operación de reembolso.

Creación de suscripción

El sistema INXY permite a los usuarios crear suscripciones. Para ello, añada cualquier valor a inxy_subscription_payment la variable, y se creará una suscripción mensual. Si desea establecer un período diferente, utilice las siguientes variables: inxy_subscription_interval igual a ‘day’ — creará un intervalo de suscripción igual a días (el valor predeterminado es month) inxy_subscription_period — añada una variable igual de 1 a 30 para establecer el período. Ej.: para crear un pago de suscripción una vez cada 15 días, establezca inxy_subscription_interval =‘day’ e inxy_subscription_period=15, y para que el pago se realice dos veces al año establezca inxy_subscription_period=6 (ya que inxy_subscription_interval equivale a month por defecto)

El enlace también abrirá el formulario de pago, pero será diferente: primero, en un lateral se mostrará que el pago es basado en suscripción con el período indicado; segundo, el formulario sugerirá al cliente añadir un depósito para varios pagos por adelantado.

Especificidades de INXY: Si el cliente paga х2 o х3 del importe, Salebot recibirá un mensaje sobre un importe único. El resto se depositará en el saldo del cliente y se utilizará para los próximos pagos. Como el tipo de cambio de la criptomoneda varía, al final este importe puede ser insuficiente para uno de los siguientes pagos, lo que dará lugar a una suscripción impagada. En tal caso, recibirá un callback que indicará ‘fail’ y podrá configurar un recordatorio para su cliente.

La suscripción no puede pagarse parcialmente. El saldo del cliente se comprueba antes del pago. Si no hay fondos suficientes, el pago no se realiza en absoluto.

Después de la suscripción exitosa, las variables del cliente incluirán inxy_subscribtion_id (número de referencia) e inxy_subscription_status.

Cancelación de suscripción

Para cancelar una suscripción, use la siguiente función inxy_remove_subscription(inxy_subscription_id). Introduzca el número de id de la suscripción como inxy_subscribtion_id en la función y la suscripción será cancelada.

En caso de éxito recibirá un callback ‘Subscription status inxy_subscription_id - deleted’ y la variable inxy_subscription_status cambiará al valor correspondiente.