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
Authentication
API key, access token or session token. Use the API key for server-to-server calls, and an access token or a session token when the call is made from a browser. Send one of the three.string
Your API key prefixed with
APIKEY. Example: APIKEY your-api-key. The x-pcibooking-api-key header is also accepted. See the Authentication guide.string
Generated on your side. Single use, and valid for up to 72 hours. How to generate.
string
Returned by an API call. Valid for 5 minutes, and can be used more than once within that time. How to generate.
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.