Audience:
DevelopersOperators
Card settings
The settings that manage a card product and all the virtual, physical, and digital cards associated with it.
Settings
Each setting shows whether you update it from the Dashboard (✓) or with the API. To update settings, follow the guide to update card settings.
| Setting | Explanation | Dashboard | API |
|---|---|---|---|
| Name | You can name the card product for easy reference from your Dashboard. | ✓ | ✗ |
| Allow physical cards | Decide whether physical cards are allowed to be issued for this card product. | ✓ | ✗ |
| Suspend | Suspend this card product. Your users won't be able to add new cards with this card product. You'll need to contact Swan Support to reactivate the card product. | ✓ | ✗ |
cardContractExpiryDate | Date you'd like the card to expire. Leave it empty if you don't want to set an expiration date, in which case, cards are renewed automatically every three years. Refer to renewal and expiry for details. | ✗ | ✓ |
international | Allow or disable payments outside of the account holder's country. Cardholders can still pay using other currencies: a cardholder in France can only make payments in France, but in euros as well as other currencies. | ✗ | ✓ |
withdrawal | Allow or disable cash withdrawals, such as at ATMs. | ✗ | ✓ |
nonMainCurrencyTransactions | Allow or disable transactions outside of the card's currency. Payments can still be made in other countries, but not using other currencies: a cardholder in France can make payments in euros in the United Kingdom, but not in GBP (Pound Sterling). | ✗ | ✓ |
eCommerce | Allow or disable transactions on eCommerce sites or for online transactions. | ✗ | ✓ |
spendingLimit | Fixed by the account holder or qualifying account member, within the limits set by Swan. | ✗ | ✓ |
Custom card expiry
You can customize the expiration date for virtual cards using the cardContractExpiryDate field.
Maximum expiry
Custom expiry dates must be at most 3 years from card creation.
This setting is available in the following mutations:
addCard: add a single virtual card.addCards: add multiple virtual cards.addCardsWithGroupDelivery: add multiple cards with group delivery.updateCard: update an existing card.addSingleUseVirtualCard: add a single-use virtual card.addSingleUseVirtualCards: add multiple single-use virtual cards.
One-off SUV cards
For one-off single-use virtual cards with the spending limit period set to Always, cards automatically expire 30 days after creation. This overrides any custom expiry date you set.