Карты

Раздел описывает методы и параметры для токенизации и получения баланса банковских карт. В настоящее время поддерживаются карты платёжных систем Uzcard и Humo.

Об использовании

Использование карт для снятия средств при покупках, получения баланса, истории транзакций карты и других операций осуществляется при помощи токена карты. Токен карты необходимо подтвердить с помощью одноразового кода подтверждения, отправляемого при токенизации на номер телефона держателя карты.

POST/getCardToken

Получение токена

Возвращает токен карты, который можно использовать после подтверждения, и маскированный номер телефона держателя карты. При этом отправляет сообщение с одноразовым кодом подтверждения токенизации карты на номер телефона держателя карты.

Параметры

  • Name
    pan
    Type
    string
    Description

    Номер карты (personal account number), состоит из 16 цифр.

  • Name
    exp
    Type
    string
    Description

    Дата истечения срока действия карты в формате MMYY (expiry).

  • Name
    phone
    Type
    string
    Description

    Номер телефона, для которого включено СМС-информирование для карты (в формате 998NNNNNNNNN).

    Обязательно для карт системы Humo. Если указанный номер телефона не совпадает с номером телефона СМС-информирования карты, вернётся ошибка с кодом 1110.

Запрос

POST
/getCardToken
{
  "pan": "1234111111111111",
  "exp": "0324",
  "phone": "998123456789"
}

Ответ

{
  "token": "62d602f4-115d-46ce-a385",
  "masked_phone": "+998*****6789"
}
POST/confirmCardToken

Подтверждение токена

Подверждает полученный ранее токен карты для последующего многоразового использования для операций по карте (снятие средств, получение баланса, истории транзакций и др.).

Параметры

  • Name
    token
    Type
    string
    Description

    Токен карты, полученный ранее методом getCardToken.

  • Name
    otp
    Type
    string
    Description

    Одноразовый код подтверждения (one-time password), отправленный на номер телефона, для которого включено СМС-информирование для данной карты.

Запрос

POST
/confirmCardToken
{
  "token": "62d602f4-115d-46ce-a385",
  "otp": "111111"
}

Ответ

{
  "masked_pan": "123411******1111",
  "bank_name": "Panda Bank",
  "holder_name": "Matchanov D",
  "token": "62d602f4-115d-46ce-a385"
}
POST/pinfl

Проверка ПИНФЛ

Позволяет проверить соответствие карты и ПИНФЛ.

Для интеграции и тестирования необходимо использовать ПИНФЛ из списка ПИНФЛ для песочницы.

Для некоторых карт платежной системы Humo может возвращаться ответ false, если у платёжной системы отсутствует информация о ПИНФЛ.

Параметры

  • Name
    token
    Type
    string
    Description

    Токен карты, полученный ранее методом confirmCardToken.

  • Name
    pinfl
    Type
    string
    Description

    Персональный идентификационный номер физического лица. Состоит из 14 цифр.

Запрос

POST
/pinfl
{
  "token": "62d602f4-115d-46ce-a385",
  "pinfl": "11111111111111"
}

Ответ

{
  "ok": true
}
POST/getCardType

Тип карты

Возвращает обозначение платёжной системы карты: HUMO или UZCARD или ошибку с кодом 1005 — невалидные параметры.

Параметры

  • Name
    pan
    Type
    string
    Description

    Префикс номера карты длиной от 4 до 16 цифр.

Запрос

POST
/getCardType
{
  "pan": "1234",
}

Примеры ответа

{
  "type": "UZCARD"
}