Network Tokenize from Existing Token

const params = new URLSearchParams({
  cardUri: 'https://service.pcibooking.net/api/payments/paycard/555fd7b49f134b42a5dbe4d576b2e527',
  deleteExisting: 'false',
  loc: 'IE'
});

const response = await fetch(`https://service.pcibooking.net/api/networkToken/token?${params}`, {
  method: 'POST',
  headers: {
    'Authorization': 'APIKEY your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    ConsumerLanguage: 'en',
    CardHolder: {
      FirstName: 'John',
      LastName: 'Doe',
      Email: 'john.doe@example.com',
      ClientIPAddress: '203.0.113.42',
      CountryCode: 'US'
    },
    DeviceScore: 5,
    AccountScore: 5
  })
});

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

import requests

response = requests.post(
    'https://service.pcibooking.net/api/networkToken/token',
    headers={
        'Authorization': 'APIKEY your-api-key',
        'Content-Type': 'application/json'
    },
    params={
        'cardUri': 'https://service.pcibooking.net/api/payments/paycard/555fd7b49f134b42a5dbe4d576b2e527',
        'deleteExisting': 'false',
        'loc': 'IE'
    },
    json={
        'ConsumerLanguage': 'en',
        'CardHolder': {
            'FirstName': 'John',
            'LastName': 'Doe',
            'Email': 'john.doe@example.com',
            'ClientIPAddress': '203.0.113.42',
            'CountryCode': 'US'
        },
        'DeviceScore': 5,
        'AccountScore': 5
    }
)

print(response.json())

{
    "ResultCode": "Success",
    "Brand": "MasterCard",
    "TokenId": "5412750012003478",
    "TokenizedCard": {
        "Number": "541275******3478",
        "ExpirationMonth": 6,
        "ExpirationYear": 2029
    }
}

{
    "code": -160,
    "message": "Resource not found",
    "moreInfo": "Invalid Card Uri value",
    "errorList": null
}

{
    "code": -1003,
    "message": "Not authorized to access this resource",
    "moreInfo": "User is not the owner of this bank card",
    "errorList": null
}

POST

api

networkToken

token

const params = new URLSearchParams({
  cardUri: 'https://service.pcibooking.net/api/payments/paycard/555fd7b49f134b42a5dbe4d576b2e527',
  deleteExisting: 'false',
  loc: 'IE'
});

const response = await fetch(`https://service.pcibooking.net/api/networkToken/token?${params}`, {
  method: 'POST',
  headers: {
    'Authorization': 'APIKEY your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    ConsumerLanguage: 'en',
    CardHolder: {
      FirstName: 'John',
      LastName: 'Doe',
      Email: 'john.doe@example.com',
      ClientIPAddress: '203.0.113.42',
      CountryCode: 'US'
    },
    DeviceScore: 5,
    AccountScore: 5
  })
});

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

import requests

response = requests.post(
    'https://service.pcibooking.net/api/networkToken/token',
    headers={
        'Authorization': 'APIKEY your-api-key',
        'Content-Type': 'application/json'
    },
    params={
        'cardUri': 'https://service.pcibooking.net/api/payments/paycard/555fd7b49f134b42a5dbe4d576b2e527',
        'deleteExisting': 'false',
        'loc': 'IE'
    },
    json={
        'ConsumerLanguage': 'en',
        'CardHolder': {
            'FirstName': 'John',
            'LastName': 'Doe',
            'Email': 'john.doe@example.com',
            'ClientIPAddress': '203.0.113.42',
            'CountryCode': 'US'
        },
        'DeviceScore': 5,
        'AccountScore': 5
    }
)

print(response.json())

{
    "ResultCode": "Success",
    "Brand": "MasterCard",
    "TokenId": "5412750012003478",
    "TokenizedCard": {
        "Number": "541275******3478",
        "ExpirationMonth": 6,
        "ExpirationYear": 2029
    }
}

{
    "code": -160,
    "message": "Resource not found",
    "moreInfo": "Invalid Card Uri value",
    "errorList": null
}

{
    "code": -1003,
    "message": "Not authorized to access this resource",
    "moreInfo": "User is not the owner of this bank card",
    "errorList": null
}

Network Tokenization Guide

