A2C

{{url}}/ecom/execute_request/payments/v4/account_to_card

Максимальна сума запиту операції А2С становить 29999.00 грн.

Перевищення граничної суми супроводжуєтсья помилкою:

ERROR: @Payment coin amount exceeds the limit

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

Параметр	Опис	Формат даних	Обов'язковість	Приклад
merchantRequestId	унікальний ідентифікатор згенерований системою мерчанта, використовується для можливості дізнатися статусоперації якщо запит закінчився невідомою помилкою чи дісконектом	string(36)	Так	137d9304-0368-11ed-b939-0242ac120002
encryptedCardNumber	номер картки отримувача зашифрованый в JWE за допомогою платіжного ключа	string	Так	5473670000000304 (розшифрованний вид)
coinAmount	Сума платежу	int	Так	2000
merchantId	Id мерчанту згенерований в Єкомі	string(36)	Так	137d9304-0368-11ed-b939-0242ac120002
date	дата та час платежу	string	Так	{{currentdateT}}.00+00:00
notificationUrl	url, на який буде відправлено CallBack	string	Ні	https://merchant.notification_url
notificationEncryption	ознака криптування данних CallBack	string	Ні	true/false Якщо параметр не передано або передано false, то дані в CallBack будуть не закриптовані
comment	Додаткова інформація про платіж	string	Ні	///5555.25412
purpose	Призначення платежу	string	Ні	За товар
merchantComment	додаткова інформація\коментар мерчанта по замовленню	string(255) a-zA-Z0-9 ,.;:@#$%'-=+1,256$	Ні	merchant Comment id 1258728c1
senderAccount	Рахунок відправника	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 (20)	Ні	380630000000
recipientBirthday	день народження отримувача	string (50)	Ні	31.12.2000
recipientGender	Гендер отримувача	string (50)	Ні	Male/Female
recipientZipCode	індекс отримувача	string (50)	Ні	49000

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

Параметр	Опис	Формат даних	Приклад
type	тип транзакції	string	ACCOUNT_2_CARD
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	46
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	A2C
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
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
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

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

{
"encryptedCardNumber":"{{encryptedPanT}}",
"merchantId":"137d9304-0368-11ed-b939-0242ac120002",
"merchantRequestId":"{{requestUUIDT}}",
"purpose":"за товар",
"coinAmount": 120,
"notificationUrl":"https://api-ecom-prod.bankalliance.ua/mock",
"ecomComment": "string",
"senderAccount": "UA12305299260022119999",
"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"
}

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

{
    "type": "ACCOUNT_2_CARD",
    "rrn": "410208187340",
    "purpose": "за товар",
    "comment": null,
    "coinAmount": 120,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "1712822901491QtPAxAWOrrg",
    "ecomOperationId": "ff1ae4eb-d66d-467e-896d-01ed579bd040",
    "merchantName": null,
    "approvalCode": null,
    "status": "PENDING",
    "transactionType": 46,
    "merchantRequestId": "cf17607f-c1f8-4e8e-abb2-5fd1b3dd17ec",
    "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": "A2C",
    "notificationUrl": "https://api-ecom-prod.bankalliance.ua/mock",
    "paymentServiceType": "CARD",
    "notificationEncryption": false,
    "senderAccount": "UA12305299260022119999",
    "recipientCardNumberMask": null,
    "senderCustomerId": null,
    "senderFirstName": "Petro",
    "senderLastName": "Petrenko",
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": "803",
    "senderRegion": null,
    "senderCity": "Kyiv",
    "senderStreet": "L.Ukrainki01",
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "recipientCustomerId": null,
    "recipientFirstName": "TestFirstname",
    "recipientLastName": "TestLastName",
    "recipientMiddleName": null,
    "recipientEmail": null,
    "recipientCountry": "803",
    "recipientRegion": null,
    "recipientCity": "Kyiv",
    "recipientStreet": "T. Shevchenka, 11",
    "recipientAdditionalAddress": null,
    "recipientItn": null,
    "recipientPassport": null,
    "recipientIp": null,
    "recipientPhone": null,
    "recipientBirthday": null,
    "recipientGender": null,
    "recipientZipCode": null,
    "recipientBankCode": null,
    "recipientPaymentSystem": null
}