Запит проведення PURCHASE Крок 1

{{url}}/ecom/execute_request/payments/v3/create/purchase

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

Параметр	Опиc	Формат даних	Обов'язковість	Приклад
merchantRequestId	унікальний ідентифікатор згенерований системою мерчанта, використовується для можливості дізнатися статусоперації якщо запит закінчився невідомою помилкою чи дісконектом	string(36)	Так	137d9304-0368-11ed-b939-0242ac120002
merchantId	Id мерчанту згенерований в Єкомі	string(36)	Так	137d9304-0368-11ed-b939-0242ac120002
encryptedCardNumber	номер карти зашифрований в JWE за допомогою публічного платіжного ключа	string	Так	5573670000000304 (розшифрований вигляд)
coinAmount	сума платежу	string	Так	2000
txnType	під тип транзакціі Параметр вказан - введення cvv та його перевірка не відбувається Параметр НЕ вказан - введення cvv та його перевірка відбувається	enum	Ні	Можливі значення: NONCVV/noncvv
typeToken	визначає тип токена при його створенні	string	Ні	можливі значення: TOKEN_PER_CUSTOMER - токен створюється для конкретного клієнта (customer)
desiredThreeDSMode	ознака яка вказує, чи бажає мерчант використати 3DS в покупці чи ні.	string (50)	Так	За замовчуванням SHOULD Можливі значення: MUST - мерчант вимагає проведення платежу з 3DS MUST_NOT - примусова операція без 3DS SHOULD - якщо картка підтримує 3DS, то робимо перевірку
notificationUrl	url, на який буде відправлено CallBack	string (1000)	Ні	https://merchant.notification_url
notificationEncryption	ознака криптування данних CallBack	string	Ні	true/false Якщо параметр не передано або передано false, то дані в CallBack будуть не закриптовані
date	дата та час платежу	string	Так	{{currentdateT}}.00+00:00
comment	додаткова опис операції яку заповнює клієнт мерчанта	string (1000)	Ні	///5555.25412
purpose	призначення платежу яке заповнює мерчант	string (255)	Ні	За товар
merchantComment	додаткова інформація\коментар мерчанта по замовленню	string(255) a-zA-Z0-9 ,.;:@#$%'-=+1,256$	Ні	merchant Comment id 1258728c1
resultRedirectUrl	Url для редиректа клієнта після проходження 3DS аутентифікації	string (1000)	Ні	Google Help
customerData	об'єкт з customer даними	object	Так
senderCustomerId	Id клієнта відправника	string (255)	Так	1258728c1
senderFirstName	ім'я відправника	string (30) значення не може містити виключно цифри не може містити крапки та інші спецсимволи не може містити “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN” дозволено приймати тільки літерно-цифрові значення може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“ дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027	Ні	Іваненко
senderLastName	прізвище відправника	string (30) значення не може містити виключно цифри не може містити крапки та інші спецсимволи дозволено приймати тільки літерно-цифрові значення може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“ дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027	Ні	Іван
senderMiddleName	по-батькові відправника	string (30) значення не може містити виключно цифри не може містити крапки та інші спецсимволи дозволено приймати тільки літерно-цифрові значення може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“ дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027	Ні	Іванович
senderEmail	пошта відправника	string (256)	Ні	[e-mail]
senderСountry	країна відправника	string (3) ISO 3166, 804 (Ukraine)	Ні	804
senderRegion	область відправника	string (255)	Ні	Київська
senderСity	місто відправника	string (25)	Ні	Київ
senderStreet	вулиця відправника	string (35)	Ні	Січових стрільців
senderAdditionalAddress	додаткові дані адреси відправника (поверх, номер дому, квартира)	string (255)	Ні	23
senderItn	іпн відправника	string (20)	Ні	123456789
senderPassport	паспорт відправника	string (255)	Ні	АН123456
senderIp	IP адреса відправника	string (50)	Ні	123.12.12.12
senderPhone	номер телефону відправника	string (20)	Ні	380630000000
senderBirthday	день народження відправника	string (50)	Ні	31.12.2000
senderGender	Гендер відправника	string (50)	Ні	Male/Female
senderZipCode	Індекс відправника	string (50)	Ні	49000

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

Параметр	Опис	Формат даних	Приклад
type	тип транзакції	string	Purchase
rrn	rrn номер транзакції в МПС	string	2554256963
purpose	призначення платежу	string	За товар
comment	коментар	string	тест
coinAmount	сума платежу	int	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	0
description	опис відповіді	string	approved
bankCode	назва банку емітента	string	BANK_ALLIANCE
paymentSystem	назва мпс емітента	string	MasterCard
productType	тип продукту термінала	string	PURCHASE
notificationUrl	url, на який відправлено CallBack	string	https://merchant.notification_url/
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	8a811df4-91e0-436b-a9ac-9b0772c96f28
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	https://api-ecom-release.develop.bankalliance.ua/threeDS/getRedirectHtml/1702047427621BHu5X99yDbA
txnType	під тип транзакціі	enum	Можливі значення: NONCVV/noncvv- при отриманні даного значення введення cvv та його перевірка не відбувається
senderCustomerId	Id клієнта відправника	string	1258728c1
senderFirstName	ім'я відправника	string	Іваненко
senderLastName	прізвище відправника	string	Іван
senderMiddleName	по-батькові відправника	string	Іванович
senderEmail	пошта відправника	string	[e-mail]
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

