Edits to cards section after feedback; add cards definitions

swan-io · Dec 7, 2023 · f5c36ba · f5c36ba
1 parent 4701e70
commit f5c36ba
Show file tree

Hide file tree

Showing 5 changed files with 47 additions and 10 deletions.
diff --git a/docs/glossary.mdx b/docs/glossary.mdx
@@ -18,9 +18,13 @@ import CompanyOnboardingDefinition from './topics/definitions/_onboarding-compan
 
 import IndividualOnboardingDefinition from './topics/definitions/_onboarding-individual.mdx';
 
-### [**Company account onboarding**](topics/onboarding/company/index.mdx) <CompanyOnboardingDefinition />
+### [Company account onboarding](topics/onboarding/company/index.mdx)
 
-### [**Individual account onboarding**](topics/onboarding/individual/index.mdx) <IndividualOnboardingDefinition />
+<CompanyOnboardingDefinition />
+
+### [Individual account onboarding](topics/onboarding/individual/index.mdx)
+
+<IndividualOnboardingDefinition />
 
 ***
 
@@ -40,13 +44,16 @@ import PhysicalCardDefinition from './topics/definitions/_cards-physical.mdx';
 
 import DigitalCardDefinition from './topics/definitions/_cards-digital.mdx';
 
-### [**Virtual cards**](topics/cards/virtual/index.mdx)
+### [Virtual cards](topics/cards/virtual/index.mdx)
+
 <VirtualCardDefinition /> 
 
-### [**Physical cards**](topics/cards/physical/index.mdx)
+### [Physical cards](topics/cards/physical/index.mdx)
+
 <PhysicalCardDefinition /> 
 
-### [**Digital cards**](topics/cards/digital/index.mdx)
+### [Digital cards](topics/cards/digital/index.mdx)
+
 <DigitalCardDefinition /> 
 
 ***

diff --git a/docs/topics/cards/digital/index.mdx b/docs/topics/cards/digital/index.mdx
@@ -4,6 +4,14 @@ title: Digital cards
 
 # Digital cards
 
+import DigitalCardsDefinition from '../../definitions/_cards-digital.mdx';
+
+***
+
+**Digital cards** *<DigitalCardsDefinition />*
+
+***
+
 Swan cards are compatible with Apple Pay and Google Pay.
 
 If you choose to allow digital cards, your cardholders can add virtual and physical cards to their preferred digital wallet.

diff --git a/docs/topics/cards/index.mdx b/docs/topics/cards/index.mdx
@@ -12,11 +12,19 @@ Note that cards don't come with insurance.
 
 ## Types of cards {#types}
 
+import VirtualCardsDefinition from '../definitions/_cards-virtual.mdx';
+
+import PhysicalCardsDefinition from '../definitions/_cards-physical.mdx';
+
+import DigitalCardsDefinition from '../definitions/_cards-digital.mdx';
+
 Swan supports three types of cards:
 
-- [Virtual](./virtual/index.mdx): card that only exists on the computer, perfect for e-commerce transactions
-- [Physical](./physical/index.mdx): classic plastic card used to complete swipe, chip and PIN, and contactless payments
-- [Digital](./digital/index.mdx): virtual or physical card that's added to a digital wallet, such as Apple Pay or Google Pay
+[**Virtual cards**](./virtual/index.mdx) → <VirtualCardsDefinition />
+
+[**Physical cards**](./physical/index.mdx) → <PhysicalCardsDefinition />
+
+[**Digital cards**](./digital/index.mdx) → <DigitalCardsDefinition />
 
 ### Creation order {#types-order}
 
@@ -99,7 +107,7 @@ Your card's language (the language that will appear on payment terminals, for ex
 
 For Swan's **no-code** and **open source** Web Banking interface, the card language is determined by the default language of the browser where the card is created.
 
-When using the **API**, the card language is the same as the Swan account language unless otherwise communicated.
+When using the **API**, the default language is English.
 You can update the default language by calling the `bindAccountMembership` mutation and adding `accept-language` to the HTTP header.
 This allows the users to choose their card language.
 

diff --git a/docs/topics/cards/physical/index.mdx b/docs/topics/cards/physical/index.mdx
@@ -4,6 +4,14 @@ title: Physical cards
 
 # Physical cards
 
+import PhysicalCardsDefinition from '../../definitions/_cards-physical.mdx';
+
+***
+
+**Physical cards** *<PhysicalCardsDefinition />*
+
+***
+
 You can order a physical card for each virtual card.
 Swan physical cards are typical plastic cards that can be used for swipe, chip and PIN, contactless, and online transactions.
 Your [design](../design/index.mdx) will be printed on all physical cards.

diff --git a/docs/topics/cards/virtual/index.mdx b/docs/topics/cards/virtual/index.mdx
@@ -4,7 +4,13 @@ title: Virtual cards
 
 # Virtual cards
 
-Welcome to virtual cards, Swan's default card type.
+import VirtualCardsDefinition from '../../definitions/_cards-virtual.mdx';
+
+***
+
+**Virtual cards** *<VirtualCardsDefinition />*
+
+***
 
 Whenever you issue a new card, a virtual card number is **created and enabled instantly**, and the cardholder can start using it online right away.
 The virtual card must exist before a physical card can be printed or a virtual card added to a digital wallet.