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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Pismo card ID

Body Params

Rotate CVV request body

string
length between 3 and 3

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.

Responses

401

Access token is missing or invalid

403

You don't have permission to access this resource

404

The specified resource was not found

500

Internal server error

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json