Network Tokenize a Card

const response = await fetch('https://service.pcibooking.net/api/networkToken?loc=IE', {
  method: 'POST',
  headers: {
    'Authorization': 'APIKEY your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    Card: {
      Number: '4111111111111111',
      ExpirationYear: 2028,
      ExpirationMonth: 12,
      SecurityCode: '123'
    },
    TokenizationRequest: {
      ConsumerLanguage: 'en',
      CardHolder: {
        FirstName: 'John',
        LastName: 'Doe',
        Email: 'john.doe@example.com',
        ClientIPAddress: '203.0.113.42',
        CountryCode: 'US',
        Address1: '123 Main St',
        City: 'New York',
        StateProvince: 'NY',
        PostCode: '10001'
      },
      DeviceScore: 5,
      AccountScore: 5
    }
  })
});

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

import requests

response = requests.post(
    'https://service.pcibooking.net/api/networkToken',
    headers={
        'Authorization': 'APIKEY your-api-key',
        'Content-Type': 'application/json'
    },
    params={
        'loc': 'IE'
    },
    json={
        'Card': {
            'Number': '4111111111111111',
            'ExpirationYear': 2028,
            'ExpirationMonth': 12,
            'SecurityCode': '123'
        },
        'TokenizationRequest': {
            'ConsumerLanguage': 'en',
            'CardHolder': {
                'FirstName': 'John',
                'LastName': 'Doe',
                'Email': 'john.doe@example.com',
                'ClientIPAddress': '203.0.113.42',
                'CountryCode': 'US',
                'Address1': '123 Main St',
                'City': 'New York',
                'StateProvince': 'NY',
                'PostCode': '10001'
            },
            'DeviceScore': 5,
            'AccountScore': 5
        }
    }
)

print(response.json())

{
    "ResultCode": "Success",
    "Brand": "Visa",
    "TokenId": "4895370012003478",
    "TokenizedCard": {
        "Number": "489537******3478",
        "ExpirationMonth": 12,
        "ExpirationYear": 2028
    }
}

{
    "code": -125,
    "message": "Bad input data",
    "moreInfo": "...",
    "errorList": null
}

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

POST

api

networkToken

const response = await fetch('https://service.pcibooking.net/api/networkToken?loc=IE', {
  method: 'POST',
  headers: {
    'Authorization': 'APIKEY your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    Card: {
      Number: '4111111111111111',
      ExpirationYear: 2028,
      ExpirationMonth: 12,
      SecurityCode: '123'
    },
    TokenizationRequest: {
      ConsumerLanguage: 'en',
      CardHolder: {
        FirstName: 'John',
        LastName: 'Doe',
        Email: 'john.doe@example.com',
        ClientIPAddress: '203.0.113.42',
        CountryCode: 'US',
        Address1: '123 Main St',
        City: 'New York',
        StateProvince: 'NY',
        PostCode: '10001'
      },
      DeviceScore: 5,
      AccountScore: 5
    }
  })
});

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

import requests

response = requests.post(
    'https://service.pcibooking.net/api/networkToken',
    headers={
        'Authorization': 'APIKEY your-api-key',
        'Content-Type': 'application/json'
    },
    params={
        'loc': 'IE'
    },
    json={
        'Card': {
            'Number': '4111111111111111',
            'ExpirationYear': 2028,
            'ExpirationMonth': 12,
            'SecurityCode': '123'
        },
        'TokenizationRequest': {
            'ConsumerLanguage': 'en',
            'CardHolder': {
                'FirstName': 'John',
                'LastName': 'Doe',
                'Email': 'john.doe@example.com',
                'ClientIPAddress': '203.0.113.42',
                'CountryCode': 'US',
                'Address1': '123 Main St',
                'City': 'New York',
                'StateProvince': 'NY',
                'PostCode': '10001'
            },
            'DeviceScore': 5,
            'AccountScore': 5
        }
    }
)

print(response.json())

{
    "ResultCode": "Success",
    "Brand": "Visa",
    "TokenId": "4895370012003478",
    "TokenizedCard": {
        "Number": "489537******3478",
        "ExpirationMonth": 12,
        "ExpirationYear": 2028
    }
}

{
    "code": -125,
    "message": "Bad input data",
    "moreInfo": "...",
    "errorList": null
}

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

Submits raw card details to the card network (Visa, Mastercard, or Amex) for network tokenization. On success, the resulting network token is stored as a PCI Booking token and the token URI is returned in the Location header.

Network tokenization replaces the real card number with a network-issued token that is bound to your merchant. The network token receives automatic card-on-file updates from the issuer, reducing declines from expired or replaced cards.

Error Responses

Code	HTTP Status	Condition
`-1003`	`401`	API key is missing or invalid.
`-125`	`400`	Request body validation failed (missing required fields, invalid card number, etc.).
`-150`	`500`	Network tokenization failed (card cannot be network-tokenized, or the network returned an error).

Parameter Constraints

