Release Notes for 31 March 2023

New changes to the GPS Cards API for the week ending 31st March 2023.

New Get Card Stock endpoint

Endpoint: /products/{{product-id}}/stock
A new endpoint has been added that enables customers to check the current levels of available card stock for a specified product id.

You can retrieve a product's card stock by making a GET request to the Get Card Stock endpoint. For example:

{{base-url}}/products/{{product-id}}/stock

A successful response will return an HTTP 200 response code and the currently available stock for the card and the product id. Below is an example response:

{
    "productId": 10023,
    "availableStock": 1034
}

๐Ÿ‘

Documentation/API Explorer

New fields added to Convert Card endpoint

Two new fields have been added to the Convert Card endpoint, enabling users to either move the expiry date from the original card or to be able to set a new expiry date.

  • The moveExpiryDate field, if set to true. will move the expiry date to the new card.
  • The newExpiryDate field enables you to set a new expiry date in a YYYY-MM format.

๐Ÿ“˜

Note

The moveExpiryDate and newExpiryDate fields cannot be used as part of the same API call.

See the following examples of the Convert Card body that includes the new fields.

{
    "cardType": "Physical",
    "moveExpiryDate": true
}
{
  "cardType": "Physical",
  "newExpiryDate": "2025-05"
}

๐Ÿ‘

Documentation/API Explorer