const response = await fetch(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/clearcvv',
{
method: 'POST',
headers: {
'Authorization': 'APIKEY your-api-key'
}
}
);
console.log(response.status);
import requests
response = requests.post(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/clearcvv',
headers={'Authorization': 'APIKEY your-api-key'}
)
print(response.status_code)
Empty response body. CVV cleared successfully.
Empty response body.
Authentication failed: the API key, session token or access token is missing or was not accepted.
See "Authentication and Permission Failures" on the Error Handling page.
CVV Management
Clear CVV
Immediately delete the CVV stored on a token.
POST
/
api
/
payments
/
paycard
/
{cardToken}
/
op
/
clearcvv
const response = await fetch(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/clearcvv',
{
method: 'POST',
headers: {
'Authorization': 'APIKEY your-api-key'
}
}
);
console.log(response.status);
import requests
response = requests.post(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/clearcvv',
headers={'Authorization': 'APIKEY your-api-key'}
)
print(response.status_code)
Empty response body. CVV cleared successfully.
Empty response body.
Authentication failed: the API key, session token or access token is missing or was not accepted.
See "Authentication and Permission Failures" on the Error Handling page.
Immediately removes the CVV from a token. The card data itself is not affected.
CVV Management Guide
Control how long CVV data is retained and who can use it
Error Responses
| Code | HTTP Status | Condition |
|---|---|---|
| -1003 | 401 | The token does not exist, was deleted, or you are not its owner. See Token Not Found or Not Accessible. |
| -125 | 400 | Card data could not be read for a token you own (when postponeUntilDate is provided) |
| -168 | 409 | Card has no CVV to clear (when postponeUntilDate is provided) |
| -179 | 400 | Failed to update CVV retention date |
| -150 | 500 | Could not clear CVV (immediate clear operation) |
Parameter Constraints
| Parameter | Type | Required | Constraints |
|---|---|---|---|
| postponeUntilDate | DateTime | No | Optional. When provided, defers CVV clearing until the specified date instead of clearing immediately |
| Auth | string | Yes | Basic, ApiKey, AccessToken, or SessionToken |
Parameters
Headers
string
required
Your API key prefixed with
APIKEY. Example: APIKEY your-api-key. For server-to-server calls.Alternative: Browser-Side Authentication
Alternative: Browser-Side Authentication
This endpoint also accepts token-based authentication via query parameters:
If multiple methods are provided, precedence: Session Token > Access Token > API Key.
| Method | Details |
|---|---|
| Access Token (recommended) | accessToken query param. How to generate. |
| Session Token | sessionToken query param. How to generate. Valid for 5 minutes. |
Path Parameters
string
required
The token ID as returned by one of the tokenization methods.
const response = await fetch(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/clearcvv',
{
method: 'POST',
headers: {
'Authorization': 'APIKEY your-api-key'
}
}
);
console.log(response.status);
import requests
response = requests.post(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/clearcvv',
headers={'Authorization': 'APIKEY your-api-key'}
)
print(response.status_code)
Response
200 - CVV cleared. Empty response body.Empty response body. CVV cleared successfully.
Empty response body.
Authentication failed: the API key, session token or access token is missing or was not accepted.
See "Authentication and Permission Failures" on the Error Handling page.