Чтобы подключить Multicard к сайту, нужны договор с Multicard и активная касса, ключи доступа, которые выдаёт Multicard, коды товаров для электронного чека и код на сервере сайта. Сервер создаёт счёт, отправляет покупателя на страницу оплаты Multicard и принимает подтверждение. Карту покупатель вводит на странице Multicard, сайт её данных не видит и не хранит. Заказ считается оплаченным, когда сервер сайта сам перепроверил платёж у Multicard, а не когда покупатель вернулся на сайт.
Мы подключали Multicard интернет-магазину Dyson Store Uzbekistan в Ташкенте. Ниже порядок подключения, путь платежа и места, где онлайн-оплата обычно ломается. Цифры взяты из тестов и журнала этого магазина.
Что нужно, чтобы подключить Multicard к сайту
От владельца бизнеса нужно четыре вещи.
- Договор с Multicard. Список документов для договора даёт менеджер Multicard: в открытой документации его нет, и мы его не пересказываем.
- Касса. Это ваш магазин в системе Multicard. Номер кассы выдаёт Multicard, он передаётся в каждом счёте.
- Ключи доступа. Их выдаёт Multicard, по ним сервер сайта подтверждает, что счёт создаёт именно ваш магазин. Наборов два: тестовый и боевой (для настоящих платежей).
- Коды товаров для чека. По документации 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: от кнопки до «оплачено»
- Покупатель нажимает «Перейти к оплате». Сумму сервер считает сам по ценам из своей базы: сумму из браузера можно подменить. Товар закрепляется за покупателем на 15 минут, чтобы последнюю единицу не купил другой.
- Сервер создаёт счёт в Multicard с суммой и позициями чека и получает ссылку на страницу оплаты. В нашем магазине счёт действует те же 15 минут.
- Покупатель платит на странице Multicard. Карту и код из SMS он вводит там.
- Сервер получает уведомление об оплате и перепроверяет его. Отдельным запросом спрашивает у 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: это вторая, отдельная интеграция, о ней рассказано на странице о рассрочке.
Что спросить у подрядчика про онлайн-оплату
- В какой момент заказ считается оплаченным? Правильный ответ: когда сервер сам проверил платёж в платёжной системе.
- Что будет, если покупатель заплатил и закрыл вкладку?
- Что будет, если нажать «Оплатить» два раза подряд?
- Что произойдёт с товаром, пока покупатель вводит карту? А если он так и не заплатил?
- Что случится, если платёжная система не ответила на создание счёта?
- Как делается возврат и может ли он уйти дважды?
- Где посмотреть историю оплаты по номеру заказа и сколько она хранится?
- Был ли перед запуском настоящий платёж и настоящий возврат?
Если на эти вопросы отвечают «такого не бывает», оплата у вас работает только в хорошую погоду.
Частые вопросы о подключении Multicard
Можно ли подключить Multicard без программиста?
К своему сайту нет. Счёт создаёт сервер сайта, он же принимает уведомление об оплате и перепроверяет платёж, поэтому без серверного кода не обойтись.
Что нужно для подключения Multicard?
Договор с Multicard, активная касса, ключи доступа, коды ИКПУ и коды упаковки для всех товаров и серверный код на сайте.
Сколько времени занимает подключение Multicard?
В нашем проекте интернет-магазина от начала работ до первой настоящей оплаты прошло меньше двух недель. Срок зависит от того, как быстро оформлен договор, активирована касса и подобраны коды товаров.
Сколько стоит подключение Multicard?
Multicard берёт комиссию с каждого платежа по вашему договору, её называет менеджер Multicard. Работа разработчика оплачивается отдельно; в наших пакетах интернет-магазина онлайн-оплата уже входит в цену.
Какие карты принимает Multicard?
По документации Multicard: Uzcard, Humo, Visa и Mastercard, а также оплату через приложения. Набор способов для конкретного магазина зависит от настроек его кассы.
Весь проект магазина описан в кейсе Dyson Store, устройство магазина целиком в статье «Как устроен интернет-магазин». Состав работ есть на странице «Интернет-магазин», а стоимость и срок подключения оплаты для вашего сайта назовём на созвоне: пройдём по списку вопросов выше и посмотрим, что уже готово.