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, полученные при сохранении карты плательщиком.

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

HTTP

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"
}

cURL

curl --location --request POST 'https://stage-api.ioka.kz/v2/masterpass/sessions/{{session_id}}/cards' \
--header 'API-KEY: eyJ0eXAiOiJKV1..' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer_id": "mn4ZgB5XTb",
    "card_id": "t3i2tPViLK"
}'

Python

import requests
import json

url = "https://stage-api.ioka.kz/v2/masterpass/sessions/{{session_id}}/cards"

payload = json.dumps({
    "customer_id": "mn4ZgB5XTb",
    "card_id": "t3i2tPViLK"
})
headers = {
  'API-KEY': 'eyJ0eXAiOiJKV1..',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

PHP

<?php
$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('https://stage-api.ioka.kz/v2/masterpass/sessions/{{session_id}}/cards');
$request->setRequestMethod('POST');
$body = new http\Message\Body;
$body->append('{
    "customer_id": "mn4ZgB5XTb",
    "card_id": "t3i2tPViLK"
}');
$request->setBody($body);
$request->setOptions(array());
$request->setHeaders(array(
  'API-KEY' => 'eyJ0eXAiOiJKV..',
  'Content-Type' => 'application/json'
));
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

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

200

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

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