Приклад тіла запиту

{
    "merchantId": "467c8a10-c705-11ed-afa1-0242ac120002",
    "merchantRequestId": "{{requestUUIDT}}",
    "encryptedCardNumber": "{{encryptedPanT}}",
    "coinAmount": "100",
    "comment": "comment",
    "notificationUrl": "",
    "purpose": "purpose",
    "resultRedirectUrl": "https://support.google.com/websearch/answer/463?hl=ru",
    "desiredThreeDSMode": "MUST",
    "customerData": {
        "senderFirstName": "John",
        "senderLastName": "Doe",
        "senderMiddleName": "Fall",
        "senderEmail": "[e-mail]",
        "senderCountry": "sender_country",
        "senderRegion": "sender_region",
        "senderCity": "sender_city",
        "senderStreet": "sender_street",
        "senderAdditionalAddress": "N 6",
        "senderItn": "12345",
        "senderPassport": "12345",
        "senderIp": "165.222.87.224",
        "senderPhone": "380967542344",
        "senderBirthday": "12/12/2000",
        "senderGender": "Male",
        "senderZipCode": "12345"
    }
    "date": "{{currentdateT}}.00+00:00"
}

Приклад тіла відповіді без 3DS

{
    "type": "PURCHASE",
    "rrn": null,
    "purpose": "LLopo",
    "comment": "RRRR",
    "coinAmount": 100,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "1712822786872mHQm6XSmmKt",
    "ecomOperationId": "2bbd1b87-9a07-41cc-9789-48d8895b3cf1",
    "merchantName": null,
    "approvalCode": null,
    "status": "PENDING",
    "transactionType": 35,
    "merchantRequestId": "e2980c5e-cddc-4ccf-be36-47ef8c73da84",
    "transactionCurrency": "980",
    "merchantCommission": null,
    "createDateTime": "2024.09.19 15:29:25.675",
    "modificationDateTime": "2024.09.19 15:29:25.675",
    "transactionResponseInfo": {
        "actionCode": null,
        "responseCode": null,
        "description": null
    },
    "bankCode": null,
    "paymentSystem": null,
    "productType": "PURCHASE",
    "notificationUrl": "https://webhook.site/6e35c4af-9af9-4212-9aa4-6a79ed6d7a0d",
    "paymentServiceType": "CARD",
    "notificationEncryption": true,
    "cardNumberMask": null,
    "desiredThreeDSMode": "MUST_NOT",
    "threeDSMode": "MUST_NOT",
    "statusThreeDs": null,
    "threeDSServerTransId": null,
    "redirect3dsUrl": null,
    "txnType": "null",
    "senderCustomerId": null,
    "senderFirstName": null,
    "senderLastName": null,
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": null,
    "senderRegion": null,
    "senderCity": null,
    "senderStreet": null,
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "senderBankCode": null,
    "senderPaymentSystem": null,
    "senderCardNumberMask": null
}

Приклад тіла відповіді з 3DS

{
    "type": "PURCHASE",
    "rrn": null,
    "purpose": "LLopo",
    "comment": "RRRR",
    "coinAmount": 100,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "1712822536063CdDIRi8hhjq",
    "ecomOperationId": "82da90c3-50b8-4d5b-b357-2cbe55167200",
    "merchantName": null,
    "approvalCode": null,
    "status": "REQUIRED_3DS",
    "transactionType": 35,
    "merchantRequestId": "8aa31389-fe6f-4b40-bb5e-4ecedfefb847",
    "transactionCurrency": "980",
    "merchantCommission": null,
    "createDateTime": "2024.09.19 15:29:25.675",
    "modificationDateTime": "2024.09.19 15:29:25.675",
    "transactionResponseInfo": {
        "actionCode": null,
        "responseCode": null,
        "description": null
    },
    "bankCode": null,
    "paymentSystem": null,
    "productType": "PURCHASE",
    "notificationUrl": "https://webhook.site/6e35c4af-9af9-4212-9aa4-6a79ed6d7a0d",
    "paymentServiceType": "CARD",
    "notificationEncryption": true,
    "cardNumberMask": null,
    "desiredThreeDSMode": "MUST",
    "threeDSMode": "MUST",
    "statusThreeDs": null,
    "threeDSServerTransId": "0ce5cc44-2698-4a2c-969a-3155bad68b6e",
    "redirect3dsUrl": null,
    "txnType": "null",
    "senderCustomerId": null,
    "senderFirstName": null,
    "senderLastName": null,
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": null,
    "senderRegion": null,
    "senderCity": null,
    "senderStreet": null,
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "senderBankCode": null,
    "senderPaymentSystem": null,
    "senderCardNumberMask": null
}