Кіріспе

Интернет-эквайринг – бұл банк карталарын пайдалана отырып, жалпыға қолжетімді Интернет желісі арқылы қызметтерді немесе тауарларды сатудың заманауи әдісі.

Интернетте сатып алу үдерісінің ерекшеліктері бар болғандықтан, тауарларды/қызметтерді сату операцияларын жүзеге асыру кезінде қатысатын тараптардың, яғни клиенттің, дүкеннің және банк-эквайердің арасындағы қауіпсіз қатынастарды қамтамасыз етудің қажеттілігі туындайды.

Банк карталары арқылы Интернетте қызметтерді немесе тауарларды сату үдерісін жоспарлаған дүкен төлемдердің қауіпсіздігін қамтамасыз ету бойынша процедураларды орындауы тиіс:

• Негізгі деректерді (жеке деректер, төлем карталарының деректемесі) ұсыну барысында клиенттермен байланысу кезінде криптографиялық амалдар (SSL/TLS) қолданылуы керек.
• Жүзеге асырылатын төлем бойынша ақпарат (сома, валюта, тапсырыстың сипаттамасы), сондай-ақ, төлемді орындау нәтижелері қаскүнемдердің қатынасуынан мұқият қорғалуы тиіс.
• Төлемді іске асыру кезінде картаны тексеру процедуралары орындалуы тиіс.

• Осы шарттарды орындау үшін банк-эквайер Visa International және MasterCard – З-D Secure (Verified by Visa және MasterCard SecureCode) халықаралық төлем жүйелерімен жасақталған Интернеттегі төлемдердің қауіпсіздігін қамтамасыз етудің арнайы технологияларын пайдаланады.

• Технологиялық платформа ретінде Интернет-дүкеннің сайты мен бизнес-процестерін өзгертпей, дүкенге қажетті қауіпсіздік процедураларын орындауға мүмкіндік беретін төлем шлюзі пайдаланылады.

Мобильді SDK

Мобильді құрылғыларды төлем шлюзімен байланыстыру үшін мобильді қолданбаға банк картасының мәліметтерін енгізу пішінін ендіру үшін біздің Мобильді SDK жиынтығын пайдалануыңызға болады.

Мобильді SDK жиынтығы төлем шлюзінің API экожүйесінің құрамдасы болып табылады және мобильді құрылғылардан онлайн-төлемдерді қабылдауға мүмкіндік береді. Мобильді SDK төлемдерді жасау пішінін сіздің iOS немесе Android жүйелерінің негізіндегі қолданбаңызға ендіруге мүмкіндік береді. Мобильді SDK төлем мәліметтерін енгізу процесінің қауіпсіздігін қамтамасыз етеді. Бұл мақалада бірінші төлемді алу қадамдары көрсетілген. Сіз реттеген барлық төлем әдістері клиенттеріңізге қолжетімді болады.

Орындау әдісі:

1. Пайдаланушы мобильді қолданбаңызда төлеу әдісін таңдайды, қажетті деректерді енгізеді және төлем жасау қадамына өтеді;
2. Мобильді қолданба seToken (өздігінен шифрланған токен) токенін жасап, төлем деректерін шифрлайды;
3. Мобильді қолданба рұқсат алу үшін seToken токенін төлем шлюзіне жібереді.

iOS

SDK жиынтығы қолдау көрсететін төлем әдістері:

• Талаптар: iOS 10.0+

iOS SDK туралы толығырақ

Android

SDK жиынтығы қолдау көрсететін төлем әдістері:

• Талаптар: Android 5.0+

Android SDK туралы толығырақ

Қосу қадамдары

Төлемдерді мобильді қолданба арқылы қабылдау үшін төмендегі әрекеттерді орындау қажет:

1. Интернет-дүкеніңізді банкте тіркеу;
2. Сатушы консоліне қатынасу үшін сынақ есептік жазба деректерін алу;
3. API әдістерін шақыру үшін сынақ есептік жазба деректерін алу;
4. Төлем шлюзімен сынақ режимде байланыстыру;
5. Сынақ режимде байланыстыру әдісі реттелген соң, қадамның орындалғанын тексеру үшін банктің қолдау көрсету қызметіне хабарласыңыз;
6. Сатушы консоліне қатынасу үшін белсенді есептік жазба деректерін алу;
7. API әдістерін шақыру үшін белсенді есептік жазба деректерін алу;
8. Банкіңізбен жүйеңіздің белсенді режимге ауысуы туралы келісіңіз;
9. Банк өкілімен интернет-дүкеннің белсенді режимде жұмыс істеуге дайындығы жөніндегі келісімшартқа қол қойыңыз;
10. Белсенді режимде жұмысты бастау.

