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
}
{
"code": -1003,
"message": "Not authorized to access this resource",
"moreInfo": "Bad or missing authorization data, expected APIKEY",
"errorList": null
}
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
}
{
"code": -1003,
"message": "Not authorized to access this resource",
"moreInfo": "Bad or missing authorization data, expected APIKEY",
"errorList": null
}
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 | User is not the owner of this token |
| -160 | 404 | Card not found for the given token |
| -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.
Parameters
Headers
string
required
Your API key prefixed with
APIKEY. Example: APIKEY your-api-key. 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
}
{
"code": -1003,
"message": "Not authorized to access this resource",
"moreInfo": "Bad or missing authorization data, expected APIKEY",
"errorList": null
}