/ConfirmExt - Ukrcard

/ConfirmExt використовується для отримання розширеного статусу зареєстрованого замовлення.

Життєвий цикл всіх запитів за замовчуванням у наших системах 20 хвилин.
Тобто якщо через 20 хвилин після оригінального запиту на запит розширеного статусу ви отримуєте будь-яку відповідь, то штатно вона вже не зміниться.
Тому нема ніякого сенсу виконувати протягом декількох днів перезапити статуса.
Рекомендуємо робити перепитування з часом, що збільшується, між перезапитами (5с, 10с, 15с, 30с, 1хв, 1 хв, 2 хв, 3 хв, 5 хв, 10 хв) до закінчення часу життя запиту тобто до 20 хвилин, або раніше, якщо отримано фінальний статус.
Тобто зазвичай перепитування статусів роблять кількістю від 1 до 10.

Request

Header Params

ExtSystemid

string

required

Ідентифікатор зовнішньої системи (ЗС), яка сформувала запит. Ідентифікатор погоджується з УКРКАРТ під час реєстрації ЗС

Example:

ECOM_GOLD_BANK

string

required

Логін ЗС у системі, отриманий від УКРКАРТ при підключенні

Example:

SECURE_LOGIN

password

string

required

Пароль ЗС у системі, отриманий від УКРКАРТ при підключенні

Example:

SECURE_PASSWORD

orderNumber

string

required

Номер (ідентифікатор) операції у зовнішній системі. Значення має бути унікальним для кожної системи в її межах.

Example:

1234

orderId

string

optional

Унікальний ідентифікатор операції в системі. Призначається системою при обробці платіжного запиту.

Example:

dbafea6c-3394-4f6a-a0d2-21d3d8e93e42

RegDate

string

required

Дата/час запиту у форматі yyyy-MM-dd HH:mm:ss

Example:

2023-09-12 12:16:00

x-uws-clientdn

string

required

Зазначене значення має дорівнювати значенню, указаному в полі Common Name (CN) для сертифіката SSL клієнта

Example:

GOLDENBANK

Content-Type

string

optional

application/json;charset=UTF-8

Example:

application/json

charset

string

optional

UTF-8

Example:

UTF-8

string

required

application/json

Example:

application/json

Body Params application/json

pageData

object

required

Дані сторінки зовнішньої системи

language

string

optional

Мова поточної сесії сторінки

Example

{"pageData":{"language":"ua"}}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

orderParam

object

required

Реєстраційні дані операції

orderStatus

integer

required

Стан операції

>= 0<= 6

orderId

string

required

Унікальний ідентифікатор операції у системі. Автоматично надається системою при обробці запиту на реєстрацію замовлення

>= 36 characters<= 36 characters

Example:

1c01e06f-c3da-4afe-94d4-8de1311c720f

orderVerifyFlag

integer

optional

Не заповнюється

orderAuthParam

object

required

Авторизаційні параметри

orderStatusExtParam

object

required

Розширені дані статусу

errorMessage

string

required

Опис помилки

<= 512 characters

orderId

string

required

currency

string

required

amount

string

required

string

required

date

string

required

authDateTime

string

required

authRefNum

string

required

Reference number

terminalId

string

required

Id терміналу

orderStatus

string

required

orderNumber

string

required

>= 32 characters<= 32 characters

actionCode

string

required

actionCodeDescription

string

required

<= 512 characters

cardAuthInfo

object

required

errorcode

integer

required

orderDescription

string

required

cardAuthInfo

object

optional

Інформаційний блок, що містить інформацію по карті

pan

string

optional

Маскований номер картки, яка використовувалась для оплати. Вказано лише після оплати замовлення

expiration

string

optional

Термін закінчення дії картки у форматі YYYYMM. Вказано лише після оплати замовлення

<= 6 characters

Match pattern:

YYYYMM

cardholderName

string

optional

Ім'я тримача карти

<= 64 characters

approvalCode

string

optional

Код авторизації

<= 10 characters

merchantOrderParams

object

optional

Тег, що містить атрибути, які містять додаткові параметри продавця.

name

string

optional

Назва додаткового параметра мерчанта.

