August 8, 2024

Multiple Updates

Adding New Fields to Card Schema for PIN Management

Beginning August 12th (Monday), we will be deploying a change to add new fields to the Card Schema. Two new fields will be added:

  1. pin_status: This new field indicates if a card is blocked due a PIN status issue (e.g. excessive incorrect attempts). Currently supported values are: OK, BLOCKED, NOT_SET
  2. pending_commands[]: Applicable only to cards issued in markets supporting offline PINs. This new array indicates if there are offline PIN changes pending card interaction with an offline PIN terminal.

Lithic Dashboard

In sync with the API updates, we will be deploying a change to add new fields to the card details page of the Lithic dashboard indicating applicable PIN status and pending command information. Two new fields will be added:

  1. PIN Status: This new dashboard field indicates if a card is blocked due a PIN status issue.
  2. Pending Commands: Applicable only to cards issued in markets supporting offline PINs. This field indicates if there are offline PIN changes pending card interaction with an offline PIN terminal.

Settlement Summary

Beginning August 12th (Monday), several changes will be deployed to give customers better communication regarding the completeness of their settlement summary information:

Settlement Summary Completeness Flag

A new boolean field will be added to the Settlement Summary Schema:

  • is_complete: This field indicates that all data expected on the given report date is available.

Settlement Summary Completeness Webhook

When a settlement summary becomes complete, this will be a new update event which triggers the settlement_report.updatedwebhook. With the inclusion of the new settlement summary completeness flag, customers will now be updated via webhook when all expected settlement summary data is complete.


If you have any questions or concerns about this change, please reach out to [email protected].