Ukrcard en
  1. Payment transactions using tokens
Ukrcard en
  • Overview
  • Integration
  • Recipes
  • General Concepts
  • Merchant dashboard
  • References
    • Setting up and using the callback service
    • Transaction processing flows
    • Response Codes
    • Test Data
  • Our Restful API
    • E-Commerce acquiring
      • /Payment
      • /Preauthorization
      • /CancelPreauthorization
      • /Completion
      • /Confirm
      • /ConfirmExt
      • /Reverse
      • /Refund
      • /Verify
    • Transfers
      • /р2рTransfer
      • /Confirm
      • /ConfirmExt
      • /Reverse
      • /Refund
      • /Verify
    • Cards and accounts (UAPI)
      • /cards/issuacevirtualcard (140-Request for issuance of a virtual card)
      • /cards/issuacephysicalcard (141-Request for a physical card)
      • /cards/{panid}/baseparam/status (111-Request/change card status)
      • /cards/getcarddataecom (138-Request card details for eCommerce)
      • /cards/setpin (137-Request to set a PIN on a card)
      • /cards/changepin (136-Ordering a card PIN change and sending it via SMS )
      • /cards/gettransactions (122-Request for transaction history)
      • /cards/{panid}/baseparam/limits (112-Request/change card limits)
    • Payment transactions using tokens
      • /Payment
        POST
      • /Preauthorization
        POST
      • /Confirm
        POST
      • /ConfirmExt
        POST
      • /р2рTransfer
        POST
      • /Panbytoken
        POST
    • Apple Pay
      • /PaymentAppleD
      • /PaymentAppleE
    • Google Pay
      • /PaymentGoogleD
      • /PaymentGoogleE
  1. Payment transactions using tokens

/ConfirmExt

POST
/ConfirmExt
Подивится українською
The /ConfirmExt is used to obtain the extended status of a registered order.
The default life cycle of all requests in our systems is 20 minutes.
That is, if 20 minutes after the original request for an extended status request you receive any response, then it will not change by default.
Therefore, there is no point in performing status re-queries for several days.
We recommend performing re-queries with increasing time between re-queries (5s, 10s, 15s, 30s, 1min, 1min, 2min, 3min, 5min, 10min) until the request lifetime expires, i.e. up to 20 minutes, or earlier if the final status is received.
That is, status re-queries are usually performed in quantities from 1 to 10.

Request

Header Params

Body Params application/json

Example
{
    "pageData": {
        "language": "uk"
    }
}

Request Code 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 POST 'https://mock.apidog.com/m1/537337-0-default/ConfirmExt' \
--header 'ExtSystemid: ECOM_GOLD_BANK' \
--header 'login: SECURE_LOGIN' \
--header 'password: SECURE_PASSWORD' \
--header 'orderNumber: 1234' \
--header 'orderId: dbafea6c-3394-4f6a-a0d2-21d3d8e93e42' \
--header 'RegDate: 2023-09-12 12:16:00	' \
--header 'x-uws-clientdn: GOLDENBANK' \
--header 'accept;' \
--header 'charset;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pageData": {
        "language": "uk"
    }
}'

Responses

🟢200OK
application/json
Body

Examples
{
    "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"
        }
    }
}
Modified at 2025-07-15 06:47:59
Previous
/Confirm
Next
/р2рTransfer
Built with