Card.Number: Valid card number (Visa, Mastercard, or Amex).
Card.ExpirationMonth: Range 1-12.
Card.SecurityCode: 3-4 digits (regex ^\d{3,4}$).
TokenizationRequest.ConsumerLanguage: Exactly 2 characters, ISO 639-1 language code. Defaults to en.
TokenizationRequest.CardHolder.CountryCode: Exactly 2 uppercase letters (ISO 3166-1 alpha-2).
TokenizationRequest.DeviceScore: Range 1-5, defaults to 5.
TokenizationRequest.AccountScore: Range 1-5, defaults to 5.
TokenizationRequest.DeviceLocationLat: Range -90 to 90.
TokenizationRequest.DeviceLocationLon: Range -180 to 180.

Parameters

Headers

Authorization

string

required

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

Query String

loc

string

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

Request Body

Card

object

required

The card details to network-tokenize.

Show Properties

Card.Number

string

required

The full card number.

Card.ExpirationYear

integer

required

Four-digit expiration year (e.g. 2028).

Card.ExpirationMonth

integer

required

Expiration month (1-12).

Card.SecurityCode

string

The card CVV (3-4 digits).

TokenizationRequest

object

required

Network tokenization parameters including cardholder and device information.

Show Properties

TokenizationRequest.ConsumerLanguage

string

default:"en"

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

TokenizationRequest.CardHolder

object

Cardholder details required by the card network.

Show Properties

TokenizationRequest.CardHolder.FirstName

string

required

Cardholder first name.

TokenizationRequest.CardHolder.LastName

string

required

Cardholder last name.

TokenizationRequest.CardHolder.Email

string

Cardholder email address.

TokenizationRequest.CardHolder.Phone

string

Cardholder phone number.

TokenizationRequest.CardHolder.ClientIPAddress

string

required

Cardholder’s IP address.

TokenizationRequest.CardHolder.CountryCode

string

required

ISO 3166-1 alpha-2 country code (e.g. US, GB).

TokenizationRequest.CardHolder.Address1

string

Billing address line 1.

TokenizationRequest.CardHolder.City

string

Billing city.

TokenizationRequest.CardHolder.StateProvince

string

Billing state or province.

TokenizationRequest.CardHolder.PostCode

string

Billing postal code.

TokenizationRequest.DeviceScore

integer

default:"5"

Device trust score (1-5). Higher values indicate higher trust.

TokenizationRequest.AccountScore

integer

default:"5"

Account trust score (1-5). Higher values indicate higher trust.

TokenizationRequest.DeviceLocationLat

number

Device latitude (-90 to 90).

TokenizationRequest.DeviceLocationLon

number

Device longitude (-180 to 180).

TokenizationRequest.DeviceIpAddress

string

Device IP address (if different from cardholder IP).

TokenizationRequest.CardSource

string

Source of the card data (network-specific enum).

const response = await fetch('https://service.pcibooking.net/api/networkToken?loc=IE', {
  method: 'POST',
  headers: {
    'Authorization': 'APIKEY your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    Card: {
      Number: '4111111111111111',
      ExpirationYear: 2028,
      ExpirationMonth: 12,
      SecurityCode: '123'
    },
    TokenizationRequest: {
      ConsumerLanguage: 'en',
      CardHolder: {
        FirstName: 'John',
        LastName: 'Doe',
        Email: 'john.doe@example.com',
        ClientIPAddress: '203.0.113.42',
        CountryCode: 'US',
        Address1: '123 Main St',
        City: 'New York',
        StateProvince: 'NY',
        PostCode: '10001'
      },
      DeviceScore: 5,
      AccountScore: 5
    }
  })
});

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

import requests

response = requests.post(
    'https://service.pcibooking.net/api/networkToken',
    headers={
        'Authorization': 'APIKEY your-api-key',
        'Content-Type': 'application/json'
    },
    params={
        'loc': 'IE'
    },
    json={
        'Card': {
            'Number': '4111111111111111',
            'ExpirationYear': 2028,
            'ExpirationMonth': 12,
            'SecurityCode': '123'
        },
        'TokenizationRequest': {
            'ConsumerLanguage': 'en',
            'CardHolder': {
                'FirstName': 'John',
                'LastName': 'Doe',
                'Email': 'john.doe@example.com',
                'ClientIPAddress': '203.0.113.42',
                'CountryCode': 'US',
                'Address1': '123 Main St',
                'City': 'New York',
                'StateProvince': 'NY',
                'PostCode': '10001'
            },
            'DeviceScore': 5,
            'AccountScore': 5
        }
    }
)

print(response.json())

Response

201 - Network token created. The Location header contains the PCI Booking token URI for the network-tokenized card.

{
    "ResultCode": "Success",
    "Brand": "Visa",
    "TokenId": "4895370012003478",
    "TokenizedCard": {
        "Number": "489537******3478",
        "ExpirationMonth": 12,
        "ExpirationYear": 2028
    }
}

{
    "code": -125,
    "message": "Bad input data",
    "moreInfo": "...",
    "errorList": null
}

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

Receive Result Notification Network Tokenize from Token

Start Here

Authentication & General

Capture Cards

Manage Tokens

Use Tokens

Additional Functions

Payments Library

Network Tokenize a Card

Error Responses

Parameter Constraints

Parameters

Headers

Query String

Request Body

Response

​Error Responses

​Parameter Constraints

​Parameters

​Headers

​Query String

​Request Body

​Response

Error Responses

Parameter Constraints

Parameters

Headers

Query String

Request Body

Response