Create and manage network tokens for stored cards

Network-tokenizes a card that is already stored as a PCI Booking token. The card data is retrieved from the existing token, submitted to the card network, and the resulting network token is stored as a new PCI Booking token. Optionally, the original token can be deleted after successful network tokenization by setting deleteExisting=true.

Error Responses

Code	HTTP Status	Condition
`-1003`	`401`	API key is missing or invalid.
`-1003`	`401`	Authenticated user does not own the specified card token.
`-160`	`404`	The `cardUri` does not resolve to a valid stored card.
`-125`	`400`	Request body validation failed.
`-150`	`500`	Network tokenization failed.

Parameters

Headers

string

required

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

Query String

string

required

The full URI of the existing PCI Booking token to network-tokenize (e.g. https://service.pcibooking.net/api/payments/paycard/555fd7b49f134b42a5dbe4d576b2e527).

boolean

default:"false"

When true, the original PCI Booking token is deleted after successful network tokenization.

string

Token storage region for the new network token. One of: US, IN, AU, JP, CA, IE, GB, BR. If omitted, uses the account default.

Request Body

The request body contains the same TokenizationRequest fields as Network Tokenize a Card, excluding the Card object (since card data comes from the existing token).

string

default:"en"

ISO 639-1 language code (exactly 2 characters).

object

Cardholder details required by the card network. See Network Tokenize a Card for the full field reference.

integer

default:"5"

Device trust score (1-5).

integer

default:"5"

Account trust score (1-5).

number

Device latitude (-90 to 90).

number

Device longitude (-180 to 180).

string

Device IP address.

string

Source of the card data.

const params = new URLSearchParams({
  cardUri: 'https://service.pcibooking.net/api/payments/paycard/555fd7b49f134b42a5dbe4d576b2e527',
  deleteExisting: 'false',
  loc: 'IE'
});

const response = await fetch(`https://service.pcibooking.net/api/networkToken/token?${params}`, {
  method: 'POST',
  headers: {
    'Authorization': 'APIKEY your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    ConsumerLanguage: 'en',
    CardHolder: {
      FirstName: 'John',
      LastName: 'Doe',
      Email: 'john.doe@example.com',
      ClientIPAddress: '203.0.113.42',
      CountryCode: 'US'
    },
    DeviceScore: 5,
    AccountScore: 5
  })
});

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

import requests

response = requests.post(
    'https://service.pcibooking.net/api/networkToken/token',
    headers={
        'Authorization': 'APIKEY your-api-key',
        'Content-Type': 'application/json'
    },
    params={
        'cardUri': 'https://service.pcibooking.net/api/payments/paycard/555fd7b49f134b42a5dbe4d576b2e527',
        'deleteExisting': 'false',
        'loc': 'IE'
    },
    json={
        'ConsumerLanguage': 'en',
        'CardHolder': {
            'FirstName': 'John',
            'LastName': 'Doe',
            'Email': 'john.doe@example.com',
            'ClientIPAddress': '203.0.113.42',
            'CountryCode': 'US'
        },
        'DeviceScore': 5,
        'AccountScore': 5
    }
)

print(response.json())

Response

201 - Network token created. The Location header contains the new PCI Booking token URI. If deleteExisting=true was set, the original token is deleted.

{
    "ResultCode": "Success",
    "Brand": "MasterCard",
    "TokenId": "5412750012003478",
    "TokenizedCard": {
        "Number": "541275******3478",
        "ExpirationMonth": 6,
        "ExpirationYear": 2029
    }
}

{
    "code": -160,
    "message": "Resource not found",
    "moreInfo": "Invalid Card Uri value",
    "errorList": null
}

{
    "code": -1003,
    "message": "Not authorized to access this resource",
    "moreInfo": "User is not the owner of this bank card",
    "errorList": null
}

Start Here

Authentication & General

Capture Cards

Manage Tokens

Use Tokens

Additional Functions

Payments Library

Network Tokenize from Existing Token

Network Tokenization Guide

Error Responses

Parameters

Headers

Query String

Request Body

Response

Network Tokenization Guide

​Error Responses

​Parameters

​Headers

​Query String

​Request Body

​Response

Error Responses

Parameters

Headers

Query String

Request Body

Response