INXY payments

Registration

After registering in the service https://auth.inxy.io/ arrow-up-right go to the Payment gateway API menu and fill in the following information:

  1. Wallet name and description, icon.

  2. The link to the website is placed at your request.

All accepted types of cryptocurrencies should be ticked and click Save Changes

After saving, a communication data field will open.

Next, generate an API key by clicking Generate(1) and enter the code sent to your email.

The received variable should be stored in a secure location. Also copy the Secret Key there.

circle-check

In the Postback Url (2) field, specify the url for webhooks https://chatter.salebot.pro/inxy_callback/result

Connection settings

Then go to Mavibot → "Acquiring" section → INXY and click connect. Enter the received API and Secret keys into the fields.

"Acquiring" section in Mavibot
INXY settings in " Acquiring" section in Mavibot

To generate a payment link, you need to set the value of the payment_sum variable (for example, 1). After that, the inxy_pay_url variable will appear. This variable can be displayed with a link or placed in the "Pay" button.

circle-exclamation

The link looks like: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1 arrow-up-right

Also, before setting the value of the payment_sum variable, you can set the following optional variables for setting up the payment: inxy_currency - the cryptocurrency in which the payment will be made.

circle-info

You can specify one of the possible cryptocurrencies that you ticked when creating the API key. If you leave it blank, then the payer will choose the cryptocurrency from those that have been marked..

Available values: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'

inxy_description – payment description

circle-exclamation

Variables can be set earlier in the chain, rather than all in one block. And inxy_pay_url variable, which contains the link, should be displayed in the right place. When you click on it, a payment form will open.

circle-exclamation
circle-exclamation

Payment result processing (payment callback)

After a successful payment, a callback will be sent to the bot, which will let you know that the payment was successful. You see this callback in the system as a message from the user, so that the user cannot send them. This callback is NOT SEEN by the user himself, it is displayed only to the operator. INXY has several types of callbacks:

  1. Successful callbacks consist of the first 10 characters of the token and the success postscript, for example: uc8zsjNN1x_success

A successful payment callback in a dialogue with the client

This callback is received if the client has fully paid the sum and there are no problems with the payment. Along with this callback, inxy_payment_completed variable will be added to the project variables, which is set to True. And also inxy_payment_status variable will take the value paid.

circle-exclamation

When processing a callback, the comparison type should be "Exact Match".

For example, you can process a successful payment in a conditional block and display the corresponding message to the user:

2. There are cases when the crypto exchange rate has changed or the wallet has withdrawn a commission from the operation, as a result of which an incomplete amount is credited to your account. In this case, the inxy_payment_status variable will take the partially_paid value and a callback will be sent to the system.

In this case, you will need to send a notification to the client requesting an additional payment.

For example, you can set a condition for the callback start and, after getting it, send the already generated url with a payment link to the client again, or set a condition that the block is triggered when the inxy_payment_status variable is equal to partially_paid.

circle-exclamation

Creating Subscription

Subscriptions can be created in the INXY system. To do this, assign any value to the inxy_subscription_payment variable, and then a monthly subscription will be created.

If you want to specify a different period, use the following variables: inxy_subscription_interval equal to ‘day' - sets the interval equal to days (by default, it is a month) inxy_subscription_period - specify a variable from 1 to 30 to set the frequency.

For example, to create a subscription charge once every 15 days, you need to set inxy_subscription_interval =’day’ and inxy_subscription_period=15,and to have the payment charged every six months, you just need to specify inxy_subscription_period=6 (since inxy_subscription_interval is a month by default)

When following the link, the user will see the same payment page, but with a few differences: first, there will be a note on the side indicating that the payment is part of a subscription with the specified frequency; and second, the payment page will offer the customer the option to pay two or three sums in advance.

circle-exclamation
circle-exclamation

After successful subscription, the inxy_subscription_id variable will appear in the client variables, indicating the subscription number and inxy_subscription_status with its status.

Canceling subscription

To cancel your subscription, use the function inxy_remove_subscription(inxy_subscription_id). Insert the inxy_subscription_id subscription ID into the function, and the subscription will be canceled.

In case of success, you will receive a callback ‘Subscription status inxy_subscription_id - deleted’ and the inxy_subscription_status variable will change to the appropriate value.

Last updated