Update Card Expiration Date

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
}

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

Updates the expiration date on a stored token without affecting any other card data. Use this when a cardholder’s card has been renewed with a new expiration date and you need to keep the token current.

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	string	Yes	Numeric string, valid range 1 to 12
Year	string	Yes	Numeric string, must be greater than or equal to the current UTC year

This endpoint is rate limited.

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. For example, 2821a46d80e14d1b96a7f18f1b81926d.

Request Body

Year

integer

required

New expiration year. Format YYYY.

Month

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)

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
}

Retrieve Metadata Update Creator Reference

Start Here

Authentication & General

Capture Cards

Manage Tokens

Use Tokens

Additional Functions

Payments Library

Update Card Expiration Date

Update Card Data Guide

Error Responses

Parameter Constraints

Parameters

Headers

Path Parameters

Request Body

Response

Update Card Data Guide

​Error Responses

​Parameter Constraints

​Parameters

​Headers

​Path Parameters

​Request Body

​Response

Error Responses

Parameter Constraints

Parameters

Headers

Path Parameters

Request Body

Response