Ідемпотентність на кожній мутації
Заголовок Idempotency-Key на всіх публічних мутаціях і ідентифікатор кореляції, який проходить від початку операції до вебхука, який ви отримаєте. Повторити запит завжди безпечно.
Розробникам
API до того, як він вийшов.
Мерчантський API у проєктуванні, і контракт пишеться раніше за код — це саме той момент, коли корисно почути вас. Нижче те, що вже вирішено.
Чесно: поки немає
Публічного ендпоїнта немає, і видати ключ сьогодні не можна. Усе на цій сторінці — проєктні зобов'язання, а публікуємо ми їх так рано тому, що саме інтегратори — ті люди, з якими варто сперечатися про контракт, поки його ще дешево міняти.
Що вже вирішено
Вебхуки, які не можна втратити
Підписані HMAC, несуть nonce, доставляються з повторами і чергою недоставлених. Подія пишеться в тій самій транзакції бази, що й зміна стану, про яку повідомляє, — тому збій доставки лишається збоєм доставки і ніколи не стає втраченим платежем.
Гроші в цілих мінорних одиницях
Суми йдуть по проводу цілими числами з явною кількістю знаків для кожного токена. Жодних дробових чисел із рухомою комою в жоден бік: ваш бік форматує, наш рахує.
Невдалі стани — повноправні
Недоплата, переплата, збіг строку, не та мережа і реорганізація ланцюга — це документовані статуси з визначеними переходами, а не крайні випадки, виявлені в проді.
Джерело правди — OpenAPI
Специфікація пишеться першою, і сервер перевіряється за нею на льоту, тому розходження між документацією і поведінкою відхиляється, а не виявляється. Клієнти генеруються з того самого документа.
API-ключі не підписують
Ключ організації може підготувати пакет виплат, але не може його схвалити. Підпис лишається у власника ключа на пристрої — та сама межа, що й у гаманці.
Приблизно такої форми
Ілюстрація: зобов'язує опублікований контракт, а він ще не опублікований.
Хочете вплинути на контракт?
Розкажіть, що ви інтегруєте і що пішло не так у минулій криптоінтеграції. Ранній доступ роздається в порядку цих розмов.
Запросити ранній доступ