Платежные карточки
Авторизация
Авторизация запроса происходит путем формирования и передачи JWS токена запроса в заголовке X-JWS-Signature. JWS это часть токена JWT, которая содержит только header и signature.

Формат передаваемых данных application/json.

Пример формирования подписи

Авторизация запроса происходит путем формирования и передачи JWS токена запроса в заголовке X-JWS-Signature. JWS это часть токена JWT, которая содержит только header и signature.

Формат передаваемых данных application/json.

Пример формирования подписи

Тело запроса:

{
    "request_id": "828cf71d-a447-4a67-a149-c1df8bc197ca"
}
Заголовок JWT токена:

{
    "uri": "/v5/card-api/request/status",
    "auth_id": "123456",
    "method": "POST",
    "params": "",
    "alg": "HS256"
}
Ключ партнера может быть secret_key. В этом случае может быть сформирован следующий JWT токен:

eyJ1cmkiOiIvdjUvY2FyZC1hcGkvcmVxdWVzdC9zdGF0dXMiLCJhdXRoX2lkIjoiMTIzNDU2IiwibWV0aG9kIjoiUE9TVCIsInBhcmFtcyI6IiIsImFsZyI6IkhTMjU2In0.eyJyZXF1ZXN0X2lkIjoiODI4Y2Y3MWQtYTQ0Ny00YTY3LWExNDktYzFkZjhiYzE5N2NhIn0.5kx_b2FEI0qfCeJDIkhR33I6Oc7fe6y0aIMnxG8elJQ
Эта строка является подписью запроса и должна быть передана в параметре заголовка запроса X-JWS-Signature.

eyJ1cmkiOiIvdjUvY2FyZC1hcGkvcmVxdWVzdC9zdGF0dXMiLCJhdXRoX2lkIjoiMTIzNDU2IiwibWV0aG9kIjoiUE9TVCIsInBhcmFtcyI6IiIsImFsZyI6IkhTMjU2In0..5kx_b2FEI0qfCeJDIkhR33I6Oc7fe6y0aIMnxG8elJQ
Поддерживаемый алгоритм шифрования подписи HS256.
Инстант карты

Массовый выпуск карт

Метод позволяет выпустить инстант карты

URL запроса

POST https://.../v5/card-api/cards/batch-instant

Параметры запроса
Параметры ответа
Идентификация инстант карты

Метод предназначен для осуществления связки ранее созданной карты с ранее созданным клиентом

URL запроса

POST https://.../v5/card-api/card/link

Параметры запроса
Параметры ответа
Платежные карты

Cоздание карточки клиента

Метод предназначен для создания карточки клиента в системе Freedom Processing. Обязательный набор полей зависит от продукта в рамках которого создается карточка клиента.

URL запроса

POST https://.../v5/card-api/client/add

Параметры запроса
Параметры ответа
Выпуск карты

Метод позволяет выпустить карту с выбранным продуктом для ранее созданного клиента.

URL запроса

POST https://.../v5/card-api/card/issue

Параметры запроса
Параметры ответа
Редактирование карточки клиента


Метод предназначен для редактирования ранее созданной карточки клиента

URL запроса

POST https://.../v5/card-api/client/update

Параметры запроса
Параметры ответа
Активация карты

Метод предназначен для активации ранее выпущенной карты

URL запроса

POST https://.../v5/card-api/card/activate

Параметры запроса
Параметры ответа
Блокирование карты

URL запроса

POST https://.../v5/card-api/card/block

Параметры запроса
Параметры ответа
Разблокирование карты

Метод предназначен для разблокировки карты

URL запроса

POST https://.../v5/card-api/card/unblock

Параметры запроса
Параметры ответа
Получение информации по карте

URL запроса

POST https://.../v5/card-api/card/info

Параметры запроса
Параметры ответа
Получение списка карт по клиенту

URL запроса

POST https://.../v5/card-api/client/cards/list

Параметры запроса
Параметры ответа
Получение баланса по карте

URL запроса

POST https://.../v5/card-api/card/balance

Параметры запроса
Параметры ответа
Установка пин-кода по карте

Метод для установки пин-кода по карте

URL запроса

POST https://.../v5/card-api/card/set_pin

Параметры запроса
Параметры ответа
Сброс счетчика пин-кода

Метод для сброса счетчика попыток использования пин-кода

URL запроса

POST https://.../v5/card-api/card/reset_counter_pin

Параметры запроса
Параметры ответа
Получение секретных карточных данных

Метод для получения полного номера карты и cvc

URL запроса

POST https://.../v5/card-api/card/secret_info

Параметры запроса
Параметры ответа
Выпуск физической карты

Метод для печати пластика по ранее созданной карте

URL запроса

POST https://.../v5/card-api/card/print

Параметры запроса
Параметры ответа
Закрытие карты

Метод для закрытие ранее выпущенной карты

URL запроса

POST https://.../v5/card-api/card/close

Параметры запроса
Параметры ответа
Получение выписки по карте

Метод для закрытие ранее выпущенной карты

URL запроса

POST https://.../v5/card-api/card/statement

Параметры запроса
Параметры ответа
Получить статус обработки запроса

Метод позволяет получить статус обработки запроса по request_id.

URL запроса

POST https://.../v5/card-api/request/status

Параметры запроса
Параметры ответа
Справочники

Статус запроса
Код продукта клиента
Параметры метода Cоздание карточки клиента с product_id = 1000
Параметры метода Cоздание карточки клиента с product_id = 2000
Код продукта карты
Статус карты
Тип блокировки карты
Справочник кодов ошибок