AlliancePay
🇺🇦 Українська
🇺🇦 Українська
  • E Commerce платформа AlliancePay v2.39.0
  • Аутентифікація
  • Криптування даних
  • Авторизація
  • Використання авторизаціїного токену
  • Опис роботи з ключами
    • Приклад PURCHASE колекції
    • Приклад А2С колекції
  • Платіжні методи H2H
    • PURCHASE
      • Запит проведення PURCHASE Крок 1
      • Запит проведення PURCHASE Крок 2
    • A2C
    • C2A
      • Запит проведення C2A Крок 1
      • Запит проведення C2A Крок 2
    • ApplePay decrypted
      • PURCHASE
        • Запит проведення платежу Крок 1
        • Запит проведення платежу Крок 2 (3DS)
      • C2A
        • Запит проведення C2A Крок 1
        • Запит проведення c2a Крок 2 (3DS)
    • ApplePay encrypted
      • Запит підтримки aPay на сторінці
      • Запит отримання данних мерчанта aPау
      • Запит валідації мерчанта
      • Запит встановлення сесії в aPау
      • Запит проведення платежу
    • GooglePay™ decrypted
      • PURCHASE
        • Запит проведення purchase Крок 1
        • Запит проведення purchase Крок 2 (3DS)
      • C2A
        • Запит проведення C2A Крок 1
        • Запит проведення c2a Крок 2 (3DS)
    • GooglePay™ encrypted
      • Докуменація GooglePay™
      • Запит підтримки GooglePay™ на сторінці
      • Запит отримання данних мерчанта GooglePay™
      • Запит проведення платежу
    • REFUND
    • TOKEN
      • PURCHASE
        • Запит проведення платежу по токену Крок 1
        • Запит проведення платежу по токену 3DS Крок 2
      • C2A
        • Запит проведення платежу по токену Крок 1
        • Запит проведення платежу по токену 3DS Крок 2
      • Запит створення токену
      • Запит отримання токену по customerId
      • Запит отримання даних токену
      • Запит зміни статуса токену
      • Статуси токена
    • Account Verification
      • Запит верифікації картки Крок 1
      • Запит верифікації картки Крок 2
    • Отримання даних
      • по OPERATION_ID
      • по merchantRequestId
    • Отримання балансу
    • Callback
  • Платіжні методи HPP
    • PURCHASE
      • Створення замовлення
      • Отримання даних по замовленню
    • REFUND
    • Callback
    • Статуси замовлення
  • Платіжні віджети для CMS
    • OpenCart
      • Інструкція по встановленню
      • Функціонал та опис платіжного модуля
      • Структура бази даних
  • Довідники
    • Статус транзакції
    • Тест кейси
    • Коди помилок
    • Значення actionCode, responseCode
    • Ліміти
    • Інструкція звірки по реєстрам
      • Опис полів в реєстрах
    • WhiteListing IP-адрес та URL-адрес
  • Історія змін
Powered by GitBook
On this page
  1. Опис роботи з ключами

Приклад PURCHASE колекції

PreviousОпис роботи з ключамиNextПриклад А2С колекції

Last updated 4 months ago

1. Authorize by virtual device — {{url}}/api-gateway/authorize_virtual_device Для запиту потрібен serviceCode, котрий ми передаємо Вам перед інтеграцією на проді. У відповідь повернеться зашифрований серверний ключ - serverPublicKey у форматі jwe, котрий буде потрібен для виконання кроку 2.

2. Decrypt auth response — {{url}}/cipher/decrypt_by_jwk?message={{responseJwe}} Запит декриптує відповідь банку на своїй стороні за допомогою приватного ключа - userPrivateKey (котрий Мерчант генерує за інструкцією ) , щоб отримати серверний ключ - serverPublicKey у відкритому вигляді, котрий буде потрібен для виконання кроків 5 та 8. На Продакшн середовищі, Мерчант самостійно повинен виконувати декриптування на своїй стороні.

3. Encrypt card number — {{url}}/cipher/encrypt_by_jwk?message={{card_number}} За допомогою платіжного ключа - paymentPublicKey, котрий Банк надає Мерчанту, відбувається криптування номеру картки клієнта. Для тестування можна скористатися допоміжним методом "/ecom/help/encrypt_by_jwk". На Продакшн середовищі, Мерчант самостійно повинен виконувати криптування на своїй стороні.

4. Ecnrypt Date and Security cvv — {{url}}/cipher/encrypt_by_jwk?message={{year_month_day}} За допомогою платіжного ключа - paymentPublicKey, котрий Банк надає Мерчанту, виконується криптування терміну дії та cvvа. Передається у форматі: рік, місяць, cvva - "2603123" Для тестування можна скористатися допоміжним методом "/ecom/help/encrypt_ru_jwk". На Продакшн середовищі, Мерчант самостійно повинен виконувати криптування на своїй стороні.

5. Encrypt create purchase request body — {{url}}/cipher/encrypt_by_jwk?message={{body_request}} {{body_request}} - повинно відповідати обов'язковим вхідним параметрам За допомогою розкриптованого серверного ключа - serverPublicKey, котрий отримано на кроках 1 і 2, виконується криптування тіла запиту для створення платежу на стороні Мерчанта. У відповідь отримуємо зашифроване тіло запиту - {{encryptJweT}} Для тестів допускається використання допоміжного методу "/ecom/help/encrypt_ru_jwk"

6. Create Purchase — {{url}}/ecom/execute_request/payments/v3/create/purchase Запит відправляє зашифроване тіло запиту - {{encryptJweT}}, згенероване на кроці 5. У відповіді отримуємо зашифровану відповідь - {{responseJwe}}, котра буде потрібна для виконання кроку 7.

7. Decrypt craet purchase response — {{url}}/cipher/decrypt_by_jwk?message={{responseJwe}} Запит декриптує відповідь від банку за допомогою приватного ключа - userPrivateKey, (котрий Мерчант генерує за інструкцією ). У відповідь отримуємо розшифровану тіло відповіді на запит у кроці 6.

8. Encrypt execute purchase request body — {{url}}/cipher/encrypt_by_jwk?message={{body_request}} {{body_request}} - повинно відповідати обов'язковим вхідним параметрам За допомогою розкриптованого серверного ключа - serverPublicKey, котрий отримано на кроках 1 і 2, виконується криптування тіла запиту на проведення платежу. У відповідь отримуємо зашифроване тіло запиту - {{encryptJweT}} Для тестів допускається використання допоміжного методу "/ecom/help/encrypt_by_jwk"

9. Execute Purchase — {{url}}/ecom/execute_request/payments/v1/execute/purchase Запит відправляє зашифроване тіло запиту - {{encryptJweT}}, згенероване на кроці 8. У відповіді отримуємо зашифровану відповідь - {{responseJwe}}, котра буде потрібна для виконання кроку 10.

10. Decrypt execute purchase response — {{url}}/cipher/decrypt_by_jwk?message={{responseJwe}} Запит декриптує відповідь від банку за допомогою приватного ключа - userPrivateKey, (котрий Мерчант генерує за інструкцією ). У відповідь отримуємо розшифровану тіло відповіді на запит у кроці 9. Для тестів дозволено використання допоміжного методу "/ecom/help/encrypt_by_jwk"

Процес генерації комунікаційних JWK ключів клієнта
PURCHASE
корок 1
Процес генерації комунікаційних JWK ключів клієнта
PURCHASE крок 2
Процес генерації комунікаційних JWK ключів клієнта