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

/Payment

POST
/Payment
Подивится українською
Initiation of execution of the "payment" operation by an external system using its own web interface

Request

Header Params

Body Params application/json

Example
{
    "sender": {
        "cvc": "576",
        "senderCardName": "Test Test",
        "expiry": "2606",
        "pan": "5248721588681850",
        "sendercardalias": "My card for ZP",
        "sendertoken": "publish"
    },
    "orderData": {
        "amount": 30000,
        "description": "Paymnet order 12345",
        "currency": 980
    },
    "pageData": {
        "language": "uk",
        "returnUrl": "https://order.ukrcard.ua/acquiring/acquiringresult?id=8646997",
        "failUrl": "https://order.ukrcard.ua/acquiring/acquiringresult?id=8646997"
    },
    "jsonParams": {
        "disableEmail": "true",
        "disablePhone": "true"
    },
    "browserParams": {
        "javascriptEnabled": true,
        "userAgent": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Mobile Safari/537.36",
        "colorDepth": 24,
        "screenHeight": 892,
        "screenWidth": 412,
        "javaEnabled": false,
        "browserLanguage": "ro-MD",
        "browserTimeZone": "Europe/Chisinau",
        "browserAcceptHeader": "*/*",
        "browserIpAddress": "94.139.152.182",
        "browserTimeZoneOffset": 120
    }
}

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/Payment' \
--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 'charset;' \
--header 'accept;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sender": {
        "cvc": "576",
        "senderCardName": "Test Test",
        "expiry": "2606",
        "pan": "5248721588681850",
        "sendercardalias": "My card for ZP",
        "sendertoken": "publish"
    },
    "orderData": {
        "amount": 30000,
        "description": "Paymnet order 12345",
        "currency": 980
    },
    "pageData": {
        "language": "uk",
        "returnUrl": "https://order.ukrcard.ua/acquiring/acquiringresult?id=8646997",
        "failUrl": "https://order.ukrcard.ua/acquiring/acquiringresult?id=8646997"
    },
    "jsonParams": {
        "disableEmail": "true",
        "disablePhone": "true"
    },
    "browserParams": {
        "javascriptEnabled": true,
        "userAgent": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Mobile Safari/537.36",
        "colorDepth": 24,
        "screenHeight": 892,
        "screenWidth": 412,
        "javaEnabled": false,
        "browserLanguage": "ro-MD",
        "browserTimeZone": "Europe/Chisinau",
        "browserAcceptHeader": "*/*",
        "browserIpAddress": "94.139.152.182",
        "browserTimeZoneOffset": 120
    }
}'

Responses

🟢200OK
application/json
Body

Examples
{
    "orderParam": {
        "orderStatus": 2,
        "orderId": "7a7dee7f-5d0f-43f7-8d44-d0e646641743",
        "orderAuthParam": {
            "approvalCode": "951678",
            "authCode": 2
        }
    },
    "fee": null,
    "auth3DData": {
        "acsurl": null,
        "paReq": null,
        "creq": null
    },
    "tokeninfo": {
        "tokenid": "294685",
        "tokenexpiry": "2024-10-19T16:07:06",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnQiOiJwYW5DbGllbnQiLCJpZCI6IjY3MGUzMGJhNzMyYjc0YmVmMmZkNjM3OCIsInBhbl9tYXNrIjoiNTEyNzQzKioqKioqMjg5MCIsImV4cGRhdGUiOiIyOTA3IiwiY29uZl9kYXRhIjoiMWViMDUwYjJhNDE5OTI2YTRjZDk1MzdjM2M4NTczODc1ODE2YTgwYmY3ZjIzMWU2OTQ1OWEzNDliZjI2MTU4YzBlMDM4ODVhMjE5YzYyNWViNThiYzVkNmMyZjIxOTFkYTkzMWJlMDE5NmNlMTIzY2IzOWU5ODgzYzZhYTFiNjgxZDhhZWZkY2I4YTk2YzRiNDA5MzI1Y2JlYTFjNzYyNDUzNDgzZTViZDJmOTdiMjk1YjViY2ZmMDUxZGQxODM3OTRmNWYwNDdmYWEyZDU4MmJiOGViMWU2ZTNlNTk2ZjVjYjQ5MzMwZDJkN2E0NGJhMTQ0MDdmODYyYjJhYjZkOSIsInN1YiI6IjI5NDY4NSNNeSBjYXJkIGZvciBaUCM1MTI3IyMjIyMjMjg5MCMiLCJleHAiOjE3MjkzNDMyMjZ9.GhQVizQxLRy-0rB-CN5ePOtTF8-6zN6rqDoKgpDnskI"
    }
}
🔴500wsGate Internal Error
Modified at 2025-06-26 12:41:08
Previous
/cards/{panid}/baseparam/limits (112-Request/change card limits)
Next
/Preauthorization
Built with