Card CVV changed

CVV (card verification value) updated event, only applies to virtual cards. The Rotate virtual card CVV endpoint generates this event. It can also occur when the CVV is rotated automatically. See our Cards overview guide for more information about virtual cards.

Type: object
Domain: cards
Event: rotate_cvv
Version: 1

|
account_id required

Title: Account ID
Description: User's Pismo account ID
Type: integer
Example:
12345678

card_hash required

Title: Card PAN hash
Description: Hashed PAN (Primary Account Number)
Type: string
Example:
0fsdf0sdf9sdf0sdf0sd0fsdn09vsdj0c9sjdcsdcs0d9c==

card_id required

Title: Card ID
Description: Card's Pismo ID
Type: integer
Example:
12345678

card_last_four_numbers required

Title: Last 4 PAN numbers
Description: Card's last 4 PAN (Primary Account Number) numbers
Type: string
Example:
1234

card_name required

Title: Card name
Description: Card's display name
Type: string
Example:
Al Fresco

card_printed_name required

Title: Card printed name
Description: Cardholder's name
Type: string
Example:
Ho Lee Smokes

card_status required

Title: Card status
Description: Card's status
Type: string
Must be one of the following:
CREATED
UNBOUND
NORMAL
REISSUED
BLOCKED
PENDING
WARNING
INOPERATIVE
LOST
ROBBED
CANCELED
FRAUD
DAMAGED
EXPIRED
DELETED
BROKEN
THEFT
DEFECT

contactless_enabled required

Title: Contactless card flag
Description: Card can make transactions using contactless entry mode. Default is true
Type: boolean

cvv_next_rotation_date required

Title: Next cvv rotation date
Description: Date and time, in RFC3339 format, scheduled to change the CVV2/CVC2 value. Virtual card only.
Type: string
Format: date-time
Example:
2021-03-01T18:45:00Z

cvv_rotation_type required

Title: CVV rotation type
Description: CVV2/CVC2 value rotation method. Virtual card only.
Type: string
Must be one of the following:
MANUAL
AUTOMATIC

expiration_date required

Title: Card expiration date
Description: Card expiration date in RFC3339 format.
Type: string
Format: date-time
Example:
2025-10-08T00:00:00Z

issuing_date required

Title: Card issued date
Description: Card issued date and time in RFC3339 format
Type: string
Format: date-time
Example:
2018-11-13T20:20:39

program_id required

Title: Program ID
Description: Card's Pismo program ID
Type: integer
Example:
12345678

status required

Title: Event status
Description: Event status
Type: string
Must be one of the following:
SUCCESS
FAILURE

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: ABU enabled flag
Description: Must card number be sent to Mastercard's automatic billing update service. Default is true. Mastercard only.
Type: boolean

customer_id

Title: Pismo customer ID
Description: Pismo customer ID
Type: integer
Example:
100602614

embossed

Title: Embosser file
Description: Name of file containing cards to be embossed sent to embosser.
Type: string or null
Example:
/trackfile

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

metadata

Title: Metadata
Description: Caller provided information. No business rule validation is done.
Type: object or null
Additional properties: true
Example:

{
    "customer-data": {
        "my": "value",
        "my-custom-business-label": "label",
        "score": "123"
    }
}
reason

