Ukrcard en
  1. Payment transactions using tokens
Ukrcard en
  • Overview
  • Integration
  • Recipes
  • General Concepts
  • Merchant dashboard
  • References
    • 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/{PanID}
      • 3. PUT changeCardLimit-baseparam/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

/Panbytoken

Developing
POST
/Panbytoken
Obtaining a payment card number using a payment token

Request

Header Params
ExtSystemid
string 
optional
Example:
ECOM_GOLD_BANK
login
string 
optional
Example:
SECURE_LOGIN
password
string 
optional
Example:
SECURE_PASSWORD
orderNumber
string 
optional
Example:
1234
orderId
string 
optional
Example:
dbafea6c-3394-4f6a-a0d2-21d3d8e93e42
RegDate
string 
optional
Example:
2023-09-12 12:16:00
x-uws-clientdn
string 
optional
Example:
GOLDENBANK
Content-Type
string 
optional
charset
string 
optional
accept
string 
optional
Body Params application/json
token
string 
required
JWT payment token
Example
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnQiOiJwYW5DbGllbnQiLCJpZCI6IjY4MTA3YTQ4NWQ1M2Q3MDJlOTU5MmI1YyIsInBhbl9tYXNrIjoiNDEyMzY0KioqKioqMTExMCIsImNvbmZfZGF0YSI6IjljZThkZjU1MjhmMGE2NWZiNzRkZTU3MmM1MTk4OTE1MDgyZTU5YmRmMGM2ZDJjZjA2NzZlNzMyZWM5OTFlOTA5ODQwOTc0MmJiODUxYTgxZTFmM2Y0MWZiOGYxNzNmZDc3YWNlZDNiZjdlZDU5OTM1NzE5NTQ2OWQ3ZThhNTc0NzRkNzI1MGEwNDU1ODZhMDBhYWI0MzE4M2UyMTczYzAiLCJzdWIiOiIzNTIzNzQjc2VuZGVyY2FyZGFsaWFzXzQxMjM2NDAwMDgwNDExMTAjNDEyMyMjIyMjIyMxMTEwIyIsImV4cCI6MTc0NjI3MDM0NH0.wYh8MGbZNb_BFbfF36R1HJtK6nmnS6x0Ik6mZ0h68wo"
}

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 POST 'https://mock.apidog.com/m1/537337-0-default/Panbytoken' \
--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 '{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnQiOiJwYW5DbGllbnQiLCJpZCI6IjY4MTA3YTQ4NWQ1M2Q3MDJlOTU5MmI1YyIsInBhbl9tYXNrIjoiNDEyMzY0KioqKioqMTExMCIsImNvbmZfZGF0YSI6IjljZThkZjU1MjhmMGE2NWZiNzRkZTU3MmM1MTk4OTE1MDgyZTU5YmRmMGM2ZDJjZjA2NzZlNzMyZWM5OTFlOTA5ODQwOTc0MmJiODUxYTgxZTFmM2Y0MWZiOGYxNzNmZDc3YWNlZDNiZjdlZDU5OTM1NzE5NTQ2OWQ3ZThhNTc0NzRkNzI1MGEwNDU1ODZhMDBhYWI0MzE4M2UyMTczYzAiLCJzdWIiOiIzNTIzNzQjc2VuZGVyY2FyZGFsaWFzXzQxMjM2NDAwMDgwNDExMTAjNDEyMyMjIyMjIyMxMTEwIyIsImV4cCI6MTc0NjI3MDM0NH0.wYh8MGbZNb_BFbfF36R1HJtK6nmnS6x0Ik6mZ0h68wo"
}'

Responses

🟢200Success
application/json
Body
tokenid
integer 
required
Internal identifier
JWT payment token
pan
string 
required
Payment card number obtained from payment token.
Example
{
  "tokenid": "352374",
  "pan": "4111110001000000"
}
Modified at 2025-04-29 13:18:57
Previous
/р2рTransfer
Next
/PaymentAppleD
Built with