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

{{url}}/ecom/execute_request/payments/v3/apple_pay/card_to_account

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

Параметр	Опис	Формат даних	Обов'язковість	Приклад
Об’єкт paymentData, який необхідно закриптувати платіжним ключем
applicationPrimaryAccountNumber	номер рахунку картки, з якої фінансується ця транзакція	string	Так	4420642424203999
applicationExpirationDate	Термін дії картки у форматі YYMMDD	string	Так	261001
currencyCode	Цифровий код валюти ISO 4217	string	Так	980
transactionAmount	Сума платежу	string	Так	2000
cardholderName	Ім'я власника картки	string	Ні	Іванченко Петро
deviceManufacturerIdentifier	Hex-encoded device manufacturer identifier	string	Так	1
paymentDataType		string	Так	3DSecure
paymentData
onlinePaymentCryptogram	Криптограма платежу у форматі Base64	string	Так	AVn0rK8BiDxN2D/w2j8LMAABAAA=
eciIndicator	ECI indicator	string(1)	Ні	7
Додаткові дані для проведення платежу
merchantRequestId	унікальний ідентифікатор згенерований системою мерчанта, використовується для можливості дізнатися статус операції якщо запит закінчився невідомою помилкою чи дісконектом	string(36)	Так	137d9304-0368-11ed-b939-0242ac120002
merchantId	Id мерчанту згенерований в Єкомі	string(36)	Так	137d9304-0368-11ed-b939-0242ac120002
desiredThreeDSMode	Ознака яка вказує, чи бажає мерчант використати 3DS в покупці чи ні.	string (50)	Так	За замовчуванням SHOULD Можливі значення: MUST - мерчант вимагає проведення платежу з 3DS MUST_NOT - примусова операція без 3DS SHOULD - якщо картка підтримує 3DS, то робимо перевірку
resultRedirectUrl	Url для редиректа клієнта після проходження 3DS аутентифікації	string (1000)	Ні	Google Help
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
recipientAccount	Рахунок отримувача	string	Ні	2900000000000
customerData	об'єкт з customer даними	object	Так
senderCustomerId	Id клієнта відправника	string (255)	Так	1258728c1
senderFirstName	ім'я відправника	string (30) значення не може містити виключно цифри не може містити крапки та інші спецсимволи дозволено приймати тільки літерно-цифрові значення може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“ дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці Для символу апострофу використовуйте єдиний доступний символ 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
recipientCustomerId	Id клієнта отримувача	string (255)	Ні	1258728c1
recipientFirstName	ім'я отримувача	string (30) значення не може містити виключно цифри не може містити крапки та інші спецсимволи дозволено приймати тільки літерно-цифрові значення може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“ дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027	Ні	Іваненко
recipientLastName	прізвище отримувача	string (30) значення не може містити виключно цифри не може містити крапки та інші спецсимволи дозволено приймати тільки літерно-цифрові значення може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“ дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027	Ні	Іван
recipientMiddleName	по-батькові отримувача	string (30) значення не може містити виключно цифри не може містити крапки та інші спецсимволи дозволено приймати тільки літерно-цифрові значення може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“ дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027	Ні	Іванович
recipientEmail	пошта отримувача	string (256)	Ні	[e-mail]
recipientСountry	країна отримувача	string (3) ISO 3166, 804 (Ukraine)	Ні	804
recipientRegion	область отримувача	string (255)	Ні	Київська
recipientСity	місто отримувача	string (25)	Ні	Київ
recipientStreet	вулиця отримувача	string (35)	Ні	Січових стрільців
recipientAdditionalAddress	додаткові дані адреси отримувача (поверх, номер дому, квартира)	string (255)	Ні	23
recipientItn	іпн отримувача	string (20)	Ні	123456789
recipientPassport	паспорт отримувача	string (255)	Ні	АН123456
recipientIp	IP адреса клієнта отримувача	string (50)	Ні	123.12.12.12
recipientPhone	номер телефону отримувача	string (50)	Ні	380630000000
recipientBirthday	день народження отримувача	string (50)	Ні	31.12.2000
recipientGender	Гендер отримувача	string (50)	Ні	Male/Female
recipientZipCode	індекс отримувача	string (50)	Ні	49000

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

Параметр	Опис	Формат даних	Приклад
type	тип транзакції	string	CARD_2_ACCOUNT
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	62
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	C2A
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	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
processingMerchantId	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
recipientCustomerId	Id клієнта відправника	string	1258728c1
recipientFirstName	ім'я отримувача	string	Іваненко
recipientLastName	прізвище отримувача	string	Іван
recipientMiddleName	по-батькові отримувача	string	Іванович
recipientEmail	пошта отримувача	string	[e-mail]
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

Приклад об’єкту paymentData

{
"applicationPrimaryAccountNumber":"{{applePayCardNumber}}",
"applicationExpirationDate":"{{applePayDate}}",
"currencyCode":"980",
"transactionAmount":"100",
"cardholderName":"{{cardholderName}}",
"deviceManufacturerIdentifier":"1255548888hfhhbbk",
"paymentDataType":"3DSecure",
"paymentData":{
"onlinePaymentCryptogram":"AVn0rK8BiDxN2D/w2j8LMAABAAA=",
"eciIndicator":"7"}
}

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

