Card updated
This event occurs when a card's information or status changes. Endpoints that generate this event include Update card information, Activate physical card, Update card status and Reissue card. For more information, see the Card lifecycle and statuses guide.
Type: object
Domain: cards
Event: update
Version: 1
account_id required
Title: User's Pismo account ID
Description: Pismo account ID
Type: integer
Example:
12345678
activation_date required
Title: Card activation date and time
Type: string or null
Format: date-time
Example:
2022-07-22T20:20:39Z
card_hash required
Title: Hashed PAN
Description: Hashed PAN. Field exists when the PCI data is created.
Type: string or null
Example:
0fsdf0sdf9sdf0sdf0sd0fsdn09vsdj0c9sjdcsdcs0d9c==
card_id required
Title: Pismo card ID
Description: Pismo card ID
Type: integer
Example:
12345678
card_last_four_numbers required
Title: Last 4 PAN numbers
Description: Last 4 PAN (primary account number) numbers. Field exists when the PCI data is created.
Type: string or null
Example:
1234
card_name required
Title: Card display name
Description: Card display name
Type: string
Example:
Warren Pease
card_previous_status required
Title: Card's previous status
Description: Card's previous status
Type: string
Must be one of the following:
CREATED
UMBOUND
NORMAL
REISSUED
BLOCKED
PENDING
WARNING
INOPERATIVE
LOST
ROBBED
CANCELED
FRAUD
DAMAGED
EXPIRED
DELETED
BROKEN
THEFT
DEFECT
card_printed_name required
Title: Cardholder's name printed on card
Description: Card printed name. Physical (plastic or metal) cards only.
Type: string or null
Example:
Holly Wood
card_status required
Title: Card status
Description: Card's status
Type: string
Must be one of the following:
CREATED
UMBOUND
NORMAL
REISSUED
BLOCKED
PENDING
WARNING
INOPERATIVE
LOST
ROBBED
CANCELED
FRAUD
DAMAGED
EXPIRED
DELETED
BROKEN
THEFT
DEFECT
card_type required
Title: Card type
Description: Card type
Type: string
Must be one of the following:
PLASTIC
VIRTUAL
RECURRING
TEMPORARY
contactless_enabled required
Title: Contactless card flag
Description: Card can make transactions using contactless entry mode. Default istrue
Type: boolean
embossed required
Title: Embosser file
Description: Name of file containing cards to be embossed sent to embosser.
Type: string or null
Example:
/trackfile
expiration_date required
Title: Card expiration date and time
Description: Card expiration date and time in RFC3339 format.
Type: string or null
Format: date-time
Example:
2025-10-08T00:00:00Z
issuing_date required
Title: Card issued date and time
Description: Card issued date and time in RFC3339 format.
Type: string or null
Format: date-time
Example:
2018-11-13T20:20:39Z
operation_type required
Title: Operation responsible for changing the card status
Type: string or null
program_id required
Title: Card's Pismo program ID
Description: Program ID.
Type: integer or null
Example:
12345678
reason required
Title: Failure reason
Description: Failure reason
Type: string or null
Example:
Reason of failure
status required
Title: Event status
Description: Event status
Type: string
transaction_limit required
Title: Maximum amount allowed per transaction
Description: Transaction limit for virtual cards
Type: number or null
Example:
1000.0
abu_enabled
Title: Automatic Billing Update (ABU) flag
Description: Must card number be sent to the Mastercard Automatic Billing Updater service. Default istrue
. Mastercard only.
Type: boolean
bulk_id
Title: Bulk/batch ID
Description: Not null if card was created as part of a noname bulk/batch process
Type: string or null
card_bin
Title: Card BIN
Description: Card BIN (bank identification number)
Type: string or null
Example:
599999
card_brand
Title: Card brand
Description: Card brand, such asVISA
Type: string or null
Must be one of the following:
PRIVATE
MASTERCARD
VISA
customer_id
Title: Pismo customer ID
Description: Pismo customer ID
Type: integer
Example:
100602614
cvv_next_rotation_date
Title: Next CVV rotation date and time.
Description: Scheduled date and time, in RFC3339 format, to change the CVV2/CVC2 value. Virtual cards only.
Type: string or null
Format: date-time
Example:
2021-03-01T18:45:00Z
cvv_rotation_type
Title: CVV rotation method
Description: CVV/CVC2 value rotation method. Virtual cards only.
Type: string or null
Must be one of the following:
MANUAL
AUTOMATIC
dual_message_debit
Title: Dual message debit card flag
Description: Indicates if card is DMC. Default is false
Type: boolean or null
embossing_custom_fields
Title: Personalized information sent with emboss
Description: Any customer-provided information for embosser such as tracking number or embossing instructions
Type: string or null
Example:
Cards should be metal, not plastic
external_id
Title: Personalized external information
Description: Customer created ID for externally tracking card
Type: string or null
Example:
AFEF234234FSDF
metadata
Title: Customer metadata.
Description: Customer provided information. No business rule validation is done.
Type: object or null
Example:{ "customer-data": { "my": "value", "my-custom-business-label": "label", "score": "123" } }
migration_id
Title: Migration ID
Description: CMigration ID (if migrated)
Type: string or null
Example:
AF12341234-EF234234FSDF
mode
Title: Card mode
Description: Card mode, such asCREDIT
.
Type: string or null
Must be one of the following:
CREDIT
DEBIT
MULTIPLE
COMBO
reissued_card_block
Title: Information to replace the card in the automatic billing update flow
Description: Indicates if the card number is a replacement account to Mastercard Automatic Billing Updater service. Available only for Mastercard in Reissue Card Flow
Type: boolean or null
reissued_card_id
Title: Identification of the card from which it originated
Description: If the creation of a card is based on the reissued flow, this field will not be null
Type: integer or null
Example:
12345678
new_card_id
Title: Identification of the card from the new reissued card
Description: If the updating of a card is based on the reissued flow, this field will not be null
Type: integer or null
Example:
12345678
update_tokens
Title: Information to replace the card in the tokenization pan update flow
Description: Indicates if the previews card have to have all tokens migrated to the new reissued card. Available only for vts/mdes tokenization program
Type: boolean or null
template_id
Title: Template ID
Description: Template ID - Not null if card creation based on template. Templates are used to implement the BIN override feature. For more information, see the BIN override documentation in the Cards overview guide. To create a template, you need to open a Pismo Service Desk request. The ticket type should be Settings.
Type: string or null
Example:
14a23976-db8c-4f1e-a19c-f0ec79d810r4
password_tries
Title: Password tries
Description: Amount of times the password was tried.
Type: integer or null
Example:
1
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"title": "Card updated",
"description": "This event occurs when a card's information or status changes. Endpoints that generate this event include <a href='https://developers.pismo.io/pismo-docs/reference/patch-v2-card'>Update card information</a>, <a href='https://developers.pismo.io/pismo-docs/reference/put-v1-card-activate'>Activate physical card</a>, <a href='https://developers.pismo.io/pismo-docs/reference/put-v1-card-status'>Update card status</a> and <a href='https://developers.pismo.io/pismo-docs/reference/post-v1-card-reissue'>Reissue card</a>. For more information, see the <a href='https://developers.pismo.io/pismo-docs/docs/card-lifecycle-and-statuses'>Card lifecycle and statuses</a> guide.",
"examples": [
{
"abu_enabled": true,
"account_id": 8675309,
"bulk_id": null,
"card_bin": "231038",
"card_brand": "MASTERCARD",
"card_hash": "Glc34oW6YsIbGLYLphiKgkrKh7y5tPTbGVF46ok/+fPC95yGXs1xua8GRhXvWj6Q8dV963OxPPz83v9czJBrWg==",
"card_id": 10895630,
"card_last_four_numbers": "2941",
"card_name": "Card 5a7ac310f6bb381e2911b64c34913982",
"card_printed_name": "guilhermeissuing",
"card_status": "NORMAL",
"card_type": "VIRTUAL",
"contactless_enabled": true,
"customer_id": 103625634,
"cvv_next_rotation_date": "2023-06-30T03:20:41Z",
"cvv_rotation_type": "AUTOMATIC",
"dual_message_debit": false,
"embossed": null,
"embossing_custom_fields": null,
"embossing_group": null,
"expiration_date": "2028-01-01T00:00:00Z",
"external_id": null,
"issuing_date": "2023-01-01T03:20:41Z",
"metadata": null,
"migration_id": null,
"mode": "COMBO",
"operation_type": null,
"program_id": 3001,
"reason": null,
"reissued_card_block": null,
"reissued_card_id": null,
"status": "success",
"template_id": null,
"transaction_limit": null
}
],
"required": [
"account_id",
"activation_date",
"card_hash",
"card_id",
"card_last_four_numbers",
"card_name",
"card_printed_name",
"card_previous_status",
"card_status",
"card_type",
"contactless_enabled",
"embossed",
"expiration_date",
"issuing_date",
"operation_type",
"program_id",
"reason",
"status",
"transaction_limit"
],
"properties": {
"account_id": {
"type": "integer",
"title": "User's Pismo account ID",
"description": "Pismo account ID",
"examples": [
12345678
]
},
"activation_date": {
"type": [
"string",
"null"
],
"title": "Card activation date and time",
"format": "date-time",
"examples": [
"2022-07-22T20:20:39Z"
]
},
"card_hash": {
"type": [
"string",
"null"
],
"title": "Hashed PAN",
"description": "Hashed PAN. Field exists when the PCI data is created.",
"examples": [
"0fsdf0sdf9sdf0sdf0sd0fsdn09vsdj0c9sjdcsdcs0d9c=="
]
},
"card_id": {
"type": [
"integer"
],
"title": "Pismo card ID",
"description": "Pismo card ID",
"examples": [
12345678
]
},
"card_last_four_numbers": {
"type": [
"string",
"null"
],
"title": "Last 4 PAN numbers",
"description": "Last 4 PAN (primary account number) numbers. Field exists when the PCI data is created.",
"examples": [
"1234"
]
},
"card_name": {
"type": "string",
"title": "Card display name",
"description": "Card display name",
"examples": [
"Warren Pease"
]
},
"card_previous_status": {
"type": "string",
"title": "Card's previous status",
"description": "Card's previous status",
"enum": [
"CREATED",
"UMBOUND",
"NORMAL",
"REISSUED",
"BLOCKED",
"PENDING",
"WARNING",
"INOPERATIVE",
"LOST",
"ROBBED",
"CANCELED",
"FRAUD",
"DAMAGED",
"EXPIRED",
"DELETED",
"BROKEN",
"THEFT",
"DEFECT"
]
},
"card_printed_name": {
"type": [
"string",
"null"
],
"title": "Cardholder's name printed on card",
"description": "Card printed name. Physical (plastic or metal) cards only.",
"examples": [
"Holly Wood"
]
},
"card_status": {
"type": "string",
"title": "Card status",
"description": "Card's status",
"enum": [
"CREATED",
"UMBOUND",
"NORMAL",
"REISSUED",
"BLOCKED",
"PENDING",
"WARNING",
"INOPERATIVE",
"LOST",
"ROBBED",
"CANCELED",
"FRAUD",
"DAMAGED",
"EXPIRED",
"DELETED",
"BROKEN",
"THEFT",
"DEFECT"
]
},
"card_type": {
"type": "string",
"title": "Card type",
"description": "Card type",
"enum": [
"PLASTIC",
"VIRTUAL",
"RECURRING",
"TEMPORARY"
]
},
"contactless_enabled": {
"type": "boolean",
"title": "Contactless card flag",
"description": "Card can make transactions using contactless entry mode. Default is `true`"
},
"embossed": {
"type": [
"string",
"null"
],
"title": "Embosser file",
"description": "Name of file containing cards to be embossed sent to embosser.",
"examples": [
"/trackfile"
]
},
"expiration_date": {
"type": [
"string",
"null"
],
"title": "Card expiration date and time",
"description": "Card expiration date and time in RFC3339 format.",
"format": "date-time",
"examples": [
"2025-10-08T00:00:00Z"
]
},
"issuing_date": {
"type": [
"string",
"null"
],
"title": "Card issued date and time",
"description": "Card issued date and time in RFC3339 format.",
"format": "date-time",
"examples": [
"2018-11-13T20:20:39Z"
]
},
"operation_type": {
"type": [
"string",
"null"
],
"title": "Operation responsible for changing the card status ",
"enums": [
"ACTIVATE",
"REISSUE",
"UPDATE_STATUS_PATCH",
"UPDATE_STATUS_PUT",
"RESET_PASSWORD_TRIES",
"TEMPORARY_CARD_RENEWAL_EVENT",
"TEMPORARY_CARD_INOPERATIVE_EVENT",
"AUTH_PASSWORD_TRIES_EXCEEDED",
"DELETE",
"AUTHONUS_PASSWORD_TRIES_EXCEEDED"
]
},
"program_id": {
"type": [
"integer",
"null"
],
"title": "Card's Pismo program ID",
"description": "Program ID.",
"default": 0,
"example": [
12345678
]
},
"reason": {
"type": [
"string",
"null"
],
"title": "Failure reason",
"description": "Failure reason",
"examples": [
"Reason of failure"
]
},
"status": {
"type": "string",
"title": "Event status",
"description": "Event status",
"enums": [
"SUCCESS",
"FAILURE"
]
},
"transaction_limit": {
"type": [
"number",
"null"
],
"title": "Maximum amount allowed per transaction",
"description": "Transaction limit for virtual cards",
"examples": [
1000.0
]
},
"abu_enabled": {
"type": [
"boolean"
],
"title": "Automatic Billing Update (ABU) flag",
"description": "Must card number be sent to the Mastercard Automatic Billing Updater service. Default is `true`. Mastercard only."
},
"bulk_id": {
"type": [
"string",
"null"
],
"title": "Bulk/batch ID ",
"description": "Not null if card was created as part of a noname bulk/batch process"
},
"card_bin": {
"type": [
"string",
"null"
],
"title": "Card BIN",
"description": "Card BIN (bank identification number)",
"examples": [
"599999"
]
},
"card_brand": {
"type": [
"string",
"null"
],
"title": "Card brand ",
"description": "Card brand, such as `VISA`",
"enum": [
"PRIVATE",
"MASTERCARD",
"VISA"
]
},
"customer_id": {
"type": "integer",
"title": "Pismo customer ID",
"description": "Pismo customer ID",
"examples": [
100602614
]
},
"cvv_next_rotation_date": {
"type": [
"string",
"null"
],
"title": "Next CVV rotation date and time.",
"description": "Scheduled date and time, in RFC3339 format, to change the CVV2/CVC2 value. Virtual cards only.",
"format": "date-time",
"examples": [
"2021-03-01T18:45:00Z"
]
},
"cvv_rotation_type": {
"type": [
"string",
"null"
],
"title": "CVV rotation method",
"description": "CVV/CVC2 value rotation method. Virtual cards only.",
"enum": [
"MANUAL",
"AUTOMATIC"
]
},
"dual_message_debit": {
"type": [
"boolean",
"null"
],
"title": "Dual message debit card flag",
"description": "Indicates if card is DMC. Default is false"
},
"embossing_custom_fields": {
"type": [
"string",
"null"
],
"title": "Personalized information sent with emboss",
"description": "Any customer-provided information for embosser such as tracking number or embossing instructions",
"examples": [
"Cards should be metal, not plastic"
]
},
"external_id": {
"type": [
"string",
"null"
],
"title": "Personalized external information",
"description": "Customer created ID for externally tracking card",
"examples": [
"AFEF234234FSDF"
]
},
"metadata": {
"type": [
"object",
"null"
],
"title": "Customer metadata.",
"description": "Customer provided information. No business rule validation is done.",
"examples": [
{
"customer-data": {
"my": "value",
"my-custom-business-label": "label",
"score": "123"
}
}
]
},
"migration_id": {
"type": [
"string",
"null"
],
"title": "Migration ID",
"description": "CMigration ID (if migrated)",
"examples": [
"AF12341234-EF234234FSDF"
]
},
"mode": {
"type": [
"string",
"null"
],
"title": "Card mode ",
"description": "Card mode, such as `CREDIT`.",
"enum": [
"CREDIT",
"DEBIT",
"MULTIPLE",
"COMBO"
]
},
"reissued_card_block": {
"type": [
"boolean",
"null"
],
"title": "Information to replace the card in the automatic billing update flow",
"description": "Indicates if the card number is a replacement account to Mastercard Automatic Billing Updater service. Available only for Mastercard in Reissue Card Flow"
},
"reissued_card_id": {
"type": [
"integer",
"null"
],
"title": "Identification of the card from which it originated",
"description": "If the creation of a card is based on the reissued flow, this field will not be null",
"examples": [
12345678
]
},
"new_card_id": {
"type": [
"integer",
"null"
],
"title": "Identification of the card from the new reissued card",
"description": "If the updating of a card is based on the reissued flow, this field will not be null",
"examples": [
12345678
]
},
"update_tokens": {
"type": [
"boolean",
"null"
],
"title": "Information to replace the card in the tokenization pan update flow",
"description": "Indicates if the previews card have to have all tokens migrated to the new reissued card. Available only for vts/mdes tokenization program"
},
"template_id": {
"type": [
"string",
"null"
],
"title": "Template ID",
"description": "Template ID - Not null if card creation based on template. Templates are used to implement the BIN override feature. For more information, see the <a href='https://developers.pismo.io/pismo-docs/docs/cards-overview-1#bin-override---shared-account-option'>BIN override documentation</a> in the Cards overview guide. To create a template, you need to open a Pismo <a href='https://developers.pismo.io/pismo-docs/docs/service-desk'>Service Desk</a> request. The ticket type should be **Settings**. ",
"examples": [
"14a23976-db8c-4f1e-a19c-f0ec79d810r4"
]
},
"password_tries": {
"type": [
"integer",
"null"
],
"title": "Password tries",
"description": "Amount of times the password was tried.",
"examples": [
1
]
}
},
"definitions": {}
}
Updated about 2 months ago