<= 20 characters

value

string

optional

Значення додаткового параметра мерчанта.

<= 1024 characters

attributes

object

optional

name

string

optional

"mdOrder"

<= 7 characters

value

string

optional

mdOrder-Номер замовлення в платіжній системі (є унікальним в системі).

<= 36 characters

authRefNum

string

optional

Reference number

<= 24 characters

terminalId

string

optional

Id терміналу

refunds

object

optional

Інформація про повернення

referenceNumber

string

optional

Ідентифікатор операції

actionCode

string

optional

Код дії

amount

string

optional

Сума повернення

approvalCode

string

optional

Код підтвердження

date

string

optional

Дата операції

tokenifo

object

optional

Інформація по операції за участю токена

tokenid

integer

optional

Внутрішній ідентифікатор JWT платіжного токену.

tokenexpiry

string

optional

ISO-8601 timestamp (yyyy-mm-ddThh:mm:ss). Строк дії JWTтокену. Приклад: 2099-12-31T00:00:00.

Example:

2099-12-31T00:00:00.

token

string

optional

JWT платіжний токен.

<= 1000 characters

Examples

SuccessException

{
    "orderParam": {
        "orderStatus": 2,
        "orderId": "7a7dee7f-5d0f-43f7-8d44-d0e646641743",
        "orderAuthParam": {
            "approvalCode": "951678",
            "authCode": 2
        }
    },
    "tokeninfo": {
        "tokenid": "294685",
        "tokenexpiry": "2024-10-19T16:07:06",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnQiOiJwYW5DbGllbnQiLCJpZCI6IjY3MGUzMGJhNzMyYjc0YmVmMmZkNjM3OCIsInBhbl9tYXNrIjoiNTEyNzQzKioqKioqMjg5MCIsImV4cGRhdGUiOiIyOTA3IiwiY29uZl9kYXRhIjoiMWViMDUwYjJhNDE5OTI2YTRjZDk1MzdjM2M4NTczODc1ODE2YTgwYmY3ZjIzMWU2OTQ1OWEzNDliZjI2MTU4YzBlMDM4ODVhMjE5YzYyNWViNThiYzVkNmMyZjIxOTFkYTkzMWJlMDE5NmNlMTIzY2IzOWU5ODgzYzZhYTFiNjgxZDhhZWZkY2I4YTk2YzRiNDA5MzI1Y2JlYTFjNzYyNDUzNDgzZTViZDJmOTdiMjk1YjViY2ZmMDUxZGQxODM3OTRmNWYwNDdmYWEyZDU4MmJiOGViMWU2ZTNlNTk2ZjVjYjQ5MzMwZDJkN2E0NGJhMTQ0MDdmODYyYjJhYjZkOSIsInN1YiI6IjI5NDY4NSNNeSBjYXJkIGZvciBaUCM1MTI3IyMjIyMjMjg5MCMiLCJleHAiOjE3MjkzNDMyMjZ9.GhQVizQxLRy-0rB-CN5ePOtTF8-6zN6rqDoKgpDnskI"
    },
    "orderStatusExtParam": {
        "errorMessage": "Успешно",
        "orderId": "7a7dee7f-5d0f-43f7-8d44-d0e646641743",
        "currency": 980,
        "amount": "0",
        "ip": "10.0.24.23",
        "date": "1728979630634",
        "authDateTime": "1728979631003",
        "authRefNum": "000081951678",
        "terminalId": "I5176004",
        "orderStatus": 2,
        "orderNumber": "202410150000003",
        "actionCode": 0,
        "actionCodeDescription": "Запрос успешно обработан",
        "cardAuthInfo": {
            "pan": "51274311****2890",
            "expiration": "202907",
            "cardholderName": "TEXT",
            "authorizationResponseId": "951678"
        },
        "bankInfo": {
            "bankName": null,
            "bankCountryCode": null,
            "bankCountryName": "<Неизвестно>"
        },
        "paymentAmountInfo": {
            "approvedAmount": "0",
            "depositedAmount": "0",
            "refundedAmount": "0",
            "paymentState": "DEPOSITED"
        }
    }
}