Title: Failure reason
Description: Failure reason
Type: string or null
Example:
Reason of failure

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "title": "Card CVV changed",
    "description": "CVV (card verification value) updated event, only applies to virtual cards. The <a href='https://developers.pismo.io/pismo-docs/reference/post-v2-reset-cvv'>Rotate virtual card CVV</a> endpoint generates this event. It can also occur when the CVV is rotated automatically. See our <a href='https://developers.pismo.io/pismo-docs/docs/cards-overview-1#card-types'>Cards overview</a> guide for more information about virtual cards. ",
    "examples": [
        {
            "account_id": 8675309,
            "program_id": 1183,
            "card_id": 5476631,
            "card_name": "JMG owner 310",
            "card_printed_name": "Warren Pease",
            "card_type": "VIRTUAL",
            "card_last_four_numbers": "0504",
            "card_hash": "U5xsBtm2w4Ifj2fDcdF8OZbGdoF+ZE5p1Oi+HvBsZ6/iarbCWIbbTr8xGVxpdEd92gM+KrJdT0Xlrp/NSWDlTg==",
            "card_status": "NORMAL",
            "transaction_limit": 100,
            "embossing_custom_fields": null,
            "issuing_date": "2021-02-10T20:41:15Z",
            "expiration_date": "2026-02-10T00:00:00Z",
            "embossed": null,
            "status": "success",
            "reason": null,
            "customer_id": 23954239,
            "contactless_enabled": true,
            "abu_enabled": true,
            "metadata": null,
            "cvv_rotation_type": "AUTOMATIC",
            "cvv_next_rotation_date": "2021-02-11T02:41:15Z"
        }
    ],
    "required": [
        "account_id",
        "card_hash",
        "card_id",
        "card_last_four_numbers",
        "card_name",
        "card_printed_name",
        "card_status",
        "contactless_enabled",
        "cvv_next_rotation_date",
        "cvv_rotation_type",
        "expiration_date",
        "issuing_date",
        "program_id",
        "status",
        "transaction_limit"
    ],
    "properties": {
        "account_id": {
            "type": "integer",
            "title": "Account ID",
            "description": "User's Pismo account ID",
            "examples": [
                12345678
            ]
        },
        "card_hash": {
            "type": "string",
            "title": "Card PAN hash",
            "description": "Hashed PAN (Primary Account Number)",
            "examples": [
                "0fsdf0sdf9sdf0sdf0sd0fsdn09vsdj0c9sjdcsdcs0d9c=="
            ]
        },
        "card_id": {
            "type": "integer",
            "title": "Card ID",
            "description": "Card's Pismo ID",
            "examples": [
                12345678
            ]
        },
        "card_last_four_numbers": {
            "type": "string",
            "title": "Last 4 PAN numbers",
            "description": "Card's last 4 PAN (Primary Account Number) numbers",
            "examples": [
                "1234"
            ]
        },
        "card_name": {
            "type": "string",
            "title": "Card name",
            "description": "Card's display name",
            "examples": [
                "Al Fresco"
            ]
        },
        "card_printed_name": {
            "type": [
                "string"
            ],
            "title": "Card printed name",
            "description": "Cardholder's name",
            "examples": [
                "Ho Lee Smokes"
            ]
        },
        "card_status": {
            "type": "string",
            "title": "Card status",
            "description": "Card's status",
            "enum": [
                "CREATED",
                "UNBOUND",
                "NORMAL",
                "REISSUED",
                "BLOCKED",
                "PENDING",
                "WARNING",
                "INOPERATIVE",
                "LOST",
                "ROBBED",
                "CANCELED",
                "FRAUD",
                "DAMAGED",
                "EXPIRED",
                "DELETED",
                "BROKEN",
                "THEFT",
                "DEFECT"
            ]
        },
        "contactless_enabled": {
            "type": "boolean",
            "title": "Contactless card flag",
            "description": "Card can make transactions using contactless entry mode. Default is true"
        },
        "cvv_next_rotation_date": {
            "type": "string",
            "title": "Next cvv rotation date",
            "description": "Date and time, in RFC3339 format, scheduled to change the CVV2/CVC2 value. Virtual card only.",
            "format": "date-time",
            "examples": [
                "2021-03-01T18:45:00Z"
            ]
        },
        "cvv_rotation_type": {
            "type": "string",
            "title": "CVV rotation type",
            "description": "CVV2/CVC2 value rotation method. Virtual card only.",
            "enum": [
                "MANUAL",
                "AUTOMATIC"
            ]
        },
        "expiration_date": {
            "type": "string",
            "title": "Card expiration date",
            "description": "Card expiration date in RFC3339 format.",
            "format": "date-time",
            "examples": [
                "2025-10-08T00:00:00Z"
            ]
        },
        "issuing_date": {
            "type": "string",
            "title": "Card issued date",
            "description": "Card issued date and time in RFC3339 format",
            "format": "date-time",
            "examples": [
                "2018-11-13T20:20:39"
            ]
        },
        "program_id": {
            "type": "integer",
            "title": "Program ID",
            "description": "Card's Pismo program ID",
            "default": 0,
            "examples": [
                12345678
            ]
        },
        "status": {
            "type": "string",
            "title": "Event status",
            "description": "Event status",
            "enum": [
                "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": "ABU enabled flag",
            "description": "Must card number be sent to Mastercard's automatic billing update service. Default is true. Mastercard only."
        },
        "customer_id": {
            "type": "integer",
            "title": "Pismo customer ID",
            "description": "Pismo customer ID",
            "examples": [
                100602614
            ]
        },
        "embossed": {
            "type": [
                "string",
                "null"
            ],
            "title": "Embosser file",
            "description": "Name of file containing cards to be embossed sent to embosser.",
            "examples": [
                "/trackfile"
            ]
        },
        "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"
            ]
        },
        "metadata": {
            "type": [
                "object",
                "null"
            ],
            "title": "Metadata",
            "description": "Caller provided information. No business rule validation is done.",
            "examples": [
                {
                    "customer-data": {
                        "my": "value",
                        "my-custom-business-label": "label",
                        "score": "123"
                    }
                }
            ],
            "additionalProperties": true
        },
        "reason": {
            "type": [
                "string",
                "null"
            ],
            "title": "Failure reason",
            "description": "Failure reason",
            "examples": [
                "Reason of failure"
            ]
        }
    },
    "definitions": {}
}