4. Ссылки и статусы оплаты
Ссылки и статусы оплаты
Приложение предоставляет агенту два действия: создать ссылку на оплату и проверить сохранённый статус заказа.
Создание ссылки
Инструмент создания ссылки использует аккаунт, позиции и цены из настроек экземпляра инструмента. Senler автоматически передаёт контекст проекта, агента, канала, диалога и лида; эти служебные значения не нужно запрашивать у клиента.
Приложение создаёт собственный order_id, отправляет его в Prodamus как номер заказа и возвращает агенту платёжную ссылку. Статус pending означает, что ссылка создана, но подтверждённое уведомление об оплате ещё не получено. Такой заказ может оставаться в ожидании, если клиент открыл ссылку и не оплатил её.
Подтверждение оплаты
Переход клиента на страницу успешной оплаты не используется как доказательство. Приложение меняет статус только после подписанного webhook от Prodamus, сверяя магазин, номер заказа, подпись и сумму.
После подтверждения приложение отправляет сообщение об оплате в тот же диалог Senler. Если доставка сообщения временно не удалась, подтверждённый платёж не теряется, а Prodamus получает ответ для повторной доставки webhook.
Проверка статуса
Инструмент проверки возвращает сохранённые order_id, status, paid, сумму и платёжную ссылку. Он не опрашивает Prodamus при каждом вызове.
Для проверки агент передаёт order_id, который вернул инструмент создания ссылки. Приложение не выбирает заказ из истории диалога автоматически.