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 is true
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 is true. 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 as VISA
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 as CREDIT.
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": {}
}