Lock Virtual Card

The lockVirtualCard mutation allows you to lock an existing virtual card, preventing further transactions.

Prerequisites: a user access token with the EDIT_VIRTUALCARD scope, and the virtualCardId of the card to lock.

Arguments

input (LockVirtualCardInput!): The input object containing the ID of the virtual card to lock.

LockVirtualCardInput fields

Field	Type	Description	Required
`virtualCardId`	`UUID!`	The virtual card to lock.	Yes

Sample mutation

mutation {
  lockVirtualCard(input: { virtualCardId: "07df5653-43a8-4532-9881-3ab5857bbe11" }) {
    virtualCardId
    locked
  }
}

cURL example

curl -X POST \
  https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_USER_ACCESS_TOKEN' \
  -d '{
    "query": "mutation { lockVirtualCard(input: { virtualCardId: \"07df5653-43a8-4532-9881-3ab5857bbe11\" }) { virtualCardId locked } }"
  }'

Sample response

{
  "data": {
    "lockVirtualCard": {
      "virtualCardId": "07df5653-43a8-4532-9881-3ab5857bbe11",
      "locked": true
    }
  }
}

Response fields

Field	Type	Description
`virtualCardId`	`UUID`	The unique identifier of the virtual card that was targeted for locking.
`locked`	`Boolean`	`true` if the card was successfully locked, `false` otherwise.

To lock a card automatically after its first successful authorization, set lockCardNextUse: true at creation instead — see Create Virtual Card.

Next steps

Unlock a virtual card

Re-enable a locked card so authorizations succeed again.

​Arguments

​LockVirtualCardInput fields

​Sample mutation

​cURL example

​Sample response

​Response fields

​Next steps

Unlock a virtual card

Arguments

LockVirtualCardInput fields

Sample mutation

cURL example

Sample response

Response fields

Next steps