Partner API: Cards
API взаимодействует с национальными ПЦ (Uzcard, Humo) и МПЦ (Visa, MasterCard) для токенизации карт.
Этот раздел описывает, как партнёры инициируют привязку карт через iFrame и как получать информацию о карте по выданному cardToken. Все номера карт, CVC/CVV и другие чувствительные данные не проходят через системы партнёра и не хранятся у него: ввод происходит в защищённой форме на стороне Beepul.
После успешного прохождения пользователем iFrame партнёр получает callback с токеном карты и дополнительной информацией
Коротко: партнёр создаёт сессию iFrame → пользователь вводит данные → Beepul выпускает cardToken → партнёр использует cardToken для последующих операций (списание, автоплатёж и т.д.).
Участники процесса
Партнёр — инициирует создание iFrame-сессии.
Пользователь — клиент партнёра, добавляющий карту.
Платёжный шлюз — обрабатывает данные карты и возвращает токен.
Локализация
Все запросы должны содержать заголовок X-Api-Lang с ключами поддерживаемых Beepul языков. Ключ: uzb/rus
В случае если ключ языка не указан, по умолчанию используется русский язык rus.