Apple Pay

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

Merchant ID жасау

Өз Merchant ID (Сатушының идентификаторы) жасау үшін, келесі әрекеттерді орындаңыз.

1. Apple Member Center жеке кабинетінде Certificates, Identifiers & Profiles сілтемесі бойынша өтіңіз.
2. Пайда болған бетте Identifiers бөлімінде Merchant IDs опциясын таңдаңыз.
3. Пайда болған бетте жоғарғы оң жақ бұрыштағы + белгісіне басыңыз.
4. Merchant ID Descritpion және Identifier өрістерінде Apple сатушы идентификаторыңыздың сипаттамасын және сәйкесінше идентификатордың өзін де енгізіңіз.
   
5. Continue түймесін басыңыз.
6. Пайда болған бетте енгізілген деректерді тексеріп, Register түймесін басыңыз.
7. Пайда болған бетте Done түймесін басыңыз.

Merchant ID үшін сертификат жасау

Әр транзакция үшін сізге Apple Pay төлем сеансын сұрату қажет болады, оған сіздің сатушы сәйкестендіру сертификатыңыз керек. Одан кейін, осы сертификатты жасау жолы айтылады.

1. Apple әзірлеген өзіңіздің есептік жазбаңызға https://developer.apple.com бетінде кіріңіз.
2. Сәйкес Apple құжаттамасын негізге ала отырып, сертификатты жасаңыз.
3. Сатушының идентификаторын таңдау қадамында бұрын жасалған сатушы идентификаторын таңдаңыз.
4. Өз бетіңізше CSR жасау үшін, Apple нұсқауларын орындаңыз. Банктен алған CSR кілтін сатушының сәйкестендіру сертификатын жасау үшін пайдалануға болмайды.
5. Жасалған сатушының сәйкестендіру сертификатын жүктеп, сақтап алыңыз (.cer файлы).
6. Apple құжаттамасындағы нұсқауларды орындағаннан кейін, сатушының сәйкестендіру сертификатын өзіңіздің кілттер тізбегіңізге (keychain) қосыңыз.
7. Кілттер тізбегінен сертификатты .p12 файлы түрінде экспорттаңыз.
8. Келесі команданы пайдалану арқылы .p12 файлын .rem файлына түрлендіріңіз:
   openssl pkcs12 -in your-file.p12 -out apple-pay-cert.pem -nodes -clcerts
9. apple-pay-cert.pem файлын өз серверіңізге немесе .p12 файлын банктің жеке кабинетіне жүктеңіз.

Apple Pay төлем сеансының сұратымы кезінде apple-pay-cert.pem файлына толық жолды пайдаланыңыз.

Сертификатты тіркеу

Apple Pay арқылы төлемдерді қабылдау үшін сізде кілттер жұбы мен оның тиісті ашық кілт сертификаты болуы керек. Жеке кабинеттегі қажетті әрекеттер сізде кілттер жұбының және оның сертификатының бар-жоғына байланысты болады.

Жаңа сертификат жасау

Кілттер жұбын жасау үшін келесі әрекеттерді орындаңыз.

1. Жеке кабинетке кіріп, сол жақтағы бүйірлік мәзірден Сертификаттар тармағын таңдаңыз.
2. Apple Pay түймесін басыңыз.
3. Кілттер жұбын жасау тармағын таңдаңыз.
   Келесі терезе пайда болады.
   
4. Қажетті өрістерді толтырыңыз (төмендегі кестені қараңыз).

• Тиісті өзгертулерді енгізген соң, Жасау түймесін басыңыз.

Жасалған кілттер жұбы Apple Pay бөлімінде пайда болады (төмендегі суретті қараңыз).

CSR сұрауын жүктеп алу бөліміне өтіңіз.

Бұрын жасалған сертификатты жүктеу

Бұрыннан бар кілттер жұбын жүктеу үшін келесі әрекеттерді орындаңыз.

1. Жеке кабинетке кіріп, сол жақтағы бүйірлік мәзірден Сертификаттар тармағын таңдаңыз.
2. Apple Pay түймесін басыңыз.
3. Мерчанттарды анықтау сертификаттары бөліміндегі Кілтті қосу түймесін басыңыз.
   Келесі терезе пайда болады.
   
