INXY payments
Регистрация
После регистрации в сервисе https://auth.inxy.io/ перейдите в меню Payment gateway API и заполните следующую информацию:
Название и описание кошелька, иконка.
Ссылку на сайт можно указать по вашему желанию.
Необходимо отметить все принимаемые типы криптовалют и нажать Save Changes
После сохранения откроется поле с данными для подключения.
Далее сгенерируйте API key, нажав Generate(1), и введите код, отправленный на вашу почту.
Полученную переменную следует сохранить в безопасном месте. Также скопируйте туда Secret Key.
Ключи в случае утери можно сгенерировать заново (если это произойдет, не забудьте изменить данные в проекте).
В поле Postback Url (2) укажите url для webhooks https://chatter.salebot.pro/inxy_callback/result
Настройки подключения
Затем перейдите в раздел Mavibot → "Acquiring" → INXY и нажмите подключить. Введите полученные API и Secret keys в поля.
Генерация ссылки на оплату
Чтобы сгенерировать ссылку на оплату, нужно задать значение переменной payment_sum (например, 1). После этого появится переменная inxy_pay_url. Эту переменную можно вывести ссылкой или разместить на кнопке "Pay".
ВНИМАНИЕ!!! Система работает с долларами! Указанная сумма в payment_sum будет принята платежной системой INXY как доллары.
Ссылка выглядит так: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1
Также, до установки значения переменной payment_sum, можно задать следующие дополнительные переменные для настройки платежа: inxy_currency - криптовалюта, в которой будет произведен платеж.
Вы можете указать одну из доступных криптовалют, которые вы отметили при создании API key. Если оставить поле пустым, плательщик сможет выбрать криптовалюту из отмеченных..
Доступные значения: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'
inxy_description – описание платежа
Обратите внимание! Сначала для настроек задаются дополнительные переменные, затем payment_sum.
Переменные можно задавать раньше в цепочке, а не все в одном блоке. А переменную inxy_pay_url, которая содержит ссылку, следует вывести в нужном месте. При нажатии на нее откроется форма оплаты.
Обратите внимание! В строке общей суммы содержится долларовое значение, равное payment_sum. Ниже в общей сумме в криптовалюте — значение в выбранной криптовалюте. Оно часто меняется в зависимости от текущего курса. Именно эту сумму клиент должен заплатить вам со своего кошелька.
Обратите внимание!!! Адрес кошелька для оплаты в рамках одной сессии резервируется за клиентом только на 2 часа. Рекомендуйте клиенту убедиться, что время не истекло и адрес кошелька актуален на момент оплаты. Если время сессии вышло, потребуется заново начать процесс оплаты.
Обработка результата платежа (payment callback)
После успешной оплаты в бота будет отправлен callback, который сообщит вам, что оплата прошла успешно. Вы видите этот callback в системе как сообщение от пользователя, чтобы пользователь не мог отправлять их. Этот callback НЕ ВИДЕН самому пользователю, он отображается только оператору. У INXY есть несколько типов callback:
Успешные callback состоят из первых 10 символов токена и постфикса success, например: uc8zsjNN1x_success
Этот callback приходит, если клиент полностью оплатил сумму и с платежом нет проблем. Вместе с этим callback, inxy_payment_completed переменная будет добавлена в переменные проекта и будет иметь значение True. А также inxy_payment_status переменная примет значение paid.
Переменная inxy_payment_status может менять свое значение в течение всего периода обработки платежа. После того как пользователь откроет форму, она примет статус waiting_payment, затем в процессе обработки его платежа — значение waiting_confirmation, а после успешной обработки — paid или partially_paid.
При обработке callback тип сравнения должен быть "Exact Match".
Например, вы можете обработать успешную оплату в условном блоке и показать пользователю соответствующее сообщение:
2. Бывают случаи, когда курс криптовалюты изменился или кошелек удержал комиссию за операцию, в результате чего на ваш счет зачисляется неполная сумма. В этом случае переменная inxy_payment_status примет значение partially_paid, и в систему будет отправлен callback.
В этом случае вам потребуется отправить клиенту уведомление с просьбой доплатить сумму.
Например, можно задать условие на начало callback и после его получения снова отправить клиенту уже сгенерированный url со ссылкой на оплату, либо задать условие, при котором блок срабатывает, когда переменная inxy_payment_status равна partially_paid.
Обратите внимание, что ссылка на оплату только действительна в течение 2 часов! Если клиент не успеет оплатить оставшуюся часть, он/она больше не сможет ее открыть. Поскольку INXY уже обработает первый неполный платеж на этом этапе, деньги не будут возвращены клиенту. Чтобы вернуть их, вам нужно будет зайти в свой личный кабинет INXY и выполнить операцию возврата.
Создание подписки
Подписки можно создавать в системе INXY. Для этого присвойте любое значение переменной inxy_subscription_payment , после чего будет создана ежемесячная подписка.
Если вы хотите указать другой период, используйте следующие переменные: inxy_subscription_interval равно ‘day' - задает интервал в днях (по умолчанию — месяц) inxy_subscription_period - укажите значение от 1 до 30, чтобы задать частоту.
Например, чтобы создать списание по подписке раз в 15 дней, нужно задать inxy_subscription_interval =’day’ и inxy_subscription_period=15, а чтобы платеж списывался каждые шесть месяцев, достаточно указать inxy_subscription_period=6 (так как inxy_subscription_interval по умолчанию — месяц)
При переходе по ссылке пользователь увидит ту же страницу оплаты, но с некоторыми отличиями: во-первых, сбоку будет примечание, что платеж является частью подписки с указанной периодичностью; и во-вторых, на странице оплаты клиенту будет предложена возможность оплатить сразу две или три суммы вперед.
Особенности платежной системы INXY: Если клиент оплатит x2 или x3 суммы, Mavibot получит уведомление об оплате только одной из них. Оставшаяся сумма будет зачислена на баланс клиента, откуда она будет списываться при последующих списаниях. Поскольку курс криптовалюты постоянно меняется, в результате этой суммы может не хватить для последующего списания, что приведет к ситуации с неполностью оплаченной подпиской. В этом случае вы получите callback “fail”, и можете настроить напоминание клиенту.
Частичной оплаты по графику быть не может. Баланс проверяется перед оплатой, и если средств недостаточно, деньги не будут списаны со счета клиента.
После успешной подписки переменная inxy_subscription_id появится в переменных клиента, указывая номер подписки, и inxy_subscription_status с ее статусом.
Отмена подписки
Чтобы отменить подписку, используйте функцию inxy_remove_subscription(inxy_subscription_id). Вставьте в функцию ID подписки inxy_subscription_id, и подписка будет отменена.
В случае успеха вы получите callback ‘Subscription status inxy_subscription_id - deleted’ и inxy_subscription_status переменная изменится на соответствующее значение.
Последнее обновление