Associate with Customer

const response = await fetch(
  'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/user/booker-user-123',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'APIKEY your-api-key'
    }
  }
);

console.log(response.status);

import requests

response = requests.put(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/user/booker-user-123',
    headers={'Authorization': 'APIKEY your-api-key'}
)

print(response.status_code)

Empty response body. Association created successfully.

{
    "code": -125,
    "message": "Bad input data",
    "moreInfo": "Could not find a valid user",
    "errorList": null
}

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

PUT

api

payments

paycard

{cardToken}

user

{userID}

const response = await fetch(
  'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/user/booker-user-123',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'APIKEY your-api-key'
    }
  }
);

console.log(response.status);

import requests

response = requests.put(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/user/booker-user-123',
    headers={'Authorization': 'APIKEY your-api-key'}
)

print(response.status_code)

Empty response body. Association created successfully.

{
    "code": -125,
    "message": "Bad input data",
    "moreInfo": "Could not find a valid user",
    "errorList": null
}

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

Third-Party Permissions Guide

Learn how to share tokens with other PCI Booking customers

Associates a token with another PCI Booking customer (sub-account), granting them permission to use the token in their own API calls. This is useful in marketplace or platform scenarios where multiple parties need access to the same stored card.

Error Responses

Code	HTTP Status	Condition
-1003	401	User is not the owner
-179	400	userId is empty

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.

userID

string

required

The user ID of a PCI Booking customer (“Booker”) that the token should be associated with. You will need to collect this userID from the booker you wish to associate the card with.

const response = await fetch(
  'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/user/booker-user-123',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'APIKEY your-api-key'
    }
  }
);

console.log(response.status);

import requests

response = requests.put(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/user/booker-user-123',
    headers={'Authorization': 'APIKEY your-api-key'}
)

print(response.status_code)

Response

200 - Association created. Empty response body.

Empty response body. Association created successfully.

{
    "code": -125,
    "message": "Bad input data",
    "moreInfo": "Could not find a valid user",
    "errorList": null
}

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

Delete 3D Secure Data Disassociate from Customer

Start Here

Authentication & General

Capture Cards

Manage Tokens

Use Tokens

Additional Functions

Payments Library

Associate with Customer

Third-Party Permissions Guide

Error Responses

Parameters

Headers

Path Parameters

Response

Third-Party Permissions Guide

​Error Responses

​Parameters

​Headers

​Path Parameters

​Response

Error Responses

Parameters

Headers

Path Parameters

Response