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

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Current »

Метод для завершення ініціювання списання коштів с картки платника. Може бути викликаний після 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
  }
}

  • No labels