Оплата по сохраненной карте

Оплата по сохраненной карте с вводом CVC

Создание заказа

В системе ioka у мерчанта есть возможность создать заказ для оплаты по сохраненной карте с предзаполненными карточными данными (PAN, срок действия карты), но с подтверждением CVC. Для этого при создании заказа необходимо передавать:

amount (сумму) необходимо указывать в минорных денежных единицах, т.е. для создания заказа на сумму 500 тенге, необходимо ввести 50000 (1 тенге = 100 тиын)
customer_id - идентификатор плательщика, полученный при создании плательщика или при оплате заказа с сохранением карточных данных
card_id - идентификатор сохраненной карты, привязанной к данному плательщику. Может быть получен при сохранении карты или при оплате заказа с сохранением карточных данных

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

HTTP
cURL
Python
PHP

POST /v2/orders HTTP/1.1
Host: stage-api.ioka.kz
API-KEY: eyJ0eXAiOiJKV1..
Content-Type: application/json

{
    "amount": 50000,
    "customer_id": "mn4ZgB5XTb",
    "card_id": "t3i2tPViLK"
}

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

import requests
import json

url = "https://stage-api.ioka.kz/v2/orders"

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

response = requests.post(url, headers=headers, data=payload)
order = response.json()['order']

print(order['checkout_url'])

<?php
$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('https://stage-api.ioka.kz/v2/orders');
$request->setRequestMethod('POST');
$body = new http\Message\Body;
$body->append('{
    "amount": 50000,
    "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();

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

{
    "order": {
        "id": "ord_test",
        "shop_id": "shp_test",
        "status": "UNPAID",
        "created_at": "2022-01-01T10:00:00.00000",
        "amount": 50000,
        "display_amount": 50000,
        "currency": "KZT",
        "mcc": null,
        "acquirer": null,
        "capture_method": "AUTO",
        "external_id": null,
        "description": null,
        "extra_info": null,
        "attempts": 10,
        "due_date": null,
        "split": null,
        "customer_id": "mn4ZgB5XTb",
        "card_id": "t3i2tPViLK",
        "back_url": null,
        "success_url": null,
        "failure_url": null,
        "template": null,
        "access_token": "ord_QNQcGTrfEV_secret_502253104a5f360e68834b827057b60181e5f5a149635e18cf28e5dfc7d71e98",
        "checkout_url": "https://test.ioka.kz/orders/ord_test",
        "payment_link_url": null,
        "payments": []
    },
    "order_access_token": "ord_QNQcGTrfEV_secret_502253104a5f360e68834b827057b60181e5f5a149635e18cf28e5dfc7d71e98"
}

Проведение платежа

Для проведения оплаты необходимо перенаправить пользователя на адрес checkout_url, полученный в теле ответа на создание заказа, где находится платежная форма с предзаполненными PAN и сроком действия карты.

Для завершения оплаты клиенту необходимо ввести CVC и в случае наличии двухэтапной аутентификации пройти 3DS проверку.

Вы можете проверить статус платежа, используя те же методы, что и при оплате по полным карточными данным.