{
    "paymentData": "{{encryptedPaymentData}}", 
    "merchantRequestId": "{{requestUUIDT}}",
    "desiredThreeDSMode": "MUST_NOT",
    "notificationUrl": "https://api-ecom-prod.bankalliance.ua/mock",
    "resultRedirectUrl": "",
    "purpose": "purpose",
    "comment": "comment",
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "customerData": {
        "senderCustomerId": "1234567",
        "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",
        "recipientCustomerId": "1234567",
        "recipientFirstName": "Yura",
        "recipientLastName": "Bura",
        "recipientMiddleName": "TestMiddle",
        "recipientEmail": "res@gmail",
        "recipientCountry": "804",
        "recipientRegion": "res_reg",
        "recipientCity": "res_dnipro",
        "recipientStreet": "res_street",
        "recipientAdditionalAddress": "res_addres",
        "recipientItn": "res_iin",
        "recipientPassport": "res_pasport",
        "recipientIp": "165.222.87.224",
        "recipientPhone": "380967542344",
        "recipientBirthday": "12/12/2000",
        "recipientGender": "Female",
        "recipientZipCode": "77777"
    },
    "date": "{{currentdateT}}.00+00:00"
}

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

{
    "type": "CARD_2_ACCOUNT",
    "rrn": "410209187456",
    "purpose": "purpose",
    "comment": "comment",
    "coinAmount": null,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "1712826505345NY4bmiIDrE5",
    "ecomOperationId": "21931655-17db-44e3-bd2f-212cbf5069c9",
    "merchantName": null,
    "approvalCode": null,
    "status": "SUCCESS",
    "transactionType": 62,
    "merchantRequestId": "586fc1f5-f647-4800-94e1-a9e65a68d424",
    "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": "Операція успішна"
    },
    "bankCode": null,
    "paymentSystem": null,
    "productType": "C2A",
    "notificationUrl": "https://api-ecom-prod.bankalliance.ua/mock",
    "paymentServiceType": "APPLE_PAY",
    "notificationEncryption": false,
    "senderCardNumberMask": null,
    "desiredThreeDSMode": "MUST_NOT",
    "threeDSMode": "MUST_NOT",
    "statusThreeDs": null,
    "threeDSServerTransId": null,
    "redirect3dsUrl": null,
    "recipientAccount": null,
    "senderCustomerId": null,
    "senderFirstName": "FirstName",
    "senderLastName": "Name",
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": "Ukraine",
    "senderRegion": null,
    "senderCity": "City",
    "senderStreet": "Str.",
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "senderBankCode": null,
    "senderPaymentSystem": null,
    "recipientCustomerId": null,
    "recipientFirstName": null,
    "recipientLastName": null,
    "recipientMiddleName": null,
    "recipientEmail": null,
    "recipientCountry": null,
    "recipientRegion": null,
    "recipientCity": null,
    "recipientStreet": null,
    "recipientAdditionalAddress": null,
    "recipientItn": null,
    "recipientPassport": null,
    "recipientIp": null,
    "recipientPhone": null,
    "recipientBirthday": null,
    "recipientGender": null,
    "recipientZipCode": null
}

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

{
    "type": "CARD_2_ACCOUNT",
    "rrn": null,
    "purpose": "purpose",
    "comment": "comment",
    "coinAmount": null,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "1712826655741bHtPOJY9BvI",
    "ecomOperationId": "92f0ccdd-48fb-43d8-9ee4-f4bd2e295f86",
    "merchantName": null,
    "approvalCode": null,
    "status": "REQUIRED_3DS",
    "transactionType": 62,
    "merchantRequestId": "45f336e8-f58d-43d5-9cdd-c3a06ba794c5",
    "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": "C2A",
    "notificationUrl": "https://api-ecom-prod.bankalliance.ua/mock",
    "paymentServiceType": "APPLE_PAY",
    "notificationEncryption": false,
    "senderCardNumberMask": null,
    "desiredThreeDSMode": "MUST",
    "threeDSMode": "MUST",
    "statusThreeDs": null,
    "threeDSServerTransId": "a011f12f-ddfa-4629-b786-4aa427f7210f",
    "redirect3dsUrl": null,
    "recipientAccount": null,
    "senderCustomerId": null,
    "senderFirstName": "FirstName",
    "senderLastName": "Name",
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": "Ukraine",
    "senderRegion": null,
    "senderCity": "City",
    "senderStreet": "Str.",
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "senderBankCode": null,
    "senderPaymentSystem": null,
    "recipientCustomerId": null,
    "recipientFirstName": null,
    "recipientLastName": null,
    "recipientMiddleName": null,
    "recipientEmail": null,
    "recipientCountry": null,
    "recipientRegion": null,
    "recipientCity": null,
    "recipientStreet": null,
    "recipientAdditionalAddress": null,
    "recipientItn": null,
    "recipientPassport": null,
    "recipientIp": null,
    "recipientPhone": null,
    "recipientBirthday": null,
    "recipientGender": null,
    "recipientZipCode": null
}