Ukrcard
  1. Картки та рахунки (UAPI)
Ukrcard
  • Вступ
  • Початок роботи
  • Рецепти
  • Загальні концепції
  • Особистий кабінет торговця
  • Довідка
    • Потоки обробки транзакцій
    • Коди відповідей
    • Тестові дані
  • Наші методи
    • E-Commerce еквайринг
      • /Payment
      • /Preauthorization
      • /CancelPreauthorization
      • /Completion
      • /ConfirmExt
      • /Reverse
      • /Refund
      • /Verify
    • Грошові перекази
      • /р2рTransfer
      • /Confirm
      • /ConfirmExt
      • /Reverse
      • /Refund
      • /Verify
    • Платежі з цифрового гаманця
    • Картки та рахунки (UAPI)
      • /cards/issuacevirtualcard (140-Запит видачі віртуальної картки)
        PUT
      • /cards/issuacephysicalcard (141-Запит видачі фізичної картки)
        PUT
      • /cards/{panid}/baseparam/status (111-Запит/зміна статусу картки)
        PUT
      • /cards/getcarddataecom (138-Запит даних картки для eCommerce)
        PUT
      • /cards/setpin (137-Запит на встановлення PIN картки)
        PUT
      • /cards/changepin (136-Замовлення зміни PIN картки)
        PUT
      • /cards/gettransactions (122-Запит історії транзакцій)
        PUT
      • /cards/{panid}/baseparam/limits (112-Запит/зміна лімітів карти)
        PUT
    • Перекази SEPA
    • Платіжні операції з використанням токенів
      • /Payment
      • /Preauthorization
      • /p2pTransfer
      • /Confirm
      • /ConfirmExt
      • /Panbytoken
    • Apple Pay
      • /PaymentAppleD
      • /PaymentAppleE
    • Google Pay
      • /PaymentGoogleD
      • /PaymentGoogleE
  1. Картки та рахунки (UAPI)

/cards/gettransactions (122-Запит історії транзакцій)

Developing
Cloud Mock
https://mock.apidog.com/m1/483896-0-default
Cloud Mock
https://mock.apidog.com/m1/483896-0-default
PUT
/uapi-2.0/v1/cards/gettransactions
Maintainer:Not configured
Запит історії транзакцій.
pan&panmask&mbr&panid terminalId Запит операцій:
1.
!=null !=null всі операції за період по pan&terminalId
2.
!=null =null все операції за період по pan
3.
=null !=null все операції за період по terminalId

Request

Header Params
x-uws-systemid
string 
optional
Example:
TESTSS
x-uws-requestid
string 
optional
Example:
0512231523
x-uws-date
string 
optional
Example:
2020-03-25T00:00:00.000+0200
x-uws-PSID
string 
optional
Example:
B101
x-uws-FIID
string 
optional
Example:
F101
Accept
string 
optional
Example:
application/xml
Body Params application/json
pan
string  | null 
optional
Номер картки. Якщо тег є присутнім і заповнений, то значення panmask, panid ігноруються.
<= 19 characters
panmask
string  | null 
optional
Номер маскований:
NNNNNN******NNNN.
Якщо тег pan присутній і заповнений, то значення panmask і присутній і заповнений тег panmask, то значення panmask має відповідати значенню pan.
Якщо тег pan відсутній або не заповнений, виконується контроль:
Котроль Текст помилки
panmask!=null І довжина > 19 Поле має містити до 19 символів.
<= 19 characters
mbr
integer  | null 
optional
Номер учасника картки. Завжди = 0.
Котроль Текст помилки
≠ 0 Поле має бути завжди 0
Якщо не заповнено, то за промовчанням = 0.
panid
string  | null 
optional
Індекс картки (PANId).
Якщо тег pan є присутнім і заповнений, то значення panid має відповідати значенню pan.
Якщо тег pan відсутній або не заповнений, виконується контроль:
Котроль Текст помилки
panid=null І
довжина >20 Поле має містити до 20 символів.
period
object 
required
Часовий період.
Діапазон дат із суворими межами (begin≤AutriondateDate≤end)
begin
string  | null 
optional
Дата початку періоду YYYY-MM-DD. Наприклад, 2025-08-13
Якщо не вказано, то дата початку періоду відповідає даті кінця періоду Початок = кінець.
І якщо дата не вказана, то поточна дата календаря вважається датою початку періоду
У форматі Yyyy-MM-DD.
end
string  | null 
optional
Кінцева дата періоду Yyyy-MM-DD. Наприклад, 2025-08-13.
Якщо не вказано, то дата кінця відповідає даті початку кінця періоду = починати. І якщо дата початку не вказана, то поточна дата календаря вважається кінцем періоду.
У форматі YYYY-MM-DD.
terminalId
string  | null 
optional
Ідентифікатор терміналу.
<= 16 characters
Example
{
    "mbr": "0",
    "panid": "0504000000101707306",
    "panmask": "516857######2884",
    "period": {
        "begin": "2024-12-18",
        "end": "2024-12-18"
    },
    "terminalId": null
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://mock.apidog.com/m1/483896-0-default/uapi-2.0/v1/cards/gettransactions' \
--header 'x-uws-systemid: TESTSS' \
--header 'x-uws-requestid: 0512231523' \
--header 'x-uws-date: 2020-03-25T00:00:00.000+0200' \
--header 'x-uws-PSID: B101' \
--header 'x-uws-FIID: F101' \
--header 'Accept: application/xml' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mbr": "0",
    "panid": "0504000000101707306",
    "panmask": "516857######2884",
    "period": {
        "begin": "2024-12-18",
        "end": "2024-12-18"
    },
    "terminalId": null
}'