SDK арқылы төлеу процесі

SDK арқылы төлеу әдісі төмендегі диаграммада көрсетілген

1-қадам. Клиент тапсырысты мобильді қолданбада тіркеп, mdOrder (rest/register.do) алады. Байламдарды пайдалану қажет болса, міндетті түрде clientId параметрін беру керек.

2-қадам. Мобильді қолданба mdOrder жіберу арқылы мобильді SDK жиынтығын іске қосады.

3-қадам. Мобильді SDK getSessionStatus.do әдісі арқылы тапсырыс туралы барлық қажетті ақпаратты алады.

4-қадам. Мобильді SDK карта деректерін енгізу пішінін көшіреді (байламдар мен Apple Pay жүйесі арқылы орындалуы мүмкін).

5-қадам. Клиент қажетті төлем әдісін таңдайды (карта, байлам, токендер арқылы төлеу).

6-қадам. SDK төлемге сұрауды жібереді. * a. SDK карта арқылы төлеу үшін шлюз әдісін қолданады (processform.do). Картаны сақтау опциясы таңдалса, bindingNotNeeded=false беріледі, таңдалмаса – bindingNotNeeded=true беріледі (міндетті түрде false болуы керек, параметрді елемеуге болмайды). * b. SDK байлам арқылы төлеу үшін шлюз әдісін қолданады (processBindingForm.do). Осында тапсырыс нөмірі mdOrder арқылы емес, orderId арқылы берілетінін ескеріңіз. * c. SDK токен арқылы төлеу үшін (/applepay/payment.do немесе /google/payment.do) шлюз әдісін қолданады.

7-қадам. Жауап ретінде төлем мәліметтері келеді. 7a-қадам. Төлем жасалса, күйін тексеру тармағына өтеміз (21-т.). 7b-қадам. 3DS2 талап етілсе, келесі тармаққа өтеміз.

8-қадам. SDK жиынтығы 3DS2 SDK іске қосады.

9-қадам. SDK құрылғы туралы шифрланған деректерді алады.

10-қадам. SDK шлюзді қайта шақырады, бірақ осыған шифрланған деректерді қосады.

11a-қадам. Frictionless жағдайында, процесс сәтті/сәтсіз төлеммен аяқталуы мүмкін, осы кезде күйін тексеру тармағына өту қажет. 11b-қадам. Challenge Flow жағдайында, ACS серверіне өту үшін SDK жиынтығы барлық қажетті деректерді 3DS2 SDK жиынтығына өткізу үшін алады.

12-қадам. SDK растау пішімі үшін 3DS2 SDK жиынтығын шақырады.

13-қадам. Бастапқы пішінді алу үшін 3DS2 SDK жиынтығы ACS серверімен байланысады.

14-қадам. Клиент растау кодын енгізеді.

15-қадам. 3DS2 SDK жиынтығы растау кодын ACS серверіне жібереді.

16-қадам. ACS операцияның сәтті не сәтсіз аяқталғаны туралы хабарлайды.

17-қадам. 3DS2 SDK хабарландырумен SDK жиынтығын шақырады.

18-қадам. SDK finish3dsVer2PaymentAnonymous.do төлем шлюзі әдісін қолданады. Әдістің сипаттамасын осында қараңыз.

19-қадам. Төлем шлюзі қаражатты есептен шығарады.

20-қадам. SDK төлем шлюзінен жауап алады.

21-қадам. SDK тапсырыс күйін тексереді. Күйінде redirect ЖӘНЕ remainingSecs > 0 өрісі БОЛМАСА, тағы бір рет төлем жасап көруге болады.

22-қадам. SDK callback хабарландыруына жіберу үшін тапсырыс бойынша қорытынды деректерді жинайды (операцияның, атрибуттарының сәтті-сәтсіз болғаны туралы деректер).

23-қадам. SDK мобильді қолданбаға төлемнің іске асырылғаны туралы хабарлайды.

Төлемдерді өңдеу

Төлем шлюзіндегі барлық төлемдер арнайы нысандар — Тапсырыстар ретінде өңделеді. Операцияны орындау үшін Тапсырысты тіркеп, авторизация деректерін жіберу керек.

1-қадам. Клиент өз құрылғысындағы мобильді қолданбада (МҚ) төлем жасауды бастайды;

2-қадам. Мобидьді қолданба тіркеу сұрауын дүкеннің мобильді қолданба бэкендіне (МҚБ) жібереді;

