v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
CVV rotation

Rotate virtual card CVV

Force a virtual card's CVV (Card Verification Value) rotation.

CVV rotation rules:

Calling this endpoint can reset the CVV rotation schedule in the future. For example, if you call this endpoint at 3PM and the defined rotation interval is 24 hours, the next rotation will take place at 3PM the next day and subsequent days after.

A 2-minute validation occurs between scheduling requests and, within this interval, no new scheduling takes place. This can lead to the following scenarios:

  • If a forced rotation occurs less than 2 minutes after an auto-rotation, the CVV is rotated and no new scheduling takes place.
  • If an auto-rotation occurs less than 2 minutes after a forced rotation, the CVV is rotated and no new scheduling takes place.
  • If more than one forced call occurs in less than 2 minutes, the CVV is rotated, but new scheduling only takes place for the first call.

This endpoint generates a Card CVV changed event.

Note: This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.

post/pcicards/v2/pcicards/cvv/{cardId}/reset

Path parameters

cardIdstring required

Pismo card ID

Request body

service_codestring

A 3 digit value, not to be confused with the CVV. Each number in the service code has a well-defined meaning, known to the card networks and other components of the interchange networks. The service code's purpose is to tell merchant terminals and acquiring networks about usage restrictions the issuer has placed on the card.

If passed, a new random service code value is not generated, and the passed value is used instead.

Response

Success CVV rotation response

successboolean

Was CVV rotated?