4. Мына өрістерді толтырыңыз:
   • Apple ID – Merchant Apple ID нөмірін көрсетіңіз.
   • Құпиясөз – PKCS12 файлын қорғайтын құпиясөзді енгізіңіз.
   • Әдепкі домен – интернет-дүкеннің доменін енгізіңіз.
5. Кілттер жұбы файлын тағайындалған аймаққа жылжытыңыз.
   Файл тізімде көрсетіледі.
   
6. Жасау түймесін басыңыз. Импортталған сертификат Мерчанттарды анықтау сертификаттары тізімінде пайда болады.

Осыдан кейін сертификат бойынша келесі әрекеттерді орындау керек.

• Apple Merchant ID өңдеу
• Сертификатты пайдалануға шектеуді орнату

Сертификат қолтаңбасын сұрау файлын экспорттау (CSR)

Сертификатқа қол қою сұрауын жүктеп алу үшін келесі әрекеттерді орындаңыз.

1. Жеке кабинетке кіріп, сол жақтағы бүйірлік мәзірден таңдаңыз (Сертификаттар бөлімі)
2. Қажетті төлем жасау қызметін таңдаңыз (Apple Pay, Google Pay немесе Samsung Pay).
3. Қажетті сертификат жолағында белгішесін басып, CSR сұрауын жүктеп алу тармағын таңдаңыз (төмендегі суретті қараңыз).
   
   Келесі терезе пайда болады.
4. Файлды сақтау жолын көрсетіңіз немесе оны әдепкі бойынша таңдалған қалтаға сақтаңыз.

Сонымен қатар, сізге мына әрекеттерді орындауға болады.

• Apple Merchant ID өңдеу
• Сертификатты пайдалануға шектеуді орнату

Merchant ID өңдеу

Apple Merchant ID нөмірін өзгерту үшін келесі әрекеттерді орындаңыз.

1. Жеке кабинетке кіріп, сол жақтағы бүйірлік мәзірден Сертификаттар тармағын таңдаңыз.
2. Apple Pay түймесін басыңыз.
3. Түймені басып, Өзгерту тармағын таңдаңыз (төмендегі суретті қараңыз).
   
   Келесі терезе пайда болады.
   
4. Apple ID өрісін өзгертіп, Растау түймесін басыңыз.

Сертификатты ажырату

Кілтті пайдалануға тыйым салу үшін келесі әрекеттерді орындаңыз.

1. Жеке кабинетке кіріп, сол жақтағы бүйірлік мәзірден таңдаңыз (Сертификаттар бөлімі)
2. Қажетті төлем жасау қызметін таңдаңыз (Apple Pay, Google Pay немесе Samsung Pay).
3. Қажетті сертификат жолағында белгішесін басып, Пайдалануға тыйым салу параметрін таңдаңыз (төмендегі суретті қараңыз).
   
   Келесі терезе пайда болады.
   
4. Растау түймесін басыңыз.

Пайдалануға тыйым салынған сертификаттың көрсетілуі Сертификаттар бөлімінің жоғарғы жағында орналасқан Рұқсат етілген сертификаттар параметрінің таңдалуына байланысты болады (төмендегі суретті қараңыз).

Параметр	Сипаттама
Рұқсат етілген сертификаттар параметрі таңдалған	Рұқсат етілмеген сертификаттар сертификаттардың тізімінде көрсетілмейді.
Рұқсат етілген сертификаттар параметрі таңдалмаған	Рұқсат етілмеген сертификаттар тізімде көрсетіледі, бірақ осы сертификаттарға қарама-қарсы Рұқсат етілген бағанында Жоқ мәні көрсетіледі (төмендегі суретті қараңыз).

Веб-біріктіру үшін қажетті әрекеттер

Веб-біріктіру мүмкіндігін қамтамасыз ету үшін, келесі әрекеттерді орындаңыз.

1. Apple жүйесіне өз доменіңізді тіркеп, растаңыз.
   • Егер төлеу беті сіздің жағыңызда болса, өз доменіңізді тіркеңіз.
   • Егер төлем беті төлем шлюзінің жағында болса, төлем шлюзінің доменін көрсетіңіз.
2. Сатушының сәйкестендіру сертификатын жасап, оны .rem файлына түрлендіріңіз де, оны өз серверіңізге жүктеңіз.

Бұл сертификат Apple Pay серверлеріне қосылымдарды аутентификациялау үшін қолданылады.

Apple жүйесіне доменді тіркеу

Apple жүйесіне сертификатты тіркеу үшін, келесі әрекеттерді орындаңыз.

1. Apple әзірлеген өзіңіздің есептік жазбаңызға https://developer.apple.com бетінде кіріңіз.
2. Доменді тіркеу үшін, Apple әзірлеген есептік жазба анықтамасының нұсқауларын орындаңыз.

Сатушының идентификаторын таңдау қадамында бұрын жасалған сатушы идентификаторын таңдаңыз.

Интеграция үлгісі

1. Пайдаланушы ұялы қолданбада Apple Pay көмегімен төлем нұсқасын таңдайды.
2. Төлем жөніндегі мәліметтер Apple Pay жүйесіне өңдеуге жолданады.
3. Apple Pay жүйесінде төлем туралы деректерді өңдеу мақсатында paymentData сипатын қамтитын PKPaymentToken Object нысаны жасалады (осы жерде және одан кейін Apple Pay құжаттамасын қараңыз).
4. Apple Pay сатушыға (ұялы қолданбаға) жауапты жолдайды.
5. Сатушы алынған PKPaymentToken Object нысанынан paymentData сипатын шығарып алып, оның мазмұнын Base64 түріне кодтайды.
6. Сатушы Apple Pay жүйесінің жауабынан алынып, Base64 түріне кодталған paymentData сипатын қамтитын төлеуге сұратымды жасап, оны төлем шлюзіне өңдеуге жібереді (Apple Pay арқылы төлеуге сұратымды қараңыз).
7. Төлем жүйесі сұратымды өңдейді.
8. Төлем жүйесі нәтиже көрсетілген жауапты қайтарады.
9. Ұялы қолданба пайдаланушыға төлеу нәтижесін көрсетеді.

Анықтамалық ақпаратқа сілтемелер

Google Pay

Кіріспе

Төлемді Google Pay жүйесі арқылы жасаудың бірнеше әдісі бар.

Байланыс схемалары

Мобильді қолданбада төлеу

1. Клиент Google Pay.арқылы төлем жасауды таңдайды.
2. Қолданба картаның жасырын деректері туралы Google Pay ақпаратын сұрайды.
3. Google Pay қолданбаға картаның жасырын деректерін қайтарады.
4. Қолданба Google Pay жүйесіне қосылған картаның жасырын деректерін клиентке көрсетеді.
5. Клиент Google Pay жүйесіне қосылған карта арқылы төлемді растайды.
6. Қолданба Google Pay жүйесінен картаның жасырын деректерін сұрайды.
7. Google Pay мерчанттың ашық кілтін пайдаланып, деректерді шифрлайды.
8. Google Pay қолданбаға төлем туралы шифрланған деректерді қайтарады.
9. Қолданба Google Pay жүйесінен алынған токенді көрсетіп, төлем шлюзіне Google Pay арқылы төлем жасау сұрауын жібереді.
10. Төлем шлюзі алынған токен шифрын ашып, төлем жасайды.
11. Төлем шлюзі қолданбаға төлем нәтижесін қайтарады.
12. Қолданба төлем нәтижесін клиентке көрсетеді.

Интернет-дүкен тарапындағы төлем бетінде төлем жасау

1. Клиент интернет-дүкен сайтында тапсырысты құрып, Google Pay арқылы төлем жасау әдісін таңдайды.
2. Интернет-дүкен жүйесі Google Pay жүйесінде төлем жасау сұрауын құрады.
3. Google Pay жүйесі шифрланған төлем деректерін құрады.
4. Интернет-дүкен жүйесі шифрланған төлем деректерін алады.
5. Интернет-дүкен жүйесі алынған шифрланған төлем деректерін көрсетіп, төлем шлюзіне Google Pay жүйесі арқылы төлем жасау сұрауын құрады.
6. Төлем шлюзі алынған деректер шифрын ашып, төлем жасайды.
7. Төлем шлюзі төлем жасау нәтижелерін интернет-дүкенге қайтарады.
8. Төлем жасау нәтижесі клиентке көрсетіледі.

Төлем шлюзі тарапындағы төлем бетінен төлеу

Төлем беті Google Pay тарапында орналасса, төлем келесі үлгі бойынша жүзеге асырылады.

1. Клиент сатушының сайтында тапсырысты құрады.
2. Сатушы тапсырысты төлем шлюзінде тіркейді.
   • Бір кезеңді төлем;
   • Екі кезеңді төлем.
3. Төлем шлюзі төлем шлюзінің жүйесінде тапсырыстың бірегей нөмірін және клиент бағытталатын URL-мекенжайды қайтарады.
4. Дүкен жүйесі клиенттің браузерін 3-қадамда алынған URL-мекенжайға бағыттайды.
5. Клиенттің браузерінде URL-мекенжай ашылады.
6. Клиент төлем жасау пішінін алады.
7. Клиент Google Pay арқылы төлеу әдісін таңдап, өз таңдауын растайды.
8. Төлем шлюзі мен Google Pay арасында деректер алмасады – төлем шлюзі төлем деректерін алады.
9. Төлем шлюзі төлем жасайды.
10. Клиент дүкеннің соңғы бетіне бағытталады.
11. Клиенттің браузерінде соңғы бет ашылады.
12. Төлем күйі көрсетіледі.

Пайдаланушыны ACS серверіне қайта бағыттау төлем сценарийі

Пайдаланушы токені жоқ картамен Google Pay арқылы төлем жасау әдісін таңдаса, төлем шлюзіне төлем жасау сұрауына жауап ретінде пайдаланушыны эмитенттің ACS серверіне бағыттау деректері қайтарылады.

1. Клиент Google Pay.арқылы төлем жасау әдісін таңдайды.
2. Қолданба картаның жасырын деректері туралы Google Pay ақпаратын сұрайды.
3. Google Pay картаның жасырын деректерін қайтарады.
4. Қолданба Google Pay жүйесіне қосылған картаның жасырын деректерін клиентке көрсетеді.
5. Клиент Google Pay жүйесіне қосылған карта арқылы төлемді растайды.
6. Қолданба Google Pay жүйесінен картаның жасырын деректерін сұрайды.
7. Google ашық кілтті пайдаланып, деректерді шифрлайды.
8. Google Pay қолданбаға төлем туралы шифрланған деректерді қайтарады.
9. Қолданба Google Pay жүйесінен алынған токенді көрсетіп, төлем шлюзіне Google Pay арқылы төлем жасау сұрауын жібереді.
10. Төлем шлюзі алынған токен шифрын ашып, карта токенінің бар-жоғын тексереді. Болмаған жағдайда, 3-D  Secure протоколының қосылғанын тексереді.
11. Картада 3-D Secure протоколы қосылған болса, төлем шлюзі ACS серверіне бағыттау сілтемесі (acsUrl) және PaReq аутентификациясына сұрауы бар төлем жасау сұрауын жібереді.
12. Сатушы пайдаланушыны ACS сайтына бағыттайды. ACS серверіне бағыттау үшін сатушы өз тарапынан клиентті MD=mdorder&PaReq=pareq&TermUrl=redirect сұрау мәтіні бар  acsUrl параметрінде көрсетілген мекенжай арқылы бағыттауы керек, осында:
    • mdorder – төлем шлюзі жүйесіндегі тапсырыстың бірегей нөмірі,
    • pareq – төлем жасау сұрауына жіберілген жауаптағы параметр,
    • redirect – төлем жасау сұрауына жіберілген жауаптағы параметр (ACS серверінен қайтару мекенжайы).
13. Пайдаланушы ACS сайтына өтіп, аутентификацияны орындайды.
14. ACS аутентификация деректерін тексереді.
15. ACS аутентификация нәтижесін төлем шлюзіне бағыттайды (PaRes)
16. Төлем шлюзі төлемді өткізеді.
17. Төлем шлюзі төлем нәтижесін сатушыға жібереді.
18. Сатушы төлем күйін сұрайды.
19. Төлем шлюзі төлем нәтижесін қайтарады.
20. Сатушы нәтижені клиентке жібереді.

Сатушы тарапындағы төлем бетіне қойылатын талаптар

Сатушы тарапындағы төлем беті келесі талаптарға сәйкес келуі керек.

Шифры ашылған токенде төлем жасау әдісі ретінде CARD таңдалса, төлем жасау әдісін шақыру кезінде төлем бетінде 3DS протоколына бағыттау мүмкіндігі қамтамасыз етілуі керек. * Бетте Google Pay төлем жасау түймесі болуы керек. * Төлем бетінде Google Pay арқылы төлем жасауға мүмкіндік беретін түйме көрсетілуі керек.

paymentsClient.isReadyToPay({allowedPaymentMethods: allowedPaymentMethods})
    .then(function(response) {
      if (response.result) {
        // in this case the button should be displayed
        addGooglePayButton();
      }
    })
    .catch(function(err) {
      // show error in developer console for debugging
      console.error(err);
    });

function addGooglePayButton() {
  var button = document.createElement('button');
  button.className = 'google-pay';
  button.appendChild(document.createTextNode('Google Pay'));
  sbutton.addEventListener('click', onGooglePaymentButtonClicked);
  document.getElementById('container').appendChild(button);
}

• Төлем бетінде JavaScript Google қосылуы керек (толық ақпарат үшін Google құжаттамасын қараңыз:
  • https://developers.google.com/pay/api/web/guides/tutorial);
  • https://payments.developers.google.com/js/apis/pay.js.
• Төлем бетінде Google сайтымен сынақ байланыс орнату үшін environment параметрінің мәні TEST ретінде орнатылуы керек (код мысалын төменде қараңыз).

var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

Тексерулер аяқталған соң, беттің негізгі нұсқасының мәні Google қызметінен алынуы керек (толық ақпаратты Google құжаттамасынан қараңыз: https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist)).

Төлем бетінде paymentDataRequest нысаны құрылуы керек (код мысалын төменде қараңыз).

function getGooglePaymentDataConfiguration() {
  return {
    merchantId: '00000000000000000000', //constant for the bank's RBE; for the environment: 'TEST' is not indicated
    transactionInfo = {
        totalPriceStatus: 'FINAL',
        totalPrice: '123.45', //amount in major units
        currencyCode: 'KZT' //ISO 4217
    },
    paymentMethodTokenizationParameters: {
        tokenizationType: 'PAYMENT_GATEWAY',
        parameters: {
            gateway: 'some-bank', //constant for the bank's RBE
            gatewayMerchantId: 'exampleGatewayMerchantId' //merchant identifier in the payment gateway
        }
    },
    allowedPaymentMethods: ['CARD', 'TOKENIZED_CARD'],
    cardRequirements: {
        allowedCardNetworks: ['MASTERCARD', 'VISA']
    }
  };
}

• Google Pay арқылы төлем жасау түймесін басқаннан кейін paymentDataRequest нысаны Google қызметіне жіберілуі керек (код мысалын төменде қараңыз).

var paymentDataRequest = getGooglePaymentDataConfiguration();
paymentsClient.loadPaymentData(paymentDataRequest).then(function(paymentData){
  processPayment(paymentData);
}).catch(function(err){
  // show error in developer console for debugging
  console.error(err);
});

Кілттер жұбын жасау

Кілттер жұбын жасау үшін келесі әрекеттерді орындаңыз.

1. Жеке кабинетке кіріп, сол жақтағы бүйірлік мәзірден Сертификаттар тармағын таңдаңыз.
2. Google Pay опциясын таңдаңыз.
3. Кілттермен жұмыс істеу бөліміндегі Кілттер жұбын жасау түймесін басыңыз.
   Келесі терезе пайда болады.
   
4. Google ID өрісінде Google Pay жүйесінен алынған Google идентификаторын көрсетіп, Растау түймесін басыңыз.
5. Жасалған кілттер жұбы Кілттермен жұмыс істеу бөлімінде пайда болады (төмендегі суретті қараңыз).
   

