Update card settings

Update most settings for your card product.

note

To understand all options for card product settings, please review the explanatory content.

API guide

Card product settings are valid for all payments linked to the card, including all virtual, physical, and digital cards.

1. Update all card settings by calling the updateCard mutation.
2. When updating card settings, make sure you are authenticated with a user access token associated with the correct account member.
   • Additionally, the account member must have the membership permission canManageCards.
   • The permission canManageAccountMembership is optional.
3. The request from this mutation returns a newly created consent resource containing the consentUrl.
4. The URL allows you to redirect the user making the modification to Swan's Strong Customer Authentication.

After the consent process is completed, the card is updated and its attribute version is increased by one.

suspicion of fraud

At the slightest suspicion of fraud, block all eCommerce payments temporarily by updating eCommerce to false for the concerned card product. Additionally, you can temporarily or permanently block physical cards and permanently cancel virtual cards.

The cardholder then needs to email support@swan.io, after which Swan can issue a new card.

Mutation

🔎 Open the mutation in API Explorer

mutation UpdateCardTransactionSettings {
  updateCard(
    input: {
      cardId: "$YOUR_CARD_ID"
      withdrawal: false
      international: false
      nonMainCurrencyTransactions: false
      eCommerce: false
      consentRedirectUrl: "$YOUR_CONSENT_URL"
    }
  ) {
    ... on UpdateCardSuccessPayload {
      __typename
      consent {
        consentUrl
        id
      }
    }
  }
}

Payload

Open the consentUrl returned by the mutation to consent to the update.

{
  "data": {
    "updateCard": {
      "__typename": "UpdateCardSuccessPayload",
      "consent": {
        "consentUrl": "$YOUR_CONSENT_URL",
        "id": "$YOUR_CONSENT_ID"
      }
    }
  }
}

Dashboard

Update your card settings, including the name, whether physical cards are allowed for this card product, and suspending the card product. You can also review and click-to-copy important information about the card product.

1. Go to Dashboard > Settings > Cards, and click the card product you'd like to update.

2. Open Options. (Note the first tab, Current, where you can update design settings.)
3. Update the following options as needed. Changes are saved automatically.
   1. Card name.
   2. Whether you allow physical cards for this card product.
4. Click-to-copy the card product ID when you need it.
5. Review the spending limits for individuals and companies.
6. Click Suspend card product if you need to block this card product. Suspended card products can be reactivated by contacting Swan Support.