Responses

🟢200Success
application/json
Body
filteroftransactions
object 
required
Фільтр списку транзакцій.
panmask
string  | null 
optional
Номер карти маскований:
NNNNNN******NNNN.
<= 19 characters
panid
string  | null 
optional
Індекс картки (PANId).
<= 20 characters
accountno
string  | null 
optional
Номер картрахунку.
<= 20 characters
terminalid
string  | null 
optional
Ідентифікатор терміналу.
Match pattern:
16
period
object 
required
Часовий період.
Діапазон дат із суворими межами (begin≤AutriondateDate≤end).
transactions
object 
required
Запис про операцію по карті.
transaction
object 
required
Запис про операцію по карті.
Example
{
    "filteroftransactions": {
        "panmask": "410383######0115",
        "panid": "0501000000101707666",
        "terminalId": null,
        "period": {
            "begin": "2024-11-12",
            "end": "2024-11-12"
        }
    },
    "transactions": {
        "transaction": [
            {
                "pan": "410383######0115",
                "mbr": "0",
                "tranDateTime": "2024-11-12T16:53:10.000+0200",
                "messageType": "360",
                "tranCode": "01",
                "responseCode": "000",
                "approvalCode": "910715",
                "invoicenum": null,
                "retailId": "IBNS4SV1",
                "retailSICCode": 6012,
                "terminalId": "IBNS4SV1",
                "termType": "03",
                "termFIID": null,
                "terminalNameLocation": "SVGATE ePOS4 UKR KYIV 12B Sverstuka str.",
                "terminalCity": "KYIV",
                "terminalCountry": "UKR",
                "tranCurrencyCode": 0,
                "tranAmt1": 0,
                "tranValuePCCur": 0,
                "tranValueTranCur": 0,
                "merchantName": "SVGATE ePOS4",
                "utrnno": 83910715,
                "boWriteOffDate": null,
                "operationDirection": "NOOP",
                "amountInAccountCurrency": 0,
                "transactionDescription": "CARD_STATUS_INQ",
                "feeDirection": "DEBIT",
                "acquireFeeAmount": 0,
                "feIssuerFeeAmount": 0,
                "boIssuerFeeAmount": null,
                "reversal": "0",
                "reversalDate": null,
                "posDataCode": "100000U00130",
                "transactionType": 650,
                "avlBal": 167.00,
                "authorizationIdResponse": null,
                "expDate": "3102",
                "pinCheck": "0",
                "respCode": null,
                "ucMerchantCountry": "UKR",
                "ucMerchantId": "IBNS4SV1",
                "ucMerchantName": "SVGATE ePOS4",
                "accountNo": "FNS126252371300001",
                "currencyNo": "980"
            }
        ]
    }
}
Modified at 2025-07-09 09:11:30
Previous
/cards/changepin (136-Замовлення зміни PIN картки)
Next
/cards/{panid}/baseparam/limits (112-Запит/зміна лімітів карти)
Built with