Жалпыға ортақ кілтті жүктеп алу

Ашық кілтті жүктеп алу үшін келесі әрекеттерді орындаңыз.

1. Жеке кабинетке кіріп, сол жақтағы бүйірлік мәзірден Сертификаттар тармағын таңдаңыз.
2. Google Pay опциясын таңдаңыз.
3. Қажетті сертификатқа қарама-қарсы басып, Кілтті жүктеп алу тармағын таңдаңыз (төмендегі суретті қараңыз).
   
4. Файлды сақтау диалогтық терезесінде файлды сақтау жолын таңдаңыз немесе оны әдепкі бойынша таңдалған қалтаға сақтаңыз.

Сонымен қатар, мына әрекеттерді орындауға болады.

• Google ID өзгерту
• Сертификатты пайдалануға шектеуді орнату

Google ID өңдеу

Google ID нөмірін өзгерту үшін келесі әрекеттерді орындаңыз.

1. Жеке кабинетке кіріп, сол жақтағы бүйірлік мәзірден Сертификаттар тармағын таңдаңыз.
2. Google Pay опциясын таңдаңыз.
3. Қажетті сертификаттың қасындағы басып, Өзгерту тармағын таңдаңыз (төмендегі суретті қараңыз).
   Келесі терезе пайда болады.
   
4. Google ID өрісіндегі мәнді өзгертіп, Растау түймесін басыңыз.

Сертификатты ажырату

Кілтті пайдалануға тыйым салу үшін келесі әрекеттерді орындаңыз.

1. Жеке кабинетке кіріп, сол жақтағы бүйірлік мәзірден таңдаңыз (Сертификаттар бөлімі)
2. Қажетті төлем жасау қызметін таңдаңыз (Apple Pay, Google Pay немесе Samsung Pay).
3. Қажетті сертификат жолағында белгішесін басып, Пайдалануға тыйым салу параметрін таңдаңыз (төмендегі суретті қараңыз).
   
   Келесі терезе пайда болады.
   
4. Растау түймесін басыңыз.

Пайдалануға тыйым салынған сертификаттың көрсетілуі Сертификаттар бөлімінің жоғарғы жағында орналасқан Рұқсат етілген сертификаттар параметрінің таңдалуына байланысты болады (төмендегі суретті қараңыз).

Параметр	Сипаттама
Рұқсат етілген сертификаттар параметрі таңдалған	Рұқсат етілмеген сертификаттар сертификаттардың тізімінде көрсетілмейді.
Рұқсат етілген сертификаттар параметрі таңдалмаған	Рұқсат етілмеген сертификаттар тізімде көрсетіледі, бірақ осы сертификаттарға қарама-қарсы Рұқсат етілген бағанында Жоқ мәні көрсетіледі (төмендегі суретті қараңыз).

Қосылым координаттары

Сұраулар келесі талаптарға сәйкес болуы керек:

• барлық мәтіндік өрістер Юникод (UTF-8) арқылы берілуі керек;
• арнайы таңбалар URL кодына сәйкес экрандалуы керек, мысалы, qwe?rt%y құпиясөзі qwe%0Frt%25y түрінде көрсетілуі тиіс.

Төмендегі кестеде REST сұрауларына қатынасуға болатын URL-мекенжайлары көрсетілген.

Егер сіз REST-сұрауларын төлем шлюзінің сатушы консоліне кірген браузерден тексерсеңіз, кез келген REST сұрауын орындау төлем шлюзінің сатушы консоліндегі қатеге себеп болады. Төлем шлюзінің сатушы консоліндегі сеансты қалпына келтіру үшін мына қадамдарды орындау керек:

• сатушы консолінен шығып, қайта кіріңіз;
• мәселе шешілмесе, cookie файлдарын жойып, жүйеге қайта кіріңіз.

Қатенің пайда болуын алдын алу үшін төмендегі әдістердің бірін орындауға болады:

• REST-сұраулары үшін жасырын режимді пайдаланып, сатушы консолінде қалыпты режимде жұмыс істеу;
• REST-сұрауларын жіберу және сатушы консоліне кіру үшін әртүрлі браузерлерді пайдалану.