> For the complete documentation index, see [llms.txt](https://docs.merchant.alb.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.merchant.alb.ua/platizhni-metodi-h2h/preauthorization-and-completion/zapit-provedennya-completion.md). # Запит проведення Completion {{url}}/ecom/execute\_request/payments/v1/completion #### **Вхідні параметри** | Параметр | Опис | Формат даних | Обов'язковість | Приклад | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------ | | merchantRequestId | унікальний ідентифікатор згенерований системою мерчанта, використовується для можливості дізнатися статусоперації якщо запит закінчився невідомою помилкою чи дісконектом | string (36) | Так | 137d9304-0368-11ed-b939-0242ac120002 | | merchantId | Id мерчанту згенерований в Єкомі | string(36) | Так | 137d9304-0368-11ed-b939-0242ac120002 | | originalOperationId | ідентифікатор операції преавторизаціі. | string | Так | 17853174998663DNdLakuczP | | coinAmount | сума повернення в копійках | string | Так | 2500 | | date | дата та час платежу | string | Так | {{currentdateT}}.00+00:00 | | notificationUrl | url, на який буде відправлено CallBack | string (255) | Ні | | | notificationEncryption | ознака криптування данних CallBack | string | Ні |

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

| | merchantComment | додаткова інформація\коментар мерчанта по замовленню | string(255)a-zA-Z0-9 ,.;:@#$%'-=+1,256$ | Ні | merchant Comment id 1258728c1 | | comment | додаткова опис операції яку заповнює клієнт мерчанта | string (1000) | Ні | ///5555.25412 | | purpose | призначення платежу яке заповнює мерчант | string (255) | Ні | За товар | | customerData | Об'єкт даних платника | object | Ні (весь об'єкт необов'язковий) | — | | customerData.senderCustomerId | ID клієнта відправника | string (255) | Ні | 1258728c1 | | customerData.senderFirstName | Ім'я відправника | string (30) | Ні | Іваненко | | customerData.senderLastName | Прізвище відправника | string (30) | Ні | Іван | | customerData.senderMiddleName | По-батькові відправника | string (30) | Ні | Іванович | | customerData.senderEmail | Пошта відправника | string (256) | Ні | | | customerData.senderCountry | Країна відправника (ISO 3166) | string (3) | Ні | 804 | | customerData.senderRegion | Область відправника | string (255) | Ні | Київська | | customerData.senderCity | Місто відправника | string (25) | Ні | Київ | | customerData.senderStreet | Вулиця відправника | string (35) | Ні | Січових стрільців | | customerData.senderAdditionalAddress | Додаткові дані адреси | string (255) | Ні | 23 | | customerData.senderItn | ІПН відправника | string (20) | Ні | 123456789 | | customerData.senderPassport | Паспорт відправника | string (255) | Ні | АН123456 | | customerData.senderIp | IP-адреса відправника | string (50) | Ні | 123.12.12.12 | | customerData.senderPhone | Телефон відправника | string (50) | Ні | 380630000000 | | customerData.senderBirthday | День народження відправника | string (50) | Ні | 31.12.2000 | | customerData.senderGender | Стать відправника | string (50) | Ні | Male/Female | | customerData.senderZipCode | Поштовий індекс | string (50) | Ні | 49000 | #### **Вихідні параметри** | type | тип транзакції | string | complition | | ------------------------------------ | -------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------- | | 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 | 76 | | merchantRequestId | Id запиту мерчанта | string | 72837906-f526-4aef-8d11-58d80b44cb75 | | transactionCurrency | валюта платежу | string | 980 | | merchantCommission | сума комісії | string | 2 | | createDateTime | дата створення платежу | string | 2024.04.11 17:09 | | modificationDateTime | дата модифікаціі платежу | string | 2024.04.11 17:09 | | processingMerchantId | Id мерчанту в ПЦ | string | AE100000 | | processingTerminalId | Id терміналу в ПЦ | string | AE100000 | | transactionResponseInfo | | object | | | transactionResponseInfo.actionCode | код відповіді | string | 0 | | transactionResponseInfo.responseCode | деталі відповіді | string | 0 | | transactionResponseInfo.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 будуть не закриптовані | | originalOperationId | id під яким створено оригінальну операцію | string | 1712843529623cHAHkmt-G5u | | originalCoinAmount | Сума оригінального платежу | int | 100 | | originalEcomOperationId | id в системі Еком під яким створено оригінальну операцію | string | c25ee1cb-a052-439b-b075-bcb632615b11 | | rrnOriginal | rrn номер оригінальної транзакції в МПС | string | 123456789 | | senderCustomerId | ID клієнта відправника | string | 1258728c1 | | senderFirstName | Ім'я відправника | string | Іваненко | | senderLastName | Прізвище відправника | string | Іван | | senderMiddleName | По-батькові відправника | string | Іванович | | senderEmail | Пошта відправника | string | | | senderCountry | Країна відправника | string | 804 | | 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 | Male/Female | | senderZipCode | Поштовий індекс відправника | string | 49000 | #### Приклад тіла запиту ```json { "merchantRequestId":"137d9304-0368-11ed-b939-0242ac120002", "originalOperationId":"17594943825392XRyx8EeK6e", "merchantId":"137d9304-0368-11ed-b939-0242ac120002", "coinAmount":"2500", "notificationUrl": "", "date": "2022-11-11 11:58:41.56+00:00" } ``` #### Приклад тіла відповіді ```json { "type":"COMPLETION", "rrn":"527612892256", "purpose":"AAAAfasfsfsfAAAAfasAA", "comment":"AAAAfasfsfsfAAAAf", "coinAmount":100, "merchantId":"137d9304-0368-11ed-b939-0242ac120002", "operationId":"17594944974293A5xR2LzpAQ", "ecomOperationId":"9ee1923c-11ce-4ac2-9917-899d499ff3d8", "status":"SUCCESS", "transactionType":196, "merchantRequestId":"e582be0c-aa5c-4991-95a3-ff3d5f53a1c6", "transactionCurrency":"980", "creationDateTime":"2025.10.03 15:28:17.399", "modificationDateTime":"2025.10.03 15:28:17.399", "transactionResponseInfo":{ "actionCode":"0", "responseCode":"00", "description":"Операція успішна" }, "productType":"PURCHASE", "notificationUrl":"https://webhook.site/95b1ded7-b86f-46cb-a771-c70f1f913d57", "paymentServiceType":"CARD", "notificationEncryption":false, "processingTerminalId":"AE001001", "processingMerchantId":"AE001001", "creatorSystem":"H2H", "rrnPreauth":"527612892256", "preauthOperationId":"17594943825392XRyx8EeK6e", "preauthCoinAmount":100, "preauthEcomOperationId":"f1a166ce-a19e-46e2-bd7c-2dc90acd1041" } ```