1. Visa Alias
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
      • /Preauthorization
      • /Confirm
      • /ConfirmExt
      • /р2рTransfer
      • /Panbytoken
    • Apple Pay
      • /PaymentAppleD
      • /PaymentAppleE
      • /p2pTransferAppleD
      • /p2pTransferAppleE
    • Google Pay
      • /PaymentGoogleD
      • /PaymentGoogleE
      • /p2pTransferGoogleD
      • /p2pTransferGoogleE
    • Visa Alias
      • /Inquiry
        POST
      • /Resolve
        POST
  1. Visa Alias

/Inquiry

Developing
POST
/Inquiry
Alias Inquiry This enables clients to check if an Alias or list of Aliases is available for Alias resolution. The response will indicate the Aliases that are available for Alias resolution. Up to 1000 Aliases can be sent in a single request.

Request

Header Params

Body Params application/jsonRequired

Example
{
    "transactionDetails": {
        "currencyCode": "USD"
    },
    "aliases": [
        "375293334444",
        "t.test@ukrcard.ua",
        "375293334444",
        "375293334443",
        "ukrcard_redmine@ukrcard.com.ua"
    ]
}

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/Inquiry' \
--header 'ExtSystemid: ECOM_GOLD_BANK' \
--header 'login: SECURE_LOGIN' \
--header 'password: SECURE_PASSWORD' \
--header 'orderNumber: 1234' \
--header 'RegDate: 2023-09-12 12:16:00	' \
--header 'x-uws-clientdn: GOLDENBANK' \
--header 'charset: UTF-8' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactionDetails": {
        "currencyCode": "USD"
    },
    "aliases": [
        "375293334444",
        "t.test@ukrcard.ua",
        "375293334444",
        "375293334443",
        "ukrcard_redmine@ukrcard.com.ua"
    ]
}'

Responses

🟢200Success
application/json
Body

Example
"orderId": "10420261157",
"details": [
    {
        "aliasType": "PHONE",
        "aliasValue": "375293334444",
        "directories": [
            {
                "directoryName": "STANDARD_VISA",
                "entities": [
                    {
                        "id": "646c43ac-0f97-4423-9548-e890d1ac78a1",
                        "preferredFor": []
                    },
                    {
                        "id": "883a95fd-a25a-4786-aac4-cb7a1e3a3e77",
                        "preferredFor": []
                    }
                ]
            },
            {
                "directoryName": "VAD"
            }
        ],
        "directoriesName": [
            "STANDARD_VISA",
            "VAD"
        ]
    },
    {
        "aliasType": "PHONE",
        "aliasValue": "375293334443",
        "directories": [
            {
                "directoryName": "STANDARD_VISA",
                "entities": [
                    {
                        "id": "16f98ee5-2614-4c32-932e-65e20194aafa",
                        "preferredFor": [
                            {
                                "type": "SEND",
                                "date": "2025-10-03T13:30:15.807Z"
                            }
                        ]
                    }
                ]
            },
            {
                "directoryName": "VAD"
            }
        ],
        "directoriesName": [
            "STANDARD_VISA",
            "VAD"
        ]
    }
],
"summary": {
    "aliasesFound": 2,
    "aliasesTotal": 5,
    "aliasesNotFound": 2,
    "aliasesRepeated": 1
}
}
Modified at 2026-04-07 07:34:43
Previous
/p2pTransferGoogleE
Next
/Resolve
Built with