Краткое описание API HissPay. Полный справочник — официальная документация v1.13.0 (2026-10-27), сейчас опубликованная на упрощённом китайском.
Полная и актуальная документация по интеграции: https://mch.hisspay.com/docs/ (v1.13.0 · 2026-10-27, постоянно обновляется). Эта страница — лишь краткое изложение; при расхождениях действует официальная документация.
HissPay предоставляет приём платежей от ваших клиентов и выплаты на счета получателей через HTTPS POST с телом JSON. Боевой шлюз: https://transaction.hisspay.com; шлюз песочницы: https://sandbox-api.hisspay.com.
| Операция | Путь |
|---|---|
| Создать платёж (приём) | POST /transaction/payin/v1/apply |
| Статус платежа | POST /transaction/payin/v1/query |
| Создать выплату | POST /transaction/payout/v1/apply |
| Статус выплаты | POST /transaction/payout/v1/query |
| Баланс | POST /transaction/payout/v1/balance |
Валюты в каталоге продуктов: AUD, EUR, GBP, INR, JPY, THB, USD, USDT. Наличие в каталоге не означает подключение: коды продуктов, диапазоны сумм и тарифы для вашего аккаунта указываются в уведомлении о подключении.
Перед интеграцией: аккаунт мерчанта одобрен; в кабинете (mch.hisspay.com → ключи приложения) создано API-приложение и получены appId и appSecret; подписаны продукты приёма и выплат; для выплат внесены в белый список публичные исходящие IP вашего сервера; есть публичный HTTPS-адрес для уведомлений. Сначала проверьте всё в песочнице.
Каждый запрос содержит заголовки appId, timestamp (Unix в миллисекундах, расхождение с платформой не более 30 секунд), nonce (не менее 10 символов, без повторов) и sign. sign — SHA-256 в нижнем шестнадцатеричном виде от полей тела вместе с appId, timestamp и nonce, отсортированных по имени в виде key=value через &, с appSecret, дописанным в конец. Это не HMAC. Не передавайте null и не размещайте appSecret в браузере или приложении.
POST /transaction/payin/v1/apply создаёт платёж и возвращает payUrl для плательщика. Оплату подтверждайте только проверенным уведомлением или запросом статуса, а не возвратом браузера.
POST /transaction/payout/v1/apply обрабатывается асинхронно: code=0 означает «принято», а не «выплачено». Тайм-аут или код 500 означают, что результат не подтверждён: сначала запросите исходный заказ и действуйте по правилам полной документации, прежде чем отправлять что-либо повторно.
Приём USDT использует currency=USDT и код продукта конкретной сети, выданный платформой; сумма — не более 4 знаков после запятой. Результат подтверждается уведомлением или запросом.
Таиланд (THB): приём по QR PromptPay и выплаты банковским переводом в Таиланде. Коды банков для приёма: SCB, KBANK, KTB, BAY, GSB, TTB; для выплат: SCB, KBANK, KTB, BAY, GSB, TTB, BBL (доступные вам банки указаны в уведомлении о подключении). Диапазон по умолчанию на операцию: 500.00–49999.00 THB.
POST /transaction/payin/v1/query и POST /transaction/payout/v1/query принимают merchantOrderNo или orderNo. Не более 5 запросов в секунду на appId; опрашивайте раз в 3–5 секунд с увеличением интервала.
POST /transaction/payout/v1/balance возвращает по валюте balance (учётный), balanceActive (доступный) и balanceFreeze (заблокированный).
Платформа отправляет POST JSON на ваш notifyUrl с теми же четырьмя заголовками подписи. Проверьте подпись, обработайте идемпотентно по заказу и ответьте ровно SUCCESS или OK. Неподтверждённые уведомления повторяются ограниченное число раз.
Используйте payStatus вместе с paymentStatus и isFinal. payStatus=0 в запросе платежа не означает, что оплата не прошла.
code=0 означает успешный вызов API; результат оплаты — отдельный статус заказа. Все коды ошибок и рекомендации приведены в полной документации.
Зарегистрируйте мерчанта в песочнице, запустите пакет quickstart и 5-минутную самопроверку из руководства по песочнице, затем пройдите чек-лист запуска.
Откройте счёт онлайн, чтобы получить тестовые учётные данные и коды продуктов; после успешного тестирования в песочнице переключение на продуктив выполняется одним действием.
HissPay предоставляет технологии интеграции платежей, управления заказами, уведомлений и сверки. Обработку платежей, клиринг и расчёты выполняет лицензированная платёжная организация по договору. HissPay не принимает, не хранит и не обрабатывает денежные средства по транзакциям.
Указанные ставки включают комиссию лицензированной платёжной организации и плату за технологические услуги HissPay; не вся сумма является комиссией HissPay. Состав, порядок начисления и условия определяются подписанными договорами и тарифами мерчанта.