3-қадам. Дүкеннің мобильді қолданба бэкенді (МҚБ) тапсырысты тіркеу сұрауын төлем шлюзіне жібереді;

4-қадам. Төлем шлюзі тапсырысты тіркеп, бірегей идентификаторды жасайды;

5-қадам. Төлем шлюзі 3-қадамда сұрау бойынша алынған жауап ретінде тапсырыстың бірегей идентификаторын дүкеннің мобильді қолданба бэкендіне қайтарады;

6-қадам. Дүкеннің мобильді қолданба бэкенді идентификаторды мобильді қолданбаға жібереді;

7-қадам. Мобильді қолданбада төлем деректерін енгізу пішіні көрсетіледі;

8-қадам. Клиент төлем деректерін енгізеді;

9-қадам. Мобильді қолданба шифрланған хабарды жасайды;

10-қадам. Мобидьді қолданба шифрланған хабарды дүкеннің мобильді қолданба бэкендіне жібереді;

11-қадам. Дүкеннің мобильді қолданба бэкенді шифрланған хабарды төлемді жасау сұрауымен бірге төлем шлюзіне жібереді;

12-қадам. Төлем шлюзі шифрланған хабарды ашып, стандартты тексерулерді бастайды;

13-қадам. Төлем шлюзі 11-қадамда алынған сұрауға жауапты жібереді.

14-қадам. Дүкеннің мобильді қолданба бэкенді мобильді қолданбада банк-эмитентінің ACS серверіне қайта бағыттайды;

15-қадам. Мобильді қолданба банк-эмитентінің ACS серверінде аутентификация бетін талап етеді;

16-қадам. Банк-эмитентінің ACS сервері клиентке аутентификация бетін жібереді;

17-қадам. Клиент аутентификация деректерін енгізеді;

18-қадам. Банк-эмитентінің ACS сервері карта иесінің аутентификациясын орындайды;

19-қадам. Банк-эмитентінің ACS сервері мобильді қолданбада PARes қоса алғанда, төлем шлюзіне қайта бағыттайды;

20-қадам. Аутентификация сәтті өтсе, төлем шлюзі тапсырысқа рұқсат береді;

21-қадам. Төлем шлюзі мобильді қолданбада 2-қадамда алынған интернет-дүкеннің соңғы URL-мекенжайына қайта бағыттайды;

22-қадам. Мобильді қолданба дүкеннің мобильді қолданба бэкендінен тапсырыс туралы ақпаратты сұрайды;

23-қадам. Дүкеннің мобильді қолданба бэкенді төлем шлюзінен тапсырыс туралы ақпаратты талап етеді;

24-қадам. Төлем шлюзі дүкеннің мобильді қолданба бэкендіне тапсырыс туралы ақпаратты жібереді;

25-қадам. Дүкеннің мобильді қолданба бэкенді тапсырыс туралы ақпаратты мобильді қолданбаға жібереді;

26-қадам. Мобильді қолданба орындалған әрекеттердің нәтижелерін көрсетеді.

1-қадам. Тапсырысты тіркеу

Тапсырысты тіркеу үшін сервер-сервер байланысы арқылы register.do сұрауын жіберу керек:

Сұрау параметрлері

Жауап параметрлері

Сұрау мысалдары

Bash

curl -X POST "__API_PREFIX__/rest/register.do?
userName=username&
password=password&
orderNumber=1&
amount=12345&
currency=978&
returnUrl=https%3A%2F%2Fwww.merchant.com&
description=description&
language=en&
clientId=1&
jsonParams=%7B%22name%22%3A%20%22value%22%7D&
features=VERIFY"

Node.js

const request = require("request")

request.post({
  url: "__API_PREFIX__/rest/register.do",
  form: {
    userName: "username",
    password: "password",
    orderNumber: "1",
    amount: 1234,
    currency: 978,
    returnUrl: "https://www.merchant.com",
    description: "description",
    language: "en",
    clientId: "1",
    features: "VERIFY"
  }
})

PHP

<?php

$data = array(
    "userName" => "username",
    "password" => "password",
    "orderNumber" => "1",
    "amount" => 1234,
    "currency" => 978,
    "returnUrl" => "https://www.merchant.ru",
    "description" => "description",
    "language" => "en",
    "clientId" => "1",
    "features" => "VERIFY"
);

$data_string = json_encode($data);

$ch = curl_init("__API_PREFIX__/rest/register.do");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$result = curl_exec($ch);

Жауап мысалы

