Retrieve Card Details

const response = await fetch(
  'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d?retrieveCVV=yes',
  {
    headers: {
      'Authorization': 'APIKEY your-api-key'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d',
    headers={'Authorization': 'APIKEY your-api-key'},
    params={'retrieveCVV': 'yes'}
)

print(response.json())

{
    "@xmlns": "http://www.pcibooking.net/reservation",
    "@schemaVersion": "1.0",
    "BankCard": {
        "Type": "Visa",
        "Number": "4918914107195005",
        "NameOnCard": "Juan Dela Cruz",
        "ExpirationDate": {
            "Month": "07",
            "Year": "2020"
        },
        "IssueNumber": "2"
    }
}

{
    "@xmlns": "http://www.pcibooking.net/reservation",
    "@schemaVersion": "1.0",
    "BankCard": {
        "Type": "Visa",
        "Number": "4918914107195005",
        "NameOnCard": "Juan Dela Cruz",
        "ExpirationDate": {
            "Month": "07",
            "Year": "2020"
        },
        "IssueNumber": "2",
        "CVV": "123"
    }
}

{
    "code": -1003,
    "message": "Not authorized to access this resource",
    "moreInfo": "Bad or missing authorization data, expected APIKEY or HTTP Basic",
    "errorList": null
}

{
    "code": -160,
    "message": "Uri not found",
    "moreInfo": "Uri to Bank card not found",
    "errorList": null
}

GET

api

payments

paycard

{cardToken}

const response = await fetch(
  'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d?retrieveCVV=yes',
  {
    headers: {
      'Authorization': 'APIKEY your-api-key'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d',
    headers={'Authorization': 'APIKEY your-api-key'},
    params={'retrieveCVV': 'yes'}
)

print(response.json())

{
    "@xmlns": "http://www.pcibooking.net/reservation",
    "@schemaVersion": "1.0",
    "BankCard": {
        "Type": "Visa",
        "Number": "4918914107195005",
        "NameOnCard": "Juan Dela Cruz",
        "ExpirationDate": {
            "Month": "07",
            "Year": "2020"
        },
        "IssueNumber": "2"
    }
}

{
    "@xmlns": "http://www.pcibooking.net/reservation",
    "@schemaVersion": "1.0",
    "BankCard": {
        "Type": "Visa",
        "Number": "4918914107195005",
        "NameOnCard": "Juan Dela Cruz",
        "ExpirationDate": {
            "Month": "07",
            "Year": "2020"
        },
        "IssueNumber": "2",
        "CVV": "123"
    }
}

{
    "code": -1003,
    "message": "Not authorized to access this resource",
    "moreInfo": "Bad or missing authorization data, expected APIKEY or HTTP Basic",
    "errorList": null
}

{
    "code": -160,
    "message": "Uri not found",
    "moreInfo": "Uri to Bank card not found",
    "errorList": null
}

Query & Retrieve Guide

Search for tokens and retrieve their metadata

Please note that the response to this method will be the full and unmasked card details. Processing this response will put the system, network and all connected components into PCI scope. Before using this method, we recommend that you review the need for using it and setting up the proper environment to run it in.

Retrieves the full, unmasked card number and all associated card details for a token. This endpoint is intended for PCI DSS-compliant environments that need raw card data, such as for manual payment processing or migration to another vault.

Error Responses

Code	HTTP Status	Condition
-1003	401	User is not the owner and is not associated with this card
-160	404	Card not found for the given token

Parameter Constraints

Parameter	Type	Required	Constraints
cardToken	string	Yes	Must be a 32-character hexadecimal string
retrieveCVV	string	No	Accepts `yes`, `no`, or `mask`. Defaults to `no` (CVV not returned)
Auth	string	Yes	ApiKey with `CanReplaceToken` or `CanRetrieveCard` permission

Parameters

Headers

Authorization

string

required

Your API key prefixed with APIKEY. Example: APIKEY your-api-key. See the Authentication guide.

Path Parameters

cardToken

string

required

The token ID as returned by one of the tokenization methods. For example, 2821a46d80e14d1b96a7f18f1b81926d.

Query String

retrieveCVV

string

default:"no"

Specifies how the CVV should be handled in the response: Yes: the CVV will be retrieved. No: the CVV will not be retrieved. Mask: the CVV will return masked.

const response = await fetch(
  'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d?retrieveCVV=yes',
  {
    headers: {
      'Authorization': 'APIKEY your-api-key'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d',
    headers={'Authorization': 'APIKEY your-api-key'},
    params={'retrieveCVV': 'yes'}
)

print(response.json())

Response

{
    "@xmlns": "http://www.pcibooking.net/reservation",
    "@schemaVersion": "1.0",
    "BankCard": {
        "Type": "Visa",
        "Number": "4918914107195005",
        "NameOnCard": "Juan Dela Cruz",
        "ExpirationDate": {
            "Month": "07",
            "Year": "2020"
        },
        "IssueNumber": "2"
    }
}

{
    "@xmlns": "http://www.pcibooking.net/reservation",
    "@schemaVersion": "1.0",
    "BankCard": {
        "Type": "Visa",
        "Number": "4918914107195005",
        "NameOnCard": "Juan Dela Cruz",
        "ExpirationDate": {
            "Month": "07",
            "Year": "2020"
        },
        "IssueNumber": "2",
        "CVV": "123"
    }
}

{
    "code": -1003,
    "message": "Not authorized to access this resource",
    "moreInfo": "Bad or missing authorization data, expected APIKEY or HTTP Basic",
    "errorList": null
}

{
    "code": -160,
    "message": "Uri not found",
    "moreInfo": "Uri to Bank card not found",
    "errorList": null
}

Card Display with OTP Risk Assessment

Start Here

Authentication & General

Capture Cards

Manage Tokens

Use Tokens

Additional Functions

Payments Library

Retrieve Card Details

Query & Retrieve Guide

Error Responses

Parameter Constraints

Parameters

Headers

Path Parameters

Query String

Response

Query & Retrieve Guide

​Error Responses

​Parameter Constraints

​Parameters

​Headers

​Path Parameters

​Query String

​Response

Error Responses

Parameter Constraints

Parameters

Headers

Path Parameters

Query String

Response