C2A Complete - завершення ініціювання списання

Метод для завершення ініціювання списання коштів с картки платника. Може бути викликаний після C2A Initiate - ініціювання списання, платіж повинен бути з типом C2A та статусом WAITING_COMPLETE, а операція з типом SEND та статусом NEEDS_COMPLETE. Після виклику починається процес списання зі сторони банку еквайра і платіж може вимагати підтвердження (3DS або LOOKUP) від платника (статус платежу OPEN та статус операції NEEDS_CONFIRMATION), стати успішним (статус платежу та операції FINISHED) або неуспішним (статус платежу та операції REJECTED).

Метод запиту - POST

Шлях запиту - /api/p2p/payments/c2a/complete

Параметри для формування тіла запиту у форматі JSON

Ключ	Тип даних	Обов'язковий?	Опис	Приклад

Ключ	Тип даних	Обов'язковий?	Опис	Приклад
params.sessionId	string	так	id сесії клієнта	"445fb296-8653-4646-8475-5796c97d16ff"
params.paymentId	string	так, один із цих параметрів: params.paymentId, params.operationId або params.externalId	id платежу	"a85ee391-46ca-4766-b376-292bd7efbeea"
params.operationId	string		id операції	"bc3c95f1-bf2a-4e61-8c88-8444b1b4e014"
params.externalId	string		зовнішній id операції	"ad6cee7f-88ff-4090-ae38-8e6a0f260cd8"
params.device	object	так	об'єкт з інформацією про браузер / пристрій платника	{"acceptHeader":"/","ip":"91.137.205.117","colorDepth":24,"javaEnabled":false,"language":"en-US","screenHeight":864,"screenWidth":1536,"windowHeight":734,"windowWidth":1479,"time":"2021-10-07T14:55:52.832Z","timezoneOffset":-180,"userAgent":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36"}
params.acsRedirectUrl	string	ні	URL на який буде здійснюватись перенаправлення платника після завершення сценарію ACS сторінки у разі підтвердження платежу платнком за допомогою 3DS, не більше 255 символів	"https://client-domain.ua/order-redirect/12345"
data.cardFrom.pan	string	так, або один параметр data.cardFrom.id або оба параметри data.cardFrom.pan і data.cardFrom.expiresAt	номер картки списання Клієнт може використовувати цей параметр тільки маючи сертифікат PCI DSS	"4111111111111111"
data.cardFrom.expiresAt	string		термін дії картки списання у форматі YYYY-MM Клієнт може використовувати цей параметр тільки маючи сертифікат PCI DSS	"2025-05"
data.cardFrom.id	string		id картки списання створеної в системі UAPAY	"06f9c6e4-90e4-4f1e-a12b-49f2f7e9c390"
data.cardFrom.securityCode	string	так	CVV2/CVC2 код картки списання	"111"

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

{
  "params": {
    "sessionId": "445fb296-8653-4646-8475-5796c97d16ff",
    "paymentId": "a85ee391-46ca-4766-b376-292bd7efbeea",
    "device": {
      "acceptHeader": "*/*",
      "ip": "91.137.205.117",
      "colorDepth": 24,
      "javaEnabled": false,
      "language": "en-US",
      "screenHeight": 864,
      "screenWidth": 1536,
      "windowHeight": 734,
      "windowWidth": 1479,
      "time": "2021-10-07T14:55:52.832Z",
      "timezoneOffset": -180,
      "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36"
    },
    "acsRedirectUrl": "https://client-domain.ua/order-redirect/12345"
  },
  "data": {
    "cardFrom": {
      "pan": "4111111111111111",
      "expiresAt": "2025-05",
      "securityCode": "111"
    }
  }
}

або

{
  "params": {
    "sessionId": "445fb296-8653-4646-8475-5796c97d16ff",
    "externalId": "ad6cee7f-88ff-4090-ae38-8e6a0f260cd8",
    "device": {
      "acceptHeader": "*/*",
      "ip": "91.137.205.117",
      "colorDepth": 24,
      "javaEnabled": false,
      "language": "en-US",
      "screenHeight": 864,
      "screenWidth": 1536,
      "windowHeight": 734,
      "windowWidth": 1479,
      "time": "2021-10-07T14:55:52.832Z",
      "timezoneOffset": -180,
      "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36"
    },
    "acsRedirectUrl": "https://client-domain.ua/order-redirect/12345"
  },
  "data": {
    "cardFrom": {
      "id": "06f9c6e4-90e4-4f1e-a12b-49f2f7e9c390",
      "securityCode": "111"
    }
  }
}

Параметри тіла відповіді у форматі JSON

Ключ	Тип даних	Опис	Приклад

Ключ	Тип даних	Опис	Приклад
data.paymentId	string	id платежу	"a85ee391-46ca-4766-b376-292bd7efbeea"
data.operationId	string	id операції	"bc3c95f1-bf2a-4e61-8c88-8444b1b4e014"
data.externalId	string	зовнішній id операції	"ad6cee7f-88ff-4090-ae38-8e6a0f260cd8"
data.key	string	ключ для розшифровки CVV2/CVC2	"3PufqdQdnySBxQyqC7FyjCGUH1yT1V4WkxY6FdrRY72u.l0qoodqe68941561263"
data.amount	number	сума платежу, в копійках	10000
data.commissionAmount	number	сума комісії по платежу з платника, в копійках	550

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

{
  "status": 1,
  "data": {
    "paymentId": "a85ee391-46ca-4766-b376-292bd7efbeea",
    "operationId": "bc3c95f1-bf2a-4e61-8c88-8444b1b4e014",
    "externalId": "ad6cee7f-88ff-4090-ae38-8e6a0f260cd8",
    "key": "3PufqdQdnySBxQyqC7FyjCGUH1yT1V4WkxY6FdrRY72u.l0qoodqe68941561263",
    "amount": 10000,
    "commissionAmount": 550
  }
}