Update Bank Card

Update Bank Card Nickname

The updateBankCardNickname mutation allows you to update the nickname associated with a bank card.

Sample request

{
  "query": "mutation updateBankCardNickname($input: UpdateBankCardNicknameInput!) { updateBankCardNickname(input: $input) {bankCardId ownerAccountId addedUserId cardType cardProcessor cardholderName lastFourDigits expirationMonth expirationYear cardStatus billingAddressId nickname }}",
  "variables": {
    "input": {
      "bankCardId": "4111111111111111",
      "nickname": "Personal Visa"
    }
  }
}

This mutation requires the UpdateBankCardNicknameInput input type. Any field marked with an exclamation mark (!) in the schema is mandatory and must be included in the request.

Field name	Type	Description
bankCardId	UUID!	The unique identifier of the bank card.
nickname	String!	The new nickname for the bank card.

UpdateBankCardNicknameInput

{
  "bankCardId": "abc123",
  "nickname": "Personal Visa"
}

Sample response

{
  "data": {
    "updateBankCardNickname": {
      "bankCardId": "4111111111111111",
      "cardholderName": "John Doe",
      "nickname": "Personal Visa",
      "cardType": "Visa",
      "cardProcessor": "Stripe",
      "lastFourDigits": "1234",
      "expirationMonth": "12",
      "expirationYear": "2025",
      "cardStatus": "active"
    }
  }
}

💡
Use this mutation to personalize cards for easier identification within your account.

Update Bank Card Preferred Merchant Category Code (MCC)

The updateBankCardPreferredMerchantCategoryCode mutation allows you to update the preferred merchant category code (MCC) for a bank card.

Sample request

{
  "query": "mutation updateBankCardPreferredMerchantCategoryCode($input: UpdateBankCardPreferredMerchantCategoryCodeInput!) { updateBankCardPreferredMerchantCategoryCode(input: $input) { bankCardId ownerAccountId addedUserId cardType cardProcessor cardholderName lastFourDigits expirationMonth expirationYear cardStatus billingAddressId nickname }}",
  "variables": {
    "input": {
      "bankCardId": "4111111111111111",
      "preferredMerchantCategoryCode": "5812"
    }
  }
}

This mutation requires the UpdateBankCardPreferredMerchantCategoryCodeInput input type. Any field marked with an exclamation mark (!) in the schema is mandatory and must be included in the request.

Field name	Type	Description
bankCardId	UUID!	The unique identifier of the bank card.
preferredMerchantCategoryCode	String!	The preferred merchant category code (MCC) to associate with this card.

UpdateBankCardPreferredMerchantCategoryCodeInput

{
  "bankCardId": "abc123",
  "preferredMerchantCategoryCode": "5812"
}

Sample response

{
  "data": {
    "updateBankCardPreferredMerchantCategoryCode": {
      "bankCardId": "4111111111111111",
      "cardholderName": "John Doe",
      "nickname": "Personal Visa",
      "cardType": "Visa",
      "cardProcessor": "Stripe",
      "lastFourDigits": "1234",
      "expirationMonth": "12",
      "expirationYear": "2025",
      "cardStatus": "active"
    }
  }
}

🧾
The preferred merchant category code (MCC) helps optimize card transactions based on merchant categories.

Want to learn more? Contact us at [email protected]

Speak with our experts for more info or to request a demo.