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

/р2рTransfer

POST
/p2pTransfer
Подивится українською
Ініціація виконання операції «платіж» зовнішньою системою, що використовує власний веб-інтерфейс

Request

Header Params

Body Params application/json

Example
{
  "orderData": {
    "amount": 100,
    "currency": 980,
    "description": "Auth description"
  },
  "sender": {
    "pan": "5248723336511397",
    "expiry": "2606",
    "cvc": "576",
    "senderCardName": "sender name",
    "sendercardalias": "My card for ZP",
    "sendertoken": "publish"
     },
  "receiver": {
    "receiverPAN": "5248723339655340"
  },
  "param": {
    "paramName": "tran_type",
    "paramValue": "transfer"
  },
  "pageData": {
    "language": "uk",
    "returnUrl": "https://secure-stg.secure3d.net/m3uc/action/8e43c4b5-5b1d-4d25-906f-a2f5b03fb49c/complete_3ds",
    "failUrl": "https://secure-stg.secure3d.net/m3uc/action/8e43c4b5-5b1d-4d25-906f-a2f5b03fb49c/complete_3ds"
  },
  "browserParams": {
    "browserTimeZone": "Europe/Kiev",
    "browserTimeZoneOffset": "-120",
    "browserLanguage": "uk-UA",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.108 Safari/537.36",
    "browserAcceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
    "browserIpAddress": "8.8.8.8",
    "screenWidth": "1920",
    "screenHeight": "1080",
    "javaEnabled": "false",
    "colorDepth": "24"
  },
  "paramsp2p": {
    "payerName": "sender name"
  }
}

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/p2pTransfer' \
--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 '{
  "orderData": {
    "amount": 100,
    "currency": 980,
    "description": "Auth description"
  },
  "sender": {
    "pan": "5248723336511397",
    "expiry": "2606",
    "cvc": "576",
    "senderCardName": "sender name",
    "sendercardalias": "My card for ZP",
    "sendertoken": "publish"
     },
  "receiver": {
    "receiverPAN": "5248723339655340"
  },
  "param": {
    "paramName": "tran_type",
    "paramValue": "transfer"
  },
  "pageData": {
    "language": "uk",
    "returnUrl": "https://secure-stg.secure3d.net/m3uc/action/8e43c4b5-5b1d-4d25-906f-a2f5b03fb49c/complete_3ds",
    "failUrl": "https://secure-stg.secure3d.net/m3uc/action/8e43c4b5-5b1d-4d25-906f-a2f5b03fb49c/complete_3ds"
  },
  "browserParams": {
    "browserTimeZone": "Europe/Kiev",
    "browserTimeZoneOffset": "-120",
    "browserLanguage": "uk-UA",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.108 Safari/537.36",
    "browserAcceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
    "browserIpAddress": "8.8.8.8",
    "screenWidth": "1920",
    "screenHeight": "1080",
    "javaEnabled": "false",
    "colorDepth": "24"
  },
  "paramsp2p": {
    "payerName": "sender name"
  }
}'

Responses

🟢200OK
application/json
Body

Examples
{
    "orderParam": {
        "orderStatus": 2,
        "orderId": "28730d8f-7d8f-42fc-876d-98ec89215703",
        "orderAuthParam": {
            "approvalCode": "156032",
            "authCode": 2
        }
    },
    "fee": {
        "feeAmount": "220",
        "feeCurrency": "980"
    },
    "auth3DData": {
        "acsurl": null,
        "paReq": null,
        "creq": null
    },
    "tokeninfo": {
        "tokenid": "294685",
        "tokenexpiry": "2024-10-19T16:07:06",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnQiOiJwYW5DbGllbnQiLCJpZCI6IjY3MGUzMGJhNzMyYjc0YmVmMmZkNjM3OCIsInBhbl9tYXNrIjoiNTEyNzQzKioqKioqMjg5MCIsImV4cGRhdGUiOiIyOTA3IiwiY29uZl9kYXRhIjoiMWViMDUwYjJhNDE5OTI2YTRjZDk1MzdjM2M4NTczODc1ODE2YTgwYmY3ZjIzMWU2OTQ1OWEzNDliZjI2MTU4YzBlMDM4ODVhMjE5YzYyNWViNThiYzVkNmMyZjIxOTFkYTkzMWJlMDE5NmNlMTIzY2IzOWU5ODgzYzZhYTFiNjgxZDhhZWZkY2I4YTk2YzRiNDA5MzI1Y2JlYTFjNzYyNDUzNDgzZTViZDJmOTdiMjk1YjViY2ZmMDUxZGQxODM3OTRmNWYwNDdmYWEyZDU4MmJiOGViMWU2ZTNlNTk2ZjVjYjQ5MzMwZDJkN2E0NGJhMTQ0MDdmODYyYjJhYjZkOSIsInN1YiI6IjI5NDY4NSNNeSBjYXJkIGZvciBaUCM1MTI3IyMjIyMjMjg5MCMiLCJleHAiOjE3MjkzNDMyMjZ9.GhQVizQxLRy-0rB-CN5ePOtTF8-6zN6rqDoKgpDnskI"
    }
}
Modified at 2025-06-26 12:42:37
Previous
/ConfirmExt
Next
/Panbytoken
Built with