Risk Assessment

const response = await fetch(
  'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/validate',
  {
    method: 'POST',
    headers: {
      'Authorization': 'APIKEY your-api-key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      FirstName: 'Juan',
      LastName: 'Dela Cruz',
      Email: 'juan@example.com',
      Phone: '14155551234',
      Address1: '123 Main Street',
      PoseCode: '10001',
      City: 'New York',
      StateProvince: 'NY',
      CountryCode: 'US',
      clientIPAddress: '203.0.113.42'
    })
  }
);

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

import requests

response = requests.post(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/validate',
    headers={
        'Authorization': 'APIKEY your-api-key',
        'Content-Type': 'application/json'
    },
    json={
        'FirstName': 'Juan',
        'LastName': 'Dela Cruz',
        'Email': 'juan@example.com',
        'Phone': '14155551234',
        'Address1': '123 Main Street',
        'PoseCode': '10001',
        'City': 'New York',
        'StateProvince': 'NY',
        'CountryCode': 'US',
        'clientIPAddress': '203.0.113.42'
    }
)

print(response.json())

{
    "RiskLevel": "High",
    "Description": "Mismatch between billing address and credit card issuer country",
    "CountryByIP": "US",
    "IssuerCountry": "HK",
    "IssuerName": "CITIC BANK INTERNATIONAL, LTD.",
    "CardBrand": "VISA",
    "CardType": "CREDIT",
    "CardCategory": "CLASSIC",
    "CountryFromBillingAddress": "US",
    "AnonymousProxyUsed": false
}

{
    "code": -125,
    "message": "Bad input data",
    "moreInfo": "Missing Payer details",
    "errorList": null
}

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

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

POST

api

payments

paycard

{cardToken}

validate

const response = await fetch(
  'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/validate',
  {
    method: 'POST',
    headers: {
      'Authorization': 'APIKEY your-api-key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      FirstName: 'Juan',
      LastName: 'Dela Cruz',
      Email: 'juan@example.com',
      Phone: '14155551234',
      Address1: '123 Main Street',
      PoseCode: '10001',
      City: 'New York',
      StateProvince: 'NY',
      CountryCode: 'US',
      clientIPAddress: '203.0.113.42'
    })
  }
);

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

import requests

response = requests.post(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/validate',
    headers={
        'Authorization': 'APIKEY your-api-key',
        'Content-Type': 'application/json'
    },
    json={
        'FirstName': 'Juan',
        'LastName': 'Dela Cruz',
        'Email': 'juan@example.com',
        'Phone': '14155551234',
        'Address1': '123 Main Street',
        'PoseCode': '10001',
        'City': 'New York',
        'StateProvince': 'NY',
        'CountryCode': 'US',
        'clientIPAddress': '203.0.113.42'
    }
)

print(response.json())

{
    "RiskLevel": "High",
    "Description": "Mismatch between billing address and credit card issuer country",
    "CountryByIP": "US",
    "IssuerCountry": "HK",
    "IssuerName": "CITIC BANK INTERNATIONAL, LTD.",
    "CardBrand": "VISA",
    "CardType": "CREDIT",
    "CardCategory": "CLASSIC",
    "CountryFromBillingAddress": "US",
    "AnonymousProxyUsed": false
}

{
    "code": -125,
    "message": "Bad input data",
    "moreInfo": "Missing Payer details",
    "errorList": null
}

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

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

Risk Assessment Guide

Evaluate transaction risk before processing payments

Performs a fraud risk assessment on a tokenized card by cross-referencing the billing address, card issuer country, and client IP address. Use this before processing a payment to detect mismatches that may indicate fraudulent activity, such as anonymous proxies or country discrepancies.

Error Responses

Code	HTTP Status	Condition
-125	400	Payer details missing (null body)
-125	400	CountryCode is empty
-1003	401	User is not the owner

Parameter Constraints

CountryCode is required and must be a 2-letter ISO country code.
ClientIPAddress, City, and StateProvince are used for geo-validation against the card issuer country.
FirstName and LastName are compared against the card owner name.

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.

Payer Information

FirstName

string

required

Payer’s first name.

LastName

string

required

Payer’s last name.

string

required

Payer’s email address.

Phone

string

required

Payer’s phone number.

Billing Address

Address1

string

required

Primary billing address line.

Address2

string

Secondary billing address line.

Address3

string

Tertiary billing address line.

PoseCode

string

required

Billing postal/ZIP code.

City

string

required

Billing city.

StateProvince

string

required

Billing state or province.

CountryCode

string

required

2-letter country code.

Client Details

clientIPAddress

string

required

Client’s IP address. Both IPv6 and IPv4 formats are supported.

const response = await fetch(
  'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/validate',
  {
    method: 'POST',
    headers: {
      'Authorization': 'APIKEY your-api-key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      FirstName: 'Juan',
      LastName: 'Dela Cruz',
      Email: 'juan@example.com',
      Phone: '14155551234',
      Address1: '123 Main Street',
      PoseCode: '10001',
      City: 'New York',
      StateProvince: 'NY',
      CountryCode: 'US',
      clientIPAddress: '203.0.113.42'
    })
  }
);

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

import requests

response = requests.post(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/validate',
    headers={
        'Authorization': 'APIKEY your-api-key',
        'Content-Type': 'application/json'
    },
    json={
        'FirstName': 'Juan',
        'LastName': 'Dela Cruz',
        'Email': 'juan@example.com',
        'Phone': '14155551234',
        'Address1': '123 Main Street',
        'PoseCode': '10001',
        'City': 'New York',
        'StateProvince': 'NY',
        'CountryCode': 'US',
        'clientIPAddress': '203.0.113.42'
    }
)

print(response.json())

Response

{
    "RiskLevel": "High",
    "Description": "Mismatch between billing address and credit card issuer country",
    "CountryByIP": "US",
    "IssuerCountry": "HK",
    "IssuerName": "CITIC BANK INTERNATIONAL, LTD.",
    "CardBrand": "VISA",
    "CardType": "CREDIT",
    "CardCategory": "CLASSIC",
    "CountryFromBillingAddress": "US",
    "AnonymousProxyUsed": false
}

{
    "code": -125,
    "message": "Bad input data",
    "moreInfo": "Missing Payer details",
    "errorList": null
}

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

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

Retrieve Card Details Get Payment Gateways

Start Here

Authentication & General

Capture Cards

Manage Tokens

Use Tokens

Additional Functions

Payments Library

Risk Assessment Guide

Error Responses

Parameter Constraints

Parameters

Headers

Path Parameters

Payer Information

Billing Address

Client Details

Response

Risk Assessment Guide

​Error Responses

​Parameter Constraints

​Parameters

​Headers

​Path Parameters

​Payer Information

​Billing Address

​Client Details

​Response

Error Responses

Parameter Constraints

Parameters

Headers

Path Parameters

Payer Information

Billing Address

Client Details

Response