Set Virtual Card PIN

The setVirtualCardPIN mutation allows you to set a PIN on eligible virtual cards that have not had a PIN set on them yet. When creating virtual cards through the Fluz API, your cards are created without setting the PIN. Most of the time, you will not need one. However, if you’d like to set one you can use this mutation to automatically identify and update all cards that support a PIN, but haven’t had their PIN set yet.

Prerequisites: a user access token with the CREATE_VIRTUALCARD scope. The PIN you set must match your user PIN.

This mutation adds the eligible cards to a queue for processing. The actual updating of the PINs can take several minutes — the response indicates whether the enqueuing was successful, not whether every card has been updated yet.

Arguments

input (SetVirtualCardPINInput!): The input object that contains the PIN to be set on the cards. It must match your user PIN.

Sample mutation

mutation {
  setVirtualCardPIN(input: { pin: "1234" }) {
    success
    pinError
  }
}

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 { setVirtualCardPIN(input: { pin: \"1234\" }) { success pinError } }"
  }'

Sample response

{
  "data": {
    "setVirtualCardPIN": {
      "success": true,
      "pinError": null
    }
  }
}

Response fields

Field	Type	Description
`success`	`Boolean`	Indicates whether the request to set PINs was successfully queued for processing.
`pinError`	`String`	Text that will alert you if there was an error verifying your PIN.

Code example

Next steps

Digital wallet push provisioning

Push a virtual card into Apple Pay or Google Wallet for tap-to-pay.

Add Virtual Card Address Digital Wallet Push Provisioning

⌘I

​Arguments

​Sample mutation

​cURL example

​Sample response

​Response fields

​Code example

​Next steps

Digital wallet push provisioning

Arguments

Sample mutation

cURL example

Sample response

Response fields

Code example

Next steps