Ukrcard en
  1. Transfers
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
        POST
      • /Confirm
        POST
      • /ConfirmExt
        POST
      • /Reverse
        POST
      • /Refund
        POST
      • /Verify
        POST
    • 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
      • /Preauthorization
      • /Confirm
      • /ConfirmExt
      • /р2рTransfer
      • /Panbytoken
    • Apple Pay
      • /PaymentAppleD
      • /PaymentAppleE
    • Google Pay
      • /PaymentGoogleD
      • /PaymentGoogleE
  1. Transfers

/р2рTransfer

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

Request

Header Params

Body Params application/json

Example
{
   "orderData":{
      "amount":48000,
      "currency":980,
      "externalFee":2000,
      "description":"P2P to CHELENTANO ADRIANO"
   },
   "sender":{
      "pan":"51230000000001",
      "expiry":"2812",
      "cvc":"123",
      "senderCardName":"MORANDI GIANNI",
      "senderAddress":"Str Mihai Eminescu",
      "senderCity":"Rimini",
      "senderCountry":"978"
   },
   "receiver":{
      "receiverPAN":"55780000000001",
      "receiverName":"BERLINSCHI ALEXANDRU"
   },
   "pageData":{
      "language":"en",
      "returnUrl":"https://p2p.ukrcard.com/callback-page-from/a5a414b6-1aef-ee11-bccb-ac162d763a23/a7a414b6-1aef-ee11-bccb-ac162d763a23/8e210423-1aef-ee11-bccb-ac162d763a23",
      "failUrl":"https://p2p.ukrcard.com/callback-page-from/a5a414b6-1aef-ee11-bccb-ac162d763a23/a7a414b6-1aef-ee11-bccb-ac162d763a23/8e210423-1aef-ee11-bccb-ac162d763a23"
   },
   "param":{
      "paramName":"tran_type",
      "paramValue":"transfer"
   },
   "paramsp2p":{
      "fundingOrPaymentTransactionTypeIndicator":"C07",
      "payerName":"MORANDI GIANNI",
      "payerAccountType":"03",
      "payerAddress":"Str Mihai Eminescu ",
      "payerCity":"Rimini",
      "payerCountry":"380",
      "recipientName":"CHELENTANO ADRIANO",
      "recipientAccountType":"03"
   },
   "browserParams":{
      "userAgent":"Mozilla/5.0 (Linux; Android 13; 2201117TY Build/TKQ1.221114.001; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/122.0.6261.120 Mobile Safari/537.36",
      "colorDepth":24,
      "screenHeight":873,
      "screenWidth":393,
      "javaEnabled":false,
      "browserLanguage":"it-IT",
      "browserTimeZone":"Europe/Rome",
      "browserTimeZoneOffset":-60,
      "browserAcceptHeader":"application/json, text/plain, */*",
      "browserIpAddress":"212.0.113.154",
      "javascriptEnabled":true
   }
}

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":48000,
      "currency":980,
      "externalFee":2000,
      "description":"P2P to CHELENTANO ADRIANO"
   },
   "sender":{
      "pan":"51230000000001",
      "expiry":"2812",
      "cvc":"123",
      "senderCardName":"MORANDI GIANNI",
      "senderAddress":"Str Mihai Eminescu",
      "senderCity":"Rimini",
      "senderCountry":"978"
   },
   "receiver":{
      "receiverPAN":"55780000000001",
      "receiverName":"BERLINSCHI ALEXANDRU"
   },
   "pageData":{
      "language":"en",
      "returnUrl":"https://p2p.ukrcard.com/callback-page-from/a5a414b6-1aef-ee11-bccb-ac162d763a23/a7a414b6-1aef-ee11-bccb-ac162d763a23/8e210423-1aef-ee11-bccb-ac162d763a23",
      "failUrl":"https://p2p.ukrcard.com/callback-page-from/a5a414b6-1aef-ee11-bccb-ac162d763a23/a7a414b6-1aef-ee11-bccb-ac162d763a23/8e210423-1aef-ee11-bccb-ac162d763a23"
   },
   "param":{
      "paramName":"tran_type",
      "paramValue":"transfer"
   },
   "paramsp2p":{
      "fundingOrPaymentTransactionTypeIndicator":"C07",
      "payerName":"MORANDI GIANNI",
      "payerAccountType":"03",
      "payerAddress":"Str Mihai Eminescu ",
      "payerCity":"Rimini",
      "payerCountry":"380",
      "recipientName":"CHELENTANO ADRIANO",
      "recipientAccountType":"03"
   },
   "browserParams":{
      "userAgent":"Mozilla/5.0 (Linux; Android 13; 2201117TY Build/TKQ1.221114.001; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/122.0.6261.120 Mobile Safari/537.36",
      "colorDepth":24,
      "screenHeight":873,
      "screenWidth":393,
      "javaEnabled":false,
      "browserLanguage":"it-IT",
      "browserTimeZone":"Europe/Rome",
      "browserTimeZoneOffset":-60,
      "browserAcceptHeader":"application/json, text/plain, */*",
      "browserIpAddress":"212.0.113.154",
      "javascriptEnabled":true
   }
}'

Responses

🟢200OK
application/json
Body

Example
{
    "orderParam": {
        "orderStatus": 0,
        "orderId": "677a1413-e59d-44d6-9a28-d2bc7208c27a",
        "orderVerifyFlag": 0,
        "orderAuthParam": {}
    },
    "fee": null,
    "auth3DData": {
        "paReq": null,
        "acsurl": "https://acs.alfabank.kiev.ua/acs/api/3ds2/creqbrw",
        "creq": "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImQ1NjVkN2IwLTc5MzMtNDQ3Yi1hMTY4LWFhYjI4OTBhODUzMiIsImFjc1RyYW5zSUQiOiI5MmNkMDdkNy0xZWRmLTRlNGEtOTM4Ny1iNzNlOTQ1YWMwNTEiLCJjaGFsbGVuZ2VXaW5kb3dTaXplIjoiMDQiLCJtZXNzYWdlVHlwZSI6IkNSZXEiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIn0="
    }
}
Modified at 2025-06-26 12:38:13
Previous
/Verify
Next
/Confirm
Built with