Перейти к содержимому

Карты

Выпуск виртуальных VISA-карт и их жизненный цикл — заявка, закрытие, просмотр PAN/CVC, 3DS OTP, история операций.

Операции

Карты компании

Запрос

Новые сначала. У каждой карты есть её состояние у эквайера (upayState / upayStateName); null, если получить его не удалось. Нужно право cards.read. Все эндпоинты карт к тому же работают, только если компании подключена программа карт (403 CARDS_NOT_ENABLED).

Безопасность
apiKeyAuth
Запрос
externalIdstring

Фильтр по идентификатору карты в вашей системе. Вернёт ровно ту карту, что была выпущена с этим externalId, либо пустой список.

curl -i -X GET \
  'https://b2b-app.lumowallet.io/_mock/apis/cards?externalId=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Ответы

Все карты компании

Телоapplication/json
Array [
idstring, (uuid)обязательный
externalIdstring or null

Идентификатор карты в вашей системе, если был передан при выпуске

Пример:"user-42-card-1"
statusstring(CardStatus)обязательный
  • assigned — активна, можно пополнять и использовать
  • closing — запрошено закрытие, идёт обработка
  • closed — закрыта, остаток возвращён на баланс компании
  • retired — устаревший статус закрытых карт (эквивалентен closed)

requested и failed остались в перечислении, но текущая версия их не выставляет: пока карта не выдана, существует только заявка (CardRequestRow).

Enum:"requested""assigned""closing""closed""retired""failed"
maskedPanstring or null
Пример:"4466********1234"
expirystring or null

ММ/ГГ

Пример:"03/29"
assignedAtstring or null, (date-time)
createdAtstring, (date-time)обязательный
upayStateinteger or null

Состояние карты у эквайера: 1 Normal, 2 Pending Activation, 3 Frozen, 4 Locked, 5 Deactivated, 7 Activating, 8 Locking, 9 Unlocking, 10 Deactivating, 13 Rejected, 14 Cancelled, 15 Replacing, 16 Replaced. Заполняется в GET /cards и GET /cards/{id}; в остальных ответах и если состояние неизвестно — null.

Пример:1
upayStateNamestring or null
Пример:"Normal"
]
Ответ
[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "externalId": "user-42-card-1",
    "status": "requested",
    "maskedPan": "4466********1234",
    "expiry": "03/29",
    "assignedAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "upayState": 1,
    "upayStateName": "Normal"
  }
]