3DS OTP

Когда карта используется для покупки, эквайер присылает SMS с OTP-кодом. У нас нет SIM — мы получаем коды напрямую из почтового ящика эквайера и выдаём через API.

GET /cards/:id/otp/latest

curl 'https://b2b.lumowallet.io/cards/8c7f1823-.../otp/latest' \
  -H 'X-API-Key: YOUR_API_KEY'

{
  "id": "a1b2c3d4-...",
  "cardId": "8c7f1823-...",
  "code": "582130",
  "maskedCard": "4466 ** ** 1234",
  "subject": "3DS Verification",
  "receivedAt": "2026-04-23T12:00:10Z",
  "expiresAt": "2026-04-23T12:02:10Z",
  "consumedAt": null
}

Если свежего OTP нет — возвращается null.

Опрашивайте эндпоинт каждые 5–15 секунд после инициации 3DS-проверки. OTP живёт 2 минуты (поле expiresAt). Наш поллер почты сканирует ящик каждые 15 секунд.

Подпишитесь на событие card.otp_received:

{
  "event": "card.otp_received",
  "data": {
    "cardId": "8c7f1823-...",
    "code": "582130",
    "receivedAt": "2026-04-23T12:00:10Z",
    "expiresAt": "2026-04-23T12:02:10Z"
  }
}

Webhooks доставляются сразу после того, как наш поллер увидел письмо.

cardsTestMode = true всегда возвращает фиксированный код 843903 со сроком 2 минуты от текущего момента — удобно для автотестов.