UAPAY - національний платіжний сервіс

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

Метод для завершення ініціювання списання коштів с картки платника. Може бути викликаний після https://uapayua.atlassian.net/wiki/spaces/AC/pages/2600370177, платіж повинен бути з типом 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 } }

 

UAPAY - національний платіжний сервіс
pay@uapay.ua