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. This mutation will add the eligible cards to a queue for processing. The actual updating of the PINs can take several minutes so the response that is returned indicates whether they enqueuing was successful.

This mutation requires the CREATE_VIRTUALCARD scope.

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 Field Explanations

• 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: