Как подключить оплату Multicard к сайту и принимать Uzcard и Humo

13 ноября 2026 г. · 12 минут чтения

Чтобы подключить Multicard к сайту, нужны договор с Multicard и активная касса, ключи доступа, которые выдаёт Multicard, коды товаров для электронного чека и код на сервере сайта. Сервер создаёт счёт, отправляет покупателя на страницу оплаты Multicard и принимает подтверждение. Карту покупатель вводит на странице Multicard, сайт её данных не видит и не хранит. Заказ считается оплаченным, когда сервер сайта сам перепроверил платёж у Multicard, а не когда покупатель вернулся на сайт.

Мы подключали Multicard интернет-магазину Dyson Store Uzbekistan в Ташкенте. Ниже порядок подключения, путь платежа и места, где онлайн-оплата обычно ломается. Цифры взяты из тестов и журнала этого магазина.

11 днейот начала работ 3 октября 2026 года до первой настоящей оплаты 14 октября
209 товаровполучили код для электронного чека
15 минуттовар закреплён за покупателем, пока он платит: столько действует счёт
365 днейхранится журнал оплаты: по номеру заказа видна вся цепочка от счёта до возврата

Что нужно, чтобы подключить Multicard к сайту

От владельца бизнеса нужно четыре вещи.

  1. Договор с Multicard. Список документов для договора даёт менеджер Multicard: в открытой документации его нет, и мы его не пересказываем.
  2. Касса. Это ваш магазин в системе Multicard. Номер кассы выдаёт Multicard, он передаётся в каждом счёте.
  3. Ключи доступа. Их выдаёт Multicard, по ним сервер сайта подтверждает, что счёт создаёт именно ваш магазин. Наборов два: тестовый и боевой (для настоящих платежей).
  4. Коды товаров для чека. По документации Multicard в счёте обязателен список позиций для чека: название, количество, цена, сумма, код ИКПУ (код товара из налогового каталога) и код упаковки.

От разработчика нужен серверный код. Готовой кнопки, которую достаточно вставить на страницу своего сайта, нет: счёт создаёт сервер, он же принимает уведомление об оплате.

В нашем проекте от первого дня работы до первой настоящей оплаты прошло 11 дней: с 3 по 14 октября 2026 года. В срок вошли серверная часть, страницы оформления и результата, возвраты, тесты и подбор кодов товаров. На срок сильнее всего влияет не код: договор, активация кассы и коды товаров зависят от владельца и от Multicard. Начинайте их одновременно с разработкой, а не после.

Ключи ещё не значат, что оплата работает. 13 октября у нас были верные боевые ключи, но касса на стороне Multicard ещё не была активна, и счёт не создавался. На следующий день кассу активировали, и магазин начал принимать настоящие платежи. Спросите у менеджера Multicard отдельно: активна ли касса.

Обязательны ли коды ИКПУ для онлайн-оплаты

Да. Чек онлайн-кассы пробивается с кодом ИКПУ для каждого товара: этого требует Налоговый комитет, а в Multicard поля кода товара и кода упаковки обязательны.

У магазина 209 товаров. Коды мы подбирали по каталогу налоговой, часть кодов потребовала проверки бухгалтера. Окончательные коды подтверждает бухгалтер магазина. Каталог открывался только с сервера в Узбекистане: о таком лучше знать до начала работы.

Перед созданием счёта сервер сверяет сумму позиций чека с суммой счёта. Не совпали, и счёт не создаётся: чек с неправильной суммой хуже отказа.

Как принимать оплату Uzcard и Humo на сайте

Принимать карты Uzcard и Humo на сайте можно через платёжный сервис, который работает с банками за вас: Multicard, Click, Payme и другие. У Multicard нужны договор, активная касса, коды ИКПУ для чеков и серверная часть сайта, которая создаёт счёт и проверяет оплату. Код ИКПУ в чеке онлайн-кассы нужен с любым сервисом: это требование Налогового комитета, о нём сказано выше.

По документации Multicard он принимает Uzcard, Humo, Visa и Mastercard, а также оплату через приложения, среди которых Payme, Click и Uzum. Какие способы увидит ваш покупатель, зависит от того, что включено вашей кассе. В проекте мы проверяли оплату картой Uzcard.

Как проходит платёж через Multicard: от кнопки до «оплачено»

  1. Покупатель нажимает «Перейти к оплате». Сумму сервер считает сам по ценам из своей базы: сумму из браузера можно подменить. Товар закрепляется за покупателем на 15 минут, чтобы последнюю единицу не купил другой.
  2. Сервер создаёт счёт в Multicard с суммой и позициями чека и получает ссылку на страницу оплаты. В нашем магазине счёт действует те же 15 минут.
  3. Покупатель платит на странице Multicard. Карту и код из SMS он вводит там.
  4. Сервер получает уведомление об оплате и перепроверяет его. Отдельным запросом спрашивает у Multicard: платёж действительно прошёл, на эту сумму, по этой кассе? Только после ответа заказ отмечается оплаченным, покупатель видит «Оплата подтверждена», а менеджеры получают сообщение в Telegram.

Страница оплаты открывается на адресе платёжного сервиса, а не магазина. Покупателя незнакомый адрес настораживает, поэтому предупредите его заранее: назовите сервис, чтобы покупатель мог сверить с его названием адрес страницы. В магазине перед переходом написано: «Оплата на защищённой странице Multicard. Статус заказа подтвердит магазин после оплаты».

Почему возврат покупателя на сайт не подтверждает оплату

Возврат покупателя на страницу «спасибо за покупку» ничего не доказывает: этот адрес можно открыть вручную, ничего не заплатив. Бывает и наоборот: покупатель заплатил, закрыл вкладку и на сайт не вернулся.

Уведомлению от платёжной системы тоже нельзя верить на слово: адрес, на который оно приходит, открыт всему интернету. Для сервера уведомление только повод проверить, поэтому он сам идёт в Multicard и сверяет платёж.

Отвечать на уведомление нужно честно. Документация Multicard описывает три исхода: сайт ответил «успех», и платёж завершён; сайт ответил отказом, и деньги вернутся покупателю; сайт не ответил или упал, и деньги могут остаться заблокированными на карте. Поэтому сервер сначала надёжно сохраняет уведомление и только потом отвечает. Не удалось сохранить, он не говорит «принято».

Где ломается онлайн-оплата и что мы сделали

Каждая строка таблицы проверяется автоматически, часть сценариев пройдена и на живом сайте.

Что случилось Что делает магазин
Покупатель заплатил и закрыл вкладку Сервер подтверждает оплату без браузера. Проверено на живом сайте: заказ оформлен, корзина очищена при следующем визите
Покупатель нажал «Перейти к оплате» дважды Повтор возвращает тот же заказ и тот же счёт. На приёмке двойное нажатие дало один заказ и один счёт
Multicard не ответил на создание счёта Второй счёт вслепую не создаётся: первый мог быть создан. Товар остаётся закреплённым, сервер выясняет исход
Уведомление об оплате не дошло Сервер сам регулярно спрашивает у Multicard обо всех незавершённых оплатах
Срок счёта истёк Товар освобождается только после ответа Multicard, что счёт не оплачен. Нет связи, и товар остаётся закреплённым
Деньги пришли по уже отменённому заказу Сервер сам отправляет полный возврат и сообщает менеджерам. Покупатель видит «Проверяем возврат» и просьбу не оплачивать повторно
Покупатель отменил оплату, а подтверждения отмены нет Покупатель видит «Проверяем отмену. Дождитесь подтверждения отмены. Не создавайте новый платёж». Оплатить корзину заново нельзя, пока отмена не подтверждена
Оплату нужно срочно отключить Новые оплаты выключаются одной настройкой, уже начатые продолжают проверяться и завершаться

