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. Платіжні методи HPP

Callback

Для відправки Callback буде виконаний Post запит на notificationUrl який був вказаний в запиті на створення замовлення

Вхідні параметри

Параметр
Опис
Формат даних
Приклад

ecomOrderId

Id замовлення в системі єком

string

bd68c2e5-3642-4527-90c3-e3fd8a73e594

coinAmount

сума замовлення

long

2000

merchantId

Id мерчанта в системі єком

string

137d9304-0368-11ed-b939-0242ac120002

statusUrl

url для редіректу на сторінку статусу

string

hppOrderId

Id замовлення

string

17285584837476oqrSs7PszY

redirectUrl

посилання на перенаправлення клієнта на платіжку сторінку

string

notificationUrl

url, на який буде відправлено CallBack

string

hppPayType

тип оплати

string

PURCHASE

merchantRequestId

унікальний ідентифікатор мерчанта

string

137d9304-0318-11ed-b939-0241ac120104

orderStatus

статус замовлення

string

SUCCESS

createDate

дата та час створення замовлення

string

22024-10-10 14:08:03.67+03:00

paymentMethods

методи оплати

CARD

expiredOrderDate

дата та час дії замовлення

string

2024-10-10 14:23:03.67+03:00

operations

об'єкт з даними по операції

object

type

тип транзакції

string

Purchase, CARD_2_ACCOUNT, ACCOUNT_2_CARD,REFUND

rrn

rrn номер транзакції в МПС

string

2554256963

purpose

призначення платежу

string

За товар

comment

коментар

string

тест

coinAmount

сума платежу

long

2000

merchantId

Id мерчанту

string

137d9304-0368-11ed-b939-0242ac120002

operationId

Id транзакціі

string

1712844596346b9F-WwrWZpq

ecomOperationId

Id транзакціі в системі Ecom

string

8c3303e9-7396-43b8-af4e-31d9facdde9b

merchantName

найменування торговця

string

KB test terminal

approvalCode

код авторизаціі

string

39203

status

статус транзакціі

string

SUСCESS FAIL PENDING REQUIRED_3DS DESIRED_THREEDS_MODE_ERROR

transactionType

тип транзакції у цифровому значенні

string

35

merchantRequestId

Id запиту мерчанта

string

72837906-f526-4aef-8d11-58d80b44cb75

transactionCurrency

валюта платежу

string

980

merchantCommission

сума комісії

string

2

createDateTime

дата створення платежу

string

2024.09.19 15:29:25.675

modificationDateTime

дата модифікаціі платежу

string

2024.09.19 15:29:25.675

actionCode

код відповіді

string

0

responseCode

деталі відповіді

string

00

description

опис відповіді

string

approved

bankCode

назва банку емітента

string

BANK_ALLIANCE

paymentSystem

назва мпс емітента

string

MasterCard

productType

тип продукту термінала

string

PURCHASE

notificationUrl

url, на який відправлено CallBack

string

paymentServiceType

тип оплати

string

CARD/APPLE_PAY/GOOGLE_PAY

notificationEncryption

ознака криптування данних CallBack

string

true/false Якщо параметр не передано або передано false, то дані в CallBack будуть не закриптовані

cardNumberMask

маскований номер карти

string

5573********0304

desiredThreeDSMode

ознака яка вказує, чи бажає мерчант використати 3DS в покупці чи ні.

string

MUST/SHOULD/MUST_NOT

threeDSMode

параметр який вказує, використовувася 3DS у покупці чи ні

string

MUST- проводимо оплату з 3DS MUST_NOT- проводимо оплату без 3DS

statusThreeDs

статус проведення 3DS

string

Y - успіший 3ds N - не успішний 3ds

threeDSServerTransId

Id транзакціі в системі 3ds

string

b6c35fdb-28c1-454d-a2f3-51098c26bda4

acsTransId

Id транзакціі в системі ACS

string

3e17fabb-71e6-498e-8794-ef8c95c5ba6f

dsTransId

Id транзакціі згенерований Directory Server

string

12ebc556-82d3-4e35-9fb8-77ac18b050ea

eci

Electronic Commerce Indicator Код, який вказує рівень безпеки транзакції

string

02

processingMerchantId

Id мерчанту в ПЦ

string

AE100000

processingTerminalId

Id терміналу в ПЦ

string

AE100000

redirect3dsUrl

url для редиректа клієнта на сторінку емітента для проходження 3DS

string

txnType

під тип транзакціі

enum

Можливі значення: NONCVV/noncvv- при отриманні даного значення введення cvv та його перевірка не відбувається

senderCustomerId

Id клієнта відправника

string

1258728c1

senderFirstName

прізвище відправника

string

Іваненко

senderLastName

ім'я відправника

string

Іван

senderMiddleName

по-батькові відправника

string

Іванович

senderEmail

пошта відправника

string

mail@gmail.com

senderCountry

країна відправника

string

Україна

senderRegion

область відправника

string

Київська

senderCity

місто відправника

string

Київ

