Мы провели тщательную проверку и обновление документации API для обеспечения точности всех endpoint'ов, webhook'ов и примеров кода.
Основные обновления
Схемы запросов и ответов
- Корректные имена полей: Ответ использует
paymentId(неid) иgeneratedAddress(неaddress) - Обязательные поля: Создание платежа теперь четко документирует
amount,currencyиnetworkкак обязательные - Значения статусов: Все статусы в нижнем регистре (
pending,confirmed,underpaid,overpaid,expired,failed,canceled) - Новые статусы: Добавлены
underpaidиoverpaidдля обработки частичных платежей - Корректные имена заголовков:
X-Pulse2Pay-Key,X-Pulse2Pay-Signature,X-Pulse2Pay-Timestamp - Формат timestamp: Теперь четко документирован как миллисекунды (не секунды)
- Префикс API ключей: Публичные ключи используют
pk_live_/pk_test_, секретные ключи используютsk_live_/sk_test_ - Формат подписи: Подписи webhook используют
timestamp.body(отличается от формата подписи API) - Структура payload: Использует поле
type(неevent) и оборачивает данные платежа в объектdata - Политика повторов: Обновлена до 5 попыток с задержками 1с, 5с, 30с, 1мин, 5мин
- Все 8 событий:
payment.created,payment.pending,payment.confirmed,payment.underpaid,payment.overpaid,payment.expired,payment.failed,payment.canceled - Поля payload webhook:
externalId,differenceAmount,overpaidAmount,underpaidAmount,alertType - Чеклист интеграции: Добавлен в портал мерчанта для упрощения онбординга
- API Reference
- Документация Webhooks
- Руководство по аутентификации API
- Руководство по безопасности Webhook
- Приём USDT платежей
- Процесс криптоплатежей