Главное правило за этой таблицей: неизвестный результат не считается отказом. Если запрос оборвался, легко снять резерв и предложить заплатить ещё раз, но тогда покупатель может заплатить дважды или заплатить за товар, который уже продан другому.

Оплаченный заказ сервер на всякий случай продолжает перепроверять ещё сутки: спрашивает у Multicard статус платежа уже после подтверждения. Это наша мера предосторожности.

Как появился журнал оплаты

При первой попытке принять настоящий платёж Multicard отказал в создании счёта, а сервер не записал причину. В тот же день мы добавили журнал: каждое событие оплаты хранится 365 дней, и по номеру заказа видна вся цепочка от счёта до возврата. Номеров карт, имён и телефонов покупателей в журнале нет.

Сбои, где нужен человек, сервер сам отправляет менеджерам в Telegram. Об этом отдельная статья: «Уведомления о заказах в Telegram и админка магазина».

Что видит покупатель, пока оплата проверяется

После оплаты покупатель возвращается на страницу результата. Она ничего не утверждает сама, а спрашивает сервер: сразу при открытии и затем ещё около двух минут. Пока ответа нет, покупатель видит «Проверяем результат оплаты», после подтверждения «Оплата подтверждена».

Самый неприятный случай для покупателя: деньги списаны, а подтверждения нет. Тогда страница пишет: «Подтверждение пока не получено. Проверьте статус ещё раз или свяжитесь с магазином», а сервер продолжает выяснять исход и без покупателя.

  • Ошибка связи не выглядит как отказ. Если сервер не ответил, страница не показывает кнопок «оплатить» и «отменить». Покупатель не заплатит второй раз из-за того, что у него пропал интернет.
  • Корзина очищается только после подтверждения. Если оплата не прошла, покупателю не нужно собирать заказ заново.
  • Менеджер узнаёт о заказе только после подтверждённой оплаты. Покупатель, который дошёл до страницы оплаты и передумал, заказом не считается.

Как сделать возврат оплаты через Multicard

Возврат менеджер оформляет в админке магазина, в карточке заказа. Сервер отправляет в Multicard команду на возврат, дожидается подтверждения и отменяет заказ, товар возвращается в продажу. Покупатель видит: «Возврат подтверждён. Платёжная система подтвердила возврат. Срок зачисления зависит от банка».

Команда на возврат уходит один раз. Если ответ не пришёл, сервер не повторяет её, а спрашивает у Multicard состояние платежа: повтор вслепую мог бы вернуть деньги дважды.

Перед запуском мы провели контрольный платёж 14 октября: заказ на 400 000 сум оплачен картой, чек с кодом ИКПУ получен, полный возврат прошёл. Только после этого оплату открыли покупателям.

Частичный возврат через сайт мы не делали: в нашем подключении проверен только полный. Если вам нужен частичный, спросите у менеджера Multicard, как он включается для вашей кассы.

Чем тестовая оплата Multicard отличается от боевой

У Multicard есть тестовая среда с тестовой картой, она опубликована в документации. В ней проходит весь путь от счёта до возврата, но рассчитывать на полное совпадение с настоящими платежами нельзя.

  • В тестовой среде счёт принимался без позиций чека. Для настоящих платежей они обязательны, поэтому коды ИКПУ мы впервые проверили только на контрольном платеже.
  • Адрес страницы оплаты в тестовой среде отличался от примера в документации, и его пришлось учесть в коде.
  • Тест проходит одной тестовой картой. Он не доказывает, что у вашей кассы работают Humo или оплата через приложения.

Вывод для владельца: запуск оплаты всегда заканчивается настоящим платежом своей картой и настоящим возвратом. Спросите у подрядчика, когда он его проведёт.

Сколько стоит подключить Multicard

