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": {}
}
Updated 6 days ago