API для випуску карток
2328 — це API для випуску віртуальних карток для команд, які хочуть надати платіжну картку своїм користувачам, не стаючи ліцензованим емітентом. Ви реєструєте власників карток, випускаєте картки під спонсорованим BIN, поповнюєте їх зі свого гаманця USDT та контролюєте весь життєвий цикл — заморожування, розвантаження, закриття — через єдиний REST-інтерфейс.
Створення карткової програми традиційним способом означає ліцензію схеми, BIN, процесор, банк-спонсор та вісімнадцять місяців сертифікаційної роботи, перш ніж пройде перша авторизація. Ця робота вже виконана тут. На вашому боці залишається та частина, яка є власне вашим продуктом: хто отримує картку, що вони можуть витрачати та як виглядає досвід.
API є лише JSON, усі поля мають camelCase, і кожен запит, крім публічної перевірки стану, авторизується за допомогою Bearer key. Гроші завжди є цілим числом у молодших одиницях з явною валютою та масштабом — гаманець є USDT у масштабі 6, картки є USD у масштабі 2 — тому ніколи не виникає неоднозначної плаваючої коми в реєстрі.
Власники карток
Реєструйте власників карток з ідентифікаційними даними, які вимагає програма, а потім випускайте одну або багато карток для кожного з них. Онбординг, ліміти та життєвий цикл повністю керуються з вашого боку.
Миттєвий випуск віртуальних карток
Картки створюються одним викликом API і одразу придатні до використання — без пластику, без доставки, без кроку активації. Випускайте одну на користувача, на підписку, на кампанію або на постачальника.
Поповнення з гаманця USDT
Картки поповнюються з вашого балансу стейблкоїнів. USDT надходить у масштабі 6, баланс картки є USD у масштабі 2, і API чітко вказує обидва, тому реєстри ніколи не розходяться.
Повний контроль життєвого циклу
Програмно блокуйте, розблоковуйте, вивантажуйте та закривайте картки. Компрометована картка деактивується одним запитом; завершена підписка закривається без витрат.
Баланси та транзакції
Читайте актуальні баланси карток та історію транзакцій по всій програмі, включаючи авторизації, розрахунки, відхилення та комісії.
Замовлення та вебхуки
Грошові операції є асинхронними: ви надсилаєте операцію, отримуєте замовлення та розглядаєте вебхук як джерело правди, а не припускаєте успіх за статусом 200.
Спонсорство BIN, без дворічного обхідного шляху
Кожна картка прив'язана до BIN — номера, який повідомляє картковим мережам, яка ліцензована установа стоїть за нею. Отримання власного означає стати основним членом Visa або Mastercard: регуляторна ліцензія, застава схеми, вимоги до капіталу та роки сертифікації.
Картки, випущені через 2328, працюють на існуючому спонсорованому BIN. Установа-спонсор володіє членством у схемі та здійснює розрахунки з мережею; ви зберігаєте продукт, брендинг, відносини з власниками карток та економіку. На практиці це перетворює ліцензійний проєкт на інтеграційний проєкт.
Онбординг все ще вимагає належної перевірки — вас запитають, хто ваші власники карток, звідки надходять кошти та як виглядають ваші KYC та моніторинг. Чим чіткіші ці відповіді, тим швидше запускається програма.
Як відбувається інтеграція
- 1.Узгодьте програму: профіль власника картки, потік фінансування, географії та ліміти.
- 2.Отримайте ключі API та перевірте підключення до публічної кінцевої точки GET /ping.
- 3.Зареєструйте свого першого власника картки та випустіть картку в робочому середовищі.
- 4.Поповніть картку зі свого гаманця USDT та підтвердьте отримане замовлення через вебхук.
- 5.Інтегруйте баланси, транзакції та операції життєвого циклу у свій продукт.
- 6.Запустіть та масштабуйте — випуск є одним викликом, тому обсяг не є інженерною проблемою.
Часті запитання
Чи потрібна мені власна ліцензія або BIN для випуску карток?
Ні. Картки випускаються під існуючим спонсорованим BIN, тому вам не потрібно ставати основним членом Visa або Mastercard. Ви описуєте своїх власників карток та потік фінансування під час онбордингу; ліцензування та розрахунки за схемою залишаються за установою-спонсором.
Яку автентифікацію використовує API випуску карток?
Bearer-автентифікацію. Кожен запит, крім публічної перевірки стану, містить Authorization: Bearer ck_{keyId}_{secret}. Ключ ідентифікує ваш обліковий запис, тому в корисне навантаження не передаються ідентифікатори продавців або облікових записів. Зберігайте ключ лише на своєму бекенді.
Як поповнюються картки?
З вашого гаманця USDT всередині 2328. Поповнення конвертує стейблкоїн у баланс картки в USD. Гаманець є USDT з масштабом 6, а картки — USD з масштабом 2 — суми завжди є цілими числами в менших одиницях з явною валютою та масштабом.
Чи є операції з картками синхронними?
Грошові операції є асинхронними. Запит на поповнення або вивантаження повертає замовлення, яке ви відстежуєте до завершення, а вебхук підтверджує кінцевий стан. Операції читання, такі як баланси та транзакції, є синхронними.
Чи існує середовище пісочниці?
Існує єдине робоче середовище — без окремих ключів пісочниці. Публічна кінцева точка GET /ping доступна без автентифікації для перевірок працездатності.
Для чого можна використовувати картки?
Типові програми охоплюють онлайн-підписки, витрати на рекламу, витрати співробітників та підрядників, виплати на маркетплейсах та загальні споживчі витрати, що фінансуються криптовалютою. Дозволені варіанти використання узгоджуються під час підключення до програми.