Skip to main content

Masterpass™

Общая информация

Masterpass — облачное хранилище карточных данных, за безопасность которых отвечает Mastercard.

Преимущества использования Masterpass:

  • Простая интеграция сервиса для мерчантов.
  • Все карточные данные плательщиков безопасно хранятся в облачном хранилище.
  • Оплата проходит в один клик - нет необходимости повторно вводить номер, срок действия карты и CVV/CVC.
  • У плательщика есть возможность сохранить до 5 карт Mastercard или Visa для одного номера мобильного телефона.
  • Оплаты по сохраненным в Masterpass картам будут приниматься во всех магазинах, где подключен данный сервис.

Плательщик может управлять своими сохраненными картами и добавлять новые через личный кабинет в Masterpass.

Важно

Данные плательщика не привязываются к мерчанту, т.е. сохранив карту один раз, в дальнейшем покупатель будет выбирать её из списка для оплаты во всех магазинах и приложениях, где есть Masterpass.

Упрощенная интеграция

Чтобы интегрировать оплаты через Masterpass в ваш магазин, вам необходимо связаться с аккаунт-менеджером ioka или написать на почту support@ioka.kz.

Интеграция по API

Добавление карточных данных в Masterpass

Для того чтобы добавить новую карту в Masterpass, сначала вам необходимо открыть сессию, получить session_id и список сохраненных карт по этому номеру телефона.

Далее, отправить запрос на сохранение новой карты, где необходимо передать параметры customer_id, card_id, полученные при сохранении карты плательщиком.

Пример запроса:

POST /v2/masterpass/sessions/{{session_id}}/cards HTTP/1.1
Host: stage-api.ioka.kz
API-KEY: eyJ0eXAiOiJKV1..
Content-Type: application/json
{
"customer_id": "mn4ZgB5XTb",
"card_id": "t3i2tPViLK"
}

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

[
{
"token": "mp_token",
"status": "ACTIVE",
"card":
{
"pan_masked": "555555******5599"",
"expiry_date": "12/24",
"holder": "holder",
"payment_system": "VISA",
"emitter": "halykbank"
}
}
]

Более подробно ознакомиться со всеми доступными методами по работе с картами в Masterpass можно в Справочнике API.