Расходов два, и платятся они разным сторонам.

  • Комиссия Multicard с каждого платежа. Её размер и условия записаны в вашем договоре с Multicard, называет их менеджер. Мы её не пересказываем: она зависит от договора.
  • Работа разработчика. Если мы делаем магазин целиком, онлайн-оплата входит в каждый из трёх пакетов, включая «Старт»: цены есть на странице «Интернет-магазин». Подключение оплаты к уже работающему сайту считаем отдельно: цена зависит от того, как устроены корзина и заказы.

Multicard, Click или Payme: что выбрать

Мы подключали Multicard и пишем о нём по своему опыту. Click и Payme как отдельные платёжные системы в этом магазине не подключены, поэтому сравнивать их комиссии и скорость мы не берёмся.

  • Что известно из документации Multicard. Через одно подключение покупатель платит картой Uzcard, Humo, Visa или Mastercard, а также через приложения, среди которых Payme, Click и Uzum. Что именно увидит ваш покупатель, зависит от настроек кассы.
  • Что общее у всех сервисов. Договор, счёт с сервера, уведомление об оплате, собственная проверка платежа и чек с кодом ИКПУ. Click и Payme мы подключаем по той же схеме и по их документации.
  • Как выбирать. Узнайте у каждого сервиса комиссию, срок зачисления денег и список способов оплаты, которые включат вашей кассе, и сравните с тем, как привыкли платить ваши покупатели.

В магазине техники в Ташкенте кроме оплаты картой работает рассрочка Alif: это вторая, отдельная интеграция, о ней рассказано на странице о рассрочке.

Что спросить у подрядчика про онлайн-оплату

  1. В какой момент заказ считается оплаченным? Правильный ответ: когда сервер сам проверил платёж в платёжной системе.
  2. Что будет, если покупатель заплатил и закрыл вкладку?
  3. Что будет, если нажать «Оплатить» два раза подряд?
  4. Что произойдёт с товаром, пока покупатель вводит карту? А если он так и не заплатил?
  5. Что случится, если платёжная система не ответила на создание счёта?
  6. Как делается возврат и может ли он уйти дважды?
  7. Где посмотреть историю оплаты по номеру заказа и сколько она хранится?
  8. Был ли перед запуском настоящий платёж и настоящий возврат?

Если на эти вопросы отвечают «такого не бывает», оплата у вас работает только в хорошую погоду.

Частые вопросы о подключении Multicard

Можно ли подключить Multicard без программиста?

К своему сайту нет. Счёт создаёт сервер сайта, он же принимает уведомление об оплате и перепроверяет платёж, поэтому без серверного кода не обойтись.

Что нужно для подключения Multicard?

Договор с Multicard, активная касса, ключи доступа, коды ИКПУ и коды упаковки для всех товаров и серверный код на сайте.

Сколько времени занимает подключение Multicard?

В нашем проекте интернет-магазина от начала работ до первой настоящей оплаты прошло меньше двух недель. Срок зависит от того, как быстро оформлен договор, активирована касса и подобраны коды товаров.

Сколько стоит подключение Multicard?

Multicard берёт комиссию с каждого платежа по вашему договору, её называет менеджер Multicard. Работа разработчика оплачивается отдельно; в наших пакетах интернет-магазина онлайн-оплата уже входит в цену.

Какие карты принимает Multicard?

По документации Multicard: Uzcard, Humo, Visa и Mastercard, а также оплату через приложения. Набор способов для конкретного магазина зависит от настроек его кассы.

Весь проект магазина описан в кейсе Dyson Store, устройство магазина целиком в статье «Как устроен интернет-магазин». Состав работ есть на странице «Интернет-магазин», а стоимость и срок подключения оплаты для вашего сайта назовём на созвоне: пройдём по списку вопросов выше и посмотрим, что уже готово.

делаем?

Напишите, что нужно — составим ТЗ

Напишите в Telegram — договоримся о созвоне. На нём разберём задачу, и вы получите подробное ТЗ без обязательств: страницы, разделы, пакет и цена.

Telegram

Телефон

+998 92 153-35-00

Нет Telegram?

Оставьте номер — перезвоним