const response = await fetch(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/UpdateExpiration',
{
method: 'PUT',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
Year: 2027,
Month: 12
})
}
);
console.log(response.status);
import requests
response = requests.put(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/UpdateExpiration',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'Year': 2027,
'Month': 12
}
)
print(response.status_code)
Expiration date updated successfully. No content returned.
{
"code": -125,
"message": "Bad input data",
"moreInfo": "Expiration year/month error",
"errorList": null
}
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.
Query & Update
Update Card Expiration Date
Update the expiration date on a stored token. Only the expiration date is changed; all other card data remains unchanged.
PUT
/
api
/
payments
/
paycard
/
{cardToken}
/
UpdateExpiration
const response = await fetch(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/UpdateExpiration',
{
method: 'PUT',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
Year: 2027,
Month: 12
})
}
);
console.log(response.status);
import requests
response = requests.put(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/UpdateExpiration',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'Year': 2027,
'Month': 12
}
)
print(response.status_code)
Expiration date updated successfully. No content returned.
{
"code": -125,
"message": "Bad input data",
"moreInfo": "Expiration year/month error",
"errorList": null
}
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.
Update Card Data Guide
Modify expiration dates and creator references on tokens
Error Responses
| Code | HTTP Status | Condition |
|---|---|---|
| -125 | 400 | Year or Month value is not numeric |
| -125 | 400 | Expiration date is in the past |
| -1003 | 401 | The token does not exist, was deleted, or you are not its owner. See Token Not Found or Not Accessible. |
| -150 | 500 | Update transaction failed (rollback) |
Parameter Constraints
| Parameter | Type | Required | Constraints |
|---|---|---|---|
| Month | integer | Yes | Valid range 1 to 12 |
| Year | integer | Yes | Must be greater than or equal to the current UTC year |
This endpoint is rate limited. See Rate Limits.
Parameters
Authentication
API key only. This endpoint does not accept access tokens or session tokens.string
required
Your API key prefixed with
APIKEY. Example: APIKEY your-api-key. The x-pcibooking-api-key header is also accepted. See the Authentication guide.Path Parameters
string
required
The token ID as returned by one of the tokenization methods. For example,
2821a46d80e14d1b96a7f18f1b81926d.Request Body
integer
required
New expiration year. Format YYYY.
integer
required
New expiration month. Format MM.
const response = await fetch(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/UpdateExpiration',
{
method: 'PUT',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
Year: 2027,
Month: 12
})
}
);
console.log(response.status);
import requests
response = requests.put(
'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/UpdateExpiration',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'Year': 2027,
'Month': 12
}
)
print(response.status_code)
A reissued card with a new expiration date usually also has a new CVV. Check with the card owner whether the stored CVV needs to be updated as well.
Response
200 - Expiration updated successfully. Empty response body.Expiration date updated successfully. No content returned.
{
"code": -125,
"message": "Bad input data",
"moreInfo": "Expiration year/month error",
"errorList": null
}
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.