senderStreet

вулиця відправника

string

Січових стрільців

senderAdditionalAddress

додаткові дані адреси відправника (поверх, номер дому, квартира)

string

23

senderItn

іпн відправника

string

123456789

senderPassport

паспорт відправника

string

АН123456

senderIp

ip адреса відправника

string

123.12.12.12

senderPhone

номер телефону відправника

string

380630000000

senderBirthday

день народження відправника

string

31.12.2000

senderGender

гендер відправника

string

M

senderZipCode

індекс відправника

string

12000

senderBankCode

назва банку емітента відправника

string

BANK_ALLIANCE

senderPaymentSystem

назва мпс емітента відправника

string

MasterCard

senderCardNumberMask

маскований номер карти відправника

string

5573********0304

recipientCustomerId

Id клієнта відправника

string

1258728c1

recipientFirstName

прізвище отримувача

string

Іваненко

recipientLastName

ім'я отримувача

string

Іван

recipientMiddleName

по-батькові отримувача

string

Іванович

recipientEmail

пошта отримувача

string

mail@gmail.com

recipientCountry

країна отримувача

string

Україна

recipientRegion

область отримувача

string

Київська

recipientCity

місто отримувача

string

Київ

recipientStreet

вулиця отримувача

string

Січових стрільців

recipientAdditionalAddress

додаткові дані адреси отримувача (поверх, номер дому, квартира)

string

23

recipientItn

іпн отримувача

string

123456789

recipientPassport

паспорт отримувача

string

АН123456

recipientIp

ip адреса отримувача

string

123.12.12.12

recipientPhone

номер телефону отримувача

string

380630000000

recipientBirthday

день народження отримувача

string

31.12.2000

recipientGender

гендер отримувача

string

M

recipientZipCode

індекс отримувача

string

12000

recipientBankCode

назва банку емітента отримувача

string

BANK_ALLIANCE

recipientPaymentSystem

назва мпс емітента отримувача

string

MasterCard

recipientCardNumberMask

маскований номер карти отримувача

string

5573********0304

originalOperationId

id під яким створено оригінальну операцію

string

1712843529623cHAHkmt-G5u

originalCoinAmount

Сума оригінального платежу

int

100

originalEcomOperationId

id в системі Еком під яким створено оригінальну операцію

string

c25ee1cb-a052-439b-b075-bcb632615b11

rrnOriginal

rrn номер оригінальної транзакції в МПС

string

123456789

Вхідні параметри:

{
    "ecomOrderId": "6a413da5-8d9a-423a-8467-f335eb6bd602",
    "coinAmount": 1000,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "statusUrl": "http://pgi-status-ecom-release.develop.bankalliance.ua/?hpp_id=17285584837476oqrSs7PszY",
    "hppOrderId": "17285584837476oqrSs7PszY",
    "redirectUrl": "http://pgi-ecom-release.develop.bankalliance.ua/?hpp_id=17285584837476oqrSs7PszY",
    "notificationUrl": "https://example.com/notify",
    "hppPayType": "PURCHASE",
    "merchantRequestId": "137d9304-0318-11ed-b939-0241ac120104",
    "orderStatus": "SUCCESS",
    "createDate": "2024.10.10 14:08:39.453",
    "paymentMethods": [
        "CARD"
    ],
    "expiredOrderDate": "2024.10.10 14:08:39.453",
    "operations": {
            "type": "PURCHASE",
            "rrn": "428411449064",
            "comment": "Payment for Order №123456",
            "coinAmount": 1000,
            "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
            "operationId": "1728558518169TnfMpJ0tO-P",
            "merchantName": "KB test terminal",
            "approvalCode": "091657",
            "status": "SUCCESS",
            "transactionType": 35,
            "transactionCurrency": "980",
            "merchantCommission": 0,
            "transactionCreateDateTime": "2024.10.10 14:08",
            "transactionModificationDateTime": "2024.10.10 14:08",
            "creationDateTime": "2024.10.10 14:08:39.453",
            "modificationDateTime": "2024.10.10 14:08:47.284",
            "processingDateTime": "2024.10.10 14:08:46.000",
            "transactionResponseInfo": {
                "actionCode": "0",
                "responseCode": "00",
                "description": "approved"
            },
            "paymentServiceType": "CARD",
            "notificationEncryption": false,
            "desiredThreeDSMode": "SHOULD",
            "threeDSMode": "MUST",
            "threeDSServerTransId": "3ea53f87-2da5-4b3a-9178-bc8fd1926208"
    }
}

PreviousREFUNDNextСтатуси замовлення

Last updated 6 months ago

http://pgi-status-ecom-release.develop.bankalliance.ua/?hpp_id=17285584837476oqrSs7PszY
http://pgi-ecom-release.develop.bankalliance.ua/?hpp_id=17285584837476oqrSs7PszY
https://example.com/notify
https://merchant.notification_url/
https://api-ecom-release.develop.bankalliance.ua/threeDS/getRedirectHtml/1702047427621BHu5X99yDbA