{
  "orderId":"70906e55-7114-41d6-8332-4609dc6590f4",
  "formUrl":"__API_PREFIX__/merchants/test/payment_ru.html?mdOrder=70906e55-7114-41d6-8332-4609dc6590f4"
}

2-қадам. Шифрланған хабарды алу

Шифрланған хабарды алу үшін Mobile SDK жиынтығын пайдалану қажет:

3-қадам. Авторизация үшін карта мәліметтерін жіберу

Авторизация үшін карта мәліметтерін жіберу кезінде сервер-сервер байланысындағы paymentOrder.do сұрауы пайдаланылады:

Сұрау параметрлері

Жауап параметрлері

Сұрау мысалдары

Bash

curl -X POST "__API_PREFIX__/rest/paymentorder.do?
userName=username&
password=password&
MDORDER=f1dc9771-7244-7fea-84f4-58905e249650&
seToken=530mMcGg36q703D4LrKicakmVzwyPPJ0LpXU4iPS...ZY3NZyKrZVNM&
language=en"

Node.js

const request = require("request")

request.post({
  url: "__API_PREFIX__/rest/paymentorder.do",
  form: {
    userName: "username",
    password: "password",
    MDORDER: "f1dc9771-7244-7fea-84f4-58905e249650",
    seToken: "530mMcGg36q703D4LrKicakmVzwyPPJ0LpXU4iPSZY3NZyKrZVNM...",
    language: "en"
  }
})

PHP

<?php

$data = array(
    "userName" => "username",
    "password" => "password",
    "MDORDER" => "f1dc9771-7244-7fea-84f4-58905e249650",
    "seToken" => "530mMcGg36q703D4LrKicakmVzwyPPJ0LpXU4iPSZY3NZyKrZVNM...",
    "language": "en"
);

$ch = curl_init("__API_PREFIX__/rest/paymentorder.do");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$result = curl_exec($ch);

Жауап мысалы

{
  "errorCode":0,
  "info":"Ваш платёж обработан, происходит переадресация...",
  "acsUrl":"https://web.rbsuat.com/acs/auth/start.do",
  "termUrl":"__API_PREFIX__/rest/finish3ds.do?lang=en",
  "paReq":"eJxVUttygjAQ/RWGdwzBBNRZ41jpdUZ0tHbqYyShYCvQAB3L1zdRaWue9uzl7O7ZwOR4+LC+pKqyIh/buOfalszjQmT529=..."
}

4-қадам. Тапсырыстың күйі туралы ақпаратты алу

Тіркелген тапсырыстың күйі туралы ақпаратты алу үшін сервер-сервер байланысындағы getOrderStatusExtended.do сұрауын пайдаланыңыз:

Сұрау параметрлері

Жауап параметрлері

Сұрау мысалдары

Bash

curl -X POST "__API_PREFIX__/rest/getOrderStatusExtended.do?
orderId=b9054496-c65a-4975-9418-1051d101f1b9&
language=en"

Node.js

const request = require("request")
request.post({
  url: "__API_PREFIX__/rest/getOrderStatusExtended.do",
  form: {
    orderId: "b9054496-c65a-4975-9418-1051d101f1b9",
    language: "en"
  }
})

PHP

<?php

$data = array(
    "orderId" => "b9054496-c65a-4975-9418-1051d101f1b9",
    "language" => "en"
);

$ch = curl_init("__API_PREFIX__/rest/getOrderStatusExtended.do");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$result = curl_exec($ch);

Жауап мысалы

{
  "expiration":"201512",
  "cardholderName":"NIKOLA TESLA",
  "depositAmount":789789,
  "currency":"978",
  "approvalCode":"123456",
  "authCode":2,
  "clientId":"69",
  "bindingId":"07a90a5d-cc60-4d1b-a9e6-ffd15974a74f",
  "ErrorCode":"0",
  "ErrorMessage":"Success",
  "OrderStatus":2,
  "OrderNumber":"ordernumber_42",
  "Pan":"411111**1111",
  "Amount":789789
}

Тапсырыстан бас тарту (reversal)

Тапсырыстан бас тарту үшін сервер-сервер байланысындағы reverse.do сұрауын пайдаланыңыз:

Сұрау параметрлері

Жауап параметрлері

Сұрау мысалдары

Bash

curl -X POST "__API_PREFIX__/rest/reverse.do?
  orderId=b9054496-c65a-4975-9418-1051d101f1b9&
  language=en"

Node.js

const request = require("request")
request.post({
  url: "__API_PREFIX__/rest/reverse.do",
  form: {
    orderId: "b9054496-c65a-4975-9418-1051d101f1b9",
    language: "en"
  }
})

PHP

<?php

$data = array(
    "orderId" => "b9054496-c65a-4975-9418-1051d101f1b9",
    "language" => "en"
);

$ch = curl_init("__API_PREFIX__/rest/reverse.do");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$result = curl_exec($ch);

Жауап мысалы

{
  "errorCode":"0",
  "errorMessage":"Success"
}

Тапсырыс бойынша қаражатты қайтару (refund)

Қайтару үшін сервер-сервер байланысындағы refund.do пайдаланыңыз:

Сұрау параметрлері

Жауап параметрлері

Арнайы сипаттарды пайдалану (features)

Операцияларды орындау үшін арнайы параметрлерді пайдалануға болады:

Сұрау мысалдары

Bash

curl -X POST "__API_PREFIX__/rest/refund.do?
  amount=500&
  currency=978&
  language=en&
  orderId=5e97e3fd-1d20-4b4b-a542-f5995f5e8208"

Node.js

const request = require("request")

request.post({
  url: "__API_PREFIX__/rest/refund.do",
  form: {
    amount: "500",
    currency: "978",
    language: "en",
    orderId: "5e97e3fd-1d20-4b4b-a542-f5995f5e8208"
  }
})

PHP

<?php

$data = array(
    "amount" => "500",
    "currency" => "978",
    "orderId" => "5e97e3fd-1d20-4b4b-a542-f5995f5e8208",
    "language" => "en"
  );

$ch = curl_init("__API_PREFIX__/rest/refund.do");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$result = curl_exec($ch);

Жауап мысалы

{
  "errorCode": "0",
  "errorMessage": "Success"
}

API арқылы 3DS2 тапсырысын аяқтау

API арқылы 3DS2 тапсырысын аяқтау үшін Finish3dsVer2PaymentAnonymous.do әдісі пайдаланылады.

Сұрау параметрлері

Жауап параметрлері

Қосымша ақпарат

Features қолдану

Операцияларды орындау үшін арнайы параметрлерді пайдалануға болады:

jsonParams пайдалану

jsonParams пішімін тапсырыс туралы қосымша ақпаратты пайдалану және сақтау үшін беру мақсатында қолдануға болады. Қосымша параметрлерді төлем шлюзінің мерчант консолінде көруге болады.

Қосымша параметрлер келесі жолмен беріледі {"<name1>":"<value1>",...,"<nameN>":"<valueN>"} Осы өрістер кейін тізілімде көрсетілуі үшін банк процессингіне жіберілуі мүмкін.

Сонымен қатар, қосымша ретінде келесі параметрлерді көрсетуге болады:

Тапсырыстың ықтимал күйлері (orderStatus)

errorCode мәндері

Қауіпсіздік талаптары

Осы құжатта сипатталған функциялар қауіпсіздік талаптарына сәйкес орындалуы керек:

1. Карта мәліметтерін ашық түрде жіберуге қатаң тиым салынады;
2. Шифрлау клиент құқрылғысында орындалуы тиіс;
3. Шифрланған хабарларды төлемді жасағаннан кейін сақтауға және/немесе қайта пайдалануға тиым салынады.
4. Картаны сақтау PCI-DSS талаптарына сәйкес орындалуы тиіс. Байлам жасау үшін сақталатын карта мәліметтері (тиісті идентификаторлар) төлем шлюзінде сақталады.
5. 3DSec аутентификациясы үшін эмитент ACS серверінің веб-парақшасы клиенттерге мобильді платформаның WebView көрінісі арқылы көрсетіледі. ACS бетінде сақталуы мүмкін мекенжай жолағының, сондай-ақ, белсенді элементтердің URL шақырулары өшірілуі керек;

PCI DSS қауіпсіздік талаптары

PCI DSS құжаттамасында шифрланған хабарларды пайдалану жолы төмендегідей сипатталады:

яғни, төлем деректерін үшінші тараптар өңдейді, бірақ дүкен сайты да карта мәліметтерінің қауіпсіздігі үшін жауапты болады.

Стандарттарға сәйкес келуі үшін, интернет-дүкен SAQ-EP талаптарына сай болып, тоқсан сайын ASV растауы алуы керек. Өзге талаптар қойылмайды.

1: Әдепкі бойынша, банк процессингіне келесі өрістер жіберіледі:

orderNumber – дүкен жүйесіндегі тапсырыс идентификаторы,

description – тапсырыс сипаттамасы (ең көбі, 24 таңба, рұқсат етілмеген таңбалар: %, +, күймешені қайтару \r және жолды түсіру \n).