From c5829ae0f86f05d4ab2050becbb394cbb4737818 Mon Sep 17 00:00:00 2001 From: ntombing Date: Wed, 11 Mar 2026 11:19:01 +0100 Subject: [PATCH 01/15] Card packages page updates --- .../preview/card-insurance/card-insurance.mdx | 128 ++++-------------- docs/topics/cards/design/index.mdx | 10 ++ docs/topics/cards/index.mdx | 39 ++++++ docs/topics/cards/partials/_card-product.mdx | 2 +- 4 files changed, 76 insertions(+), 103 deletions(-) diff --git a/docs/preview/card-insurance/card-insurance.mdx b/docs/preview/card-insurance/card-insurance.mdx index a131d9f22eb..05e9508ff8d 100644 --- a/docs/preview/card-insurance/card-insurance.mdx +++ b/docs/preview/card-insurance/card-insurance.mdx @@ -8,15 +8,15 @@ Card insurance is currently in private beta. ## Overview {#overview} -Swan now offers insurance packages that can be added to payment cards, providing extra protection for cardholders. Partners can choose to create cards with embedded insurance or without it. +Swan offers different levels of insurance on cards, providing extra protection for cardholders. The level of coverage is defined as part of the card package configured on the Card Product. Insurance can't be added to existing cards. To add insurance, you must issue a new card using a card product that is configured with the desired package. -There are three standard insurance packages available: +There are three standard insurance levels available: -- **Basic** +- **Standard** - **Essential** - **Premium** -Once an insurance package is assigned to a card product, all new cards created under that product will automatically include the chosen insurance by default. +Once an card package is assigned to a card product, all new cards created under that product will automatically include the chosen insurance by default. :::caution No coverage for existing cards Insurance is not retroactive. Existing cards won't be updated automatically. To add insurance, you must issue a new card. @@ -36,7 +36,7 @@ Specific coverage varies by **insurance plan**. To consult the details of a card **What's included**: - | Insurance type | Explanation | Basic | Essential | Premium | Coverage limit | + | Insurance type | Explanation | Standard | Essential | Premium | Coverage limit | |---|---|:---:|:---:|:---:|---| | Loss or theft of identity documents | Reimbursement of costs for renewing identity documents (including duplicate fees, stamp duty, and identity document photos). | | | | Up to €350 per year and per claim | | Bank card fraud | Reimbursement for amounts fraudulently debited before reporting loss or theft. | | | | Up to €3,000 per year | @@ -78,113 +78,33 @@ Specific coverage varies by **insurance plan**. To consult the details of a card -## Card insurance product configuration {#insurance-configuration} +## Card package configuration {#card-package-configuration} You can assign one of the [three standard insurance packages](/preview/card-insurance) at the card product level. Once set, the package is automatically linked to any new card issued from that card product. -:::info Configure your card product +:::info Configure your card package Follow the [step-by-step guide](/preview/card-insurance/guide-insurance-integration) to configure insurance on your card product. ::: ## Card insurance billing {#insurance-billing} -Pricing varies by insurance level (Basic, Essential, Premium). Partners are billed monthly for active insurance subscriptions. -For specific pricing details, refer to your terms and conditions or contact your PIM. +Pricing varies by insurance level (Standard, Essential, Premium). Partners are billed monthly for active insurance subscriptions. +For specific pricing details, refer to your terms and conditions or submit a request to Swan Support. ## Insurance subscription {#insurance-subscription} ### Insurance subscription statuses {#subscription-statuses} -When a user orders a card with insurance, Swan begins the process of creating an insurance subscription with our insurance partner. +When a user orders a card package that includes insurance, Swan handles the insurance subscription with our insurance partner. -The subscription progresses through these statuses in order: **Pending** → **Processing** → **Enabled**, or **Canceled** (if the associated card is canceled). +The subscription status is always tied to the card status: it is created when the card is ordered and canceled when the card is canceled, so you don't need to take any specific action. -```mermaid -%%{ init: { 'flowchart': { 'curve': 'linear' } } }%% -flowchart LR - ICO((Insurance card
ordered)) --> P[Pending] - P --> PR[Processing] - PR --> E[Enabled] - E --> C[Canceled] - - NotePending["Waiting for:
• Account holder status = Verified
• Account membership status = Enabled"] -.-> P - - subgraph AS[  Active subscription  ] - E - end - - subgraph F[Final status] - C - end - - style ICO fill:#D4D3D5,stroke:#514F59 - style P fill:#D4D3D5,stroke:#514F59 - style PR fill:#D4D3D5,stroke:#514F59 - style NotePending fill:#f3f3f3,stroke:#bbb,stroke-dasharray: 4 - style AS fill:#dfedf2,stroke:#4d8296,stroke-width:3px - style F fill:#fffdf4,stroke:#cca922 -``` - -| Status | Explanation | -|---|---| -| `Pending`| Insurance subscription is waiting for the account membership to be `Enabled`, and the account holder to be `Verified`. | -| `Processing`| The insurance subscription request is sent to the insurance partner for adhesion. | -| `Enabled` | The insurance subscription is active and insurance is valid.

If you're subscribed to the `cardInsuranceSubscription.Created` webhook, you'll receive a notification when a subscription is `Enabled`. | -| `Canceled`| The insurance subscription is `Canceled` when the associated card is canceled. | - -### Insurance subscription flow {#subscription-flow} - -When a card product with insurance is ordered, Swan creates an insurance subscription (called an "adhesion" by the insurance partner). Swan automatically applies the insurance package set for the card product. - -### Sequence diagram - -The following diagram details a common flow of how the user, Your system (you), Swan and the insurance partner interact when ordering a new card with embedded insurance. - -```mermaid -sequenceDiagram - participant User - participant Your system - participant Swan - participant Insurance partner - - alt User orders card via Web Banking - User->>Swan: Orders card - else You order card via API - Your system->>Swan: Calls card creation API - Note over Your system,Swan: addCard, addCards, or addCardsWithGroupDelivery - end - - Swan-->>Your system: Returns card with insurancePackageId - Swan->>User: Shows consent screen - User->>Swan: Accepts terms - Swan->>Your system: Webhook: subscription.Created - Note over Swan: Waits for:
Account membership = Enabled
& Account holder = Verified - Swan->>Insurance partner: Creates subscription - Insurance partner-->>Swan: Confirms & activates - Swan->>Your system: Webhook: subscription.Updated -``` -### Steps - -1. A card is ordered by either: - - **The user**, through their Web Banking interface. - - **You**, through the API using one of the following mutations: - `addCard` (single card), `addCards` (multiple cards), or `addCardsWithGroupDelivery` (multiple cards with shared delivery). - -2. An `insurancePackageId` is attributed to the card. - -3. **Swan sends a consent request to your user**, and they review and **accept the insurance terms** on the consent screen. -This screen is localized based on the account member's language. - -4. After consent, **Swan sends a** `cardInsuranceSubscription.Created` **webhook** to your system. - -5. Swan creates the **insurance subscription** (called an "adhesion" by our insurance partner). +The subscription progresses through these statuses in order: **Pending** → **Processing** → **Enabled**, or **Canceled** (if the associated card is canceled). :::caution Insurance subscription creation only happens when the account membership is `Enabled` and the account holder verification status is `Verified`. The creation of a subscription may be **delayed** until these conditions are met. ::: -5. **Swan sends a** `cardInsuranceSubscription.Updated` **webhook** to your system once the insurance partner confirms the subscription. - :::info Card insurance activation Once subscribed, the insurance is automatically activated. Your user can view the insurance notice, and access the URL to the insurance claims portal through their Web Banking interface. ::: @@ -193,12 +113,15 @@ Once subscribed, the insurance is automatically activated. Your user can view th When an eligible event occurs, cardholders should submit a claim through the **insurance claims portal**, or by contacting our assistance provider, depending on the type of claim. -### Reporting a card insurance claim {#report-insurance-claims} +### Reporting fraud and phishing {#report-fraud-phishing} -#### Reporting through the claims portal +If the cardholder suspects fraud or phishing, they should **report it to Swan**. Swan will help secure the account or card, and guide the cardholder on any additional steps. + +### Standard insurance claims + +In most cases, cardholders should submit the claim through the insurance claims portal, which is available through cardholder's Web Banking interface. +It's typically used for standard claims such as: -The insurance claims portal is available in the cardholder's Web Banking interface. -It's typically used for standard claims such as: - Lost documents - Travel delays - Purchase protection @@ -206,20 +129,21 @@ It's typically used for standard claims such as: To submit a claim, cardholders must: 1. Create an account in the insurance claims portal using the email linked to their Swan account. +1. On the first login, select Sign up to create a password. 1. Upload the required documents. 1. Track the progress of their claim in the insurance claims portal. -Our **insurance partner handles the entire claims process** after it's submitted. +Our **insurance partner handles the entire claims process** after submission. Cardholders must follow up directly through the portal. If compensation is approved, it's credited directly to the cardholder's Swan account. :::info Customized claims portal -By default, the claims management interface provided by our insurance partner is co-branded with **your logo and accent color**, like your Swan interfaces (Web Banking and consent screens). +By default, the claims management interface provided by our insurance partner is co-branded with your **logo and accent color**, like your Swan interfaces (Web Banking and consent screens). ::: #### Reporting to our assistance provider -Our assistance provider handles urgent claims such as: +Our assistance provider is only available on the Premium card package. They handle urgent claims such as: - Medical emergencies - Repatriation - Hospitalisation @@ -228,7 +152,7 @@ Our assistance provider handles urgent claims such as: These must be reported **by phone** for immediate support. They handle the entire claims process. -If compensation is approved, it is credited directly to the cardholder's Swan account. +If compensation is approved, it's credited directly to the cardholder's Swan account. ### Claim types and reporting process {#insurance-claims-process} @@ -243,8 +167,8 @@ The following table outlines how to report different claim types: | Insurance cover type | How to report | Required documents | |---|---|---| | Loss or theft of identity documents | - Report through the insurance claims portal
- Within 30 business days | - Police report (loss or theft)
- Proof of renewal costs using Swan's card | - | Bank card fraud | - Report card as lost/stolen to Swan
- Within 2 business days
- Then submit the incident through the insurance claims portal
- Within 30 days | - Police report
- Confirmation the card was reported
- Proof that Swan denied coverage
- Screenshot of disputed transactions | - | Phishing guarantee | - Notify Swan and report card
- Within 2 business days
- File police report and submit claim through the insurance claims portal
- Within 2 days | - ID card
- Proof that Swan denied coverage
- Copy of fraudulent messages (email, SMS, etc.) | + | Bank card fraud | - Report card as lost/stolen to Swan
- Within 2 business days | - Police report
- Fraudulent usage declaration form
- Transaction details
- Screenshot of disputed transactions | + | Phishing guarantee | - Notify Swan and report card
- Within 2 business days | - ID card
- Copy of fraudulent messages (email, SMS, etc.) | diff --git a/docs/topics/cards/design/index.mdx b/docs/topics/cards/design/index.mdx index 0ced923f4ff..52f500bde6d 100644 --- a/docs/topics/cards/design/index.mdx +++ b/docs/topics/cards/design/index.mdx @@ -37,6 +37,16 @@ Silver cards feature your logo in **black monochrome**. ![Image displaying connection between account holders, account, account membership, and cards](../../../images/topics/cards/cards-design-standard-silver.png) +### Metal + +Metal cards are available as part of the Premium card package. + +These 22-gram cards are made from stainless steel and tungsten, with a slightly textured dark protective layer on each side and exposed metal edges. + +Your logo will be laser-printed on the cards, revealing the metal underneath. + +Card design example is not yet available. + ## Custom card design {#custom} If the standard black or silver designs won't meet your needs, or you want customize more to your brand's style, Swan also offers [custom card designs](./guide-custom.mdx). diff --git a/docs/topics/cards/index.mdx b/docs/topics/cards/index.mdx index b6f717b9d77..4978170e477 100644 --- a/docs/topics/cards/index.mdx +++ b/docs/topics/cards/index.mdx @@ -122,6 +122,45 @@ The [printing hub](./physical/index.mdx#hubs), where **physical cards are printe You must have one dedicated card product per hub, though the designs can be identical. ::: +### Card packages + +Card packages are preconfigured tiers that group card features and settings. +They help you launch market-ready offers faster, without configuring every feature individually. + +When you create a Card Product, you select a package (**Standard**, **Essential**, or **Premium**). +Each package includes a predefined set of features and settings: + +- **Insurance**: Each package automatically applies a corresponding insurance level to the Card Product: **Standard**, **Essential**, or **Premium** +- **Spending limits**: Higher tiers unlock higher transaction and withdrawal limits. +- **FX fees**: Higher tiers benefit from reduced or waived foreign exchange fees. +- **Card material**: The standard silver and black card designs are available across tiers. The **metal** card is only available with the **Premium** package. + +:::info Configuration +To implement card packages, see our Card package configuration guide. +::: + +Card package comparison + +| Feature | Standard | Essential | Premium | +| --- | --- | --- | --- | +| Insurance level | Standard | Essential | Premium | +| Spending limits | Standard | Higher | Highest | +| Foreign exchange fees | Standard | Reduced | Waived | +| Card material | Plastic | Plastic | Metal | + +:::info Availability and rollout +Card packages are available for all new card products created after the feature launch (add date). +Currently, insurance and specific package benefits can't be retroactively applied to existing cards. +If you wish to offer a card package to existing users, you must create a new card product and issue new cards. +::: + +### Card insurance + +Swan offers different insurance levels to protect cardholders, providing them extra protection. +Insurance is configured through the selected **card package**. When you choose a package during Card Product creation, the corresponding coverage is automatically enabled for all cards issued under that Card Product. + +Learn more about card insurance in the [card insurance section](https://www.google.com/search?q=/preview/card-insurance). + ## Settings {#settings} Use **settings to manage your card product** and all virtual, physical, and digital cards associated with it. diff --git a/docs/topics/cards/partials/_card-product.mdx b/docs/topics/cards/partials/_card-product.mdx index 4c0bbd868be..a1f166359d9 100644 --- a/docs/topics/cards/partials/_card-product.mdx +++ b/docs/topics/cards/partials/_card-product.mdx @@ -2,7 +2,7 @@

A card product is a collection of design information and configuration settings for the cards you ultimately offer your users. You can have several card products within the same project, each with a unique cardProduct.id.

-

Each card product can have a different card design and different settings. +

Each card product can have a different card design, different settings, and a different card package. Alternatively, card products might have common designs and settings, depending on your needs. For example, you might choose to offer a single design, but have several card products with different settings based on the intended users.

From 1d1d7f58c32a05ac61e2deca7042dddb88609949 Mon Sep 17 00:00:00 2001 From: ntombing Date: Thu, 12 Mar 2026 10:24:28 +0100 Subject: [PATCH 02/15] Updated sidebar --- docs/preview/index.mdx | 12 ------------ .../guide-insurance-integration.mdx | 0 .../cards/card-insurance/index.mdx} | 0 sidebars.js | 18 +++++++++--------- 4 files changed, 9 insertions(+), 21 deletions(-) rename docs/{preview => topics/cards}/card-insurance/guide-insurance-integration.mdx (100%) rename docs/{preview/card-insurance/card-insurance.mdx => topics/cards/card-insurance/index.mdx} (100%) diff --git a/docs/preview/index.mdx b/docs/preview/index.mdx index 3adbf4b8d54..9ab6b959d80 100644 --- a/docs/preview/index.mdx +++ b/docs/preview/index.mdx @@ -17,16 +17,4 @@ These features are in active development and will be available soon. Some may be | [In-person cards](/preview/in-person/cards) | Let merchants accept card payments using their smartphone as a terminal. | Q1, 2026 | | [Account onboarding enhancements](/preview/new-onboarding) | Redesigned onboarding mutations and queries with cleaner naming, typed responses, and improved data collection for compliance. | Q1, 2026 | - - -## Beta - -These features are in beta and available for testing. We use feedback to refine functionality before the full release. - -
- -| Feature | Description | ETA | -|---------|-------------|-----| -| [Card insurance](/preview/card-insurance) | Comprehensive insurance coverage for Swan-issued cards including theft, fraud, and travel protection. | In private beta | -
\ No newline at end of file diff --git a/docs/preview/card-insurance/guide-insurance-integration.mdx b/docs/topics/cards/card-insurance/guide-insurance-integration.mdx similarity index 100% rename from docs/preview/card-insurance/guide-insurance-integration.mdx rename to docs/topics/cards/card-insurance/guide-insurance-integration.mdx diff --git a/docs/preview/card-insurance/card-insurance.mdx b/docs/topics/cards/card-insurance/index.mdx similarity index 100% rename from docs/preview/card-insurance/card-insurance.mdx rename to docs/topics/cards/card-insurance/index.mdx diff --git a/sidebars.js b/sidebars.js index 52bbea22d96..1bc54339f42 100644 --- a/sidebars.js +++ b/sidebars.js @@ -237,6 +237,15 @@ module.exports = { "topics/cards/design/guide-custom", ], }, + { + type: "category", + label: "Card insurance", + link: { type: "doc", id: "topics/cards/card-insurance/index" }, + collapsed: true, + items: [ + "topics/cards/card-insurance/guide-insurance-integration", + ], + }, { type: "category", label: "Virtual cards", @@ -810,15 +819,6 @@ module.exports = { "preview/new-onboarding/company", ], }, - { - type: "category", - label: "Card insurance", - link: { type: "doc", id: "preview/card-insurance/card-insurance" }, - collapsed: true, - items: [ - "preview/card-insurance/guide-insurance-integration", - ], - }, ], }, ], From cca6b5a3faf4487ecc5470bb7b1f00f0043e5b8d Mon Sep 17 00:00:00 2001 From: ntombing Date: Thu, 12 Mar 2026 16:10:59 +0100 Subject: [PATCH 03/15] Update section --- docs/topics/cards/card-insurance/index.mdx | 68 +++++++++++++++++----- 1 file changed, 52 insertions(+), 16 deletions(-) diff --git a/docs/topics/cards/card-insurance/index.mdx b/docs/topics/cards/card-insurance/index.mdx index 05e9508ff8d..724fac26465 100644 --- a/docs/topics/cards/card-insurance/index.mdx +++ b/docs/topics/cards/card-insurance/index.mdx @@ -1,12 +1,57 @@ --- -title: Card insurance +title: Card package --- :::caution No coverage for existing cards Card insurance is currently in private beta. ::: -## Overview {#overview} +## Card package {#overview} + +### Overview + +Card packages are preconfigured tiers that group card features and settings. +They help you launch market-ready offers faster, without configuring every feature individually. + +When you create a Card Product, you select a package (**Standard**, **Essential**, or **Premium**). +Each package includes a predefined set of features and settings: + +- **Insurance**: Each package automatically applies a corresponding insurance level to the Card Product: **Standard**, **Essential**, or **Premium** +- **Spending limits**: Higher tiers unlock higher transaction and withdrawal limits. +- **FX fees**: Higher tiers benefit from reduced or waived foreign exchange fees. +- **Card material**: The standard silver and black card designs are available across tiers. The **metal** card is only available with the **Premium** package. + +:::info Configuration +To implement card packages, see our Card package configuration guide. +::: + +### Card package comparison + +| Feature | Standard | Essential | Premium | +| --- | --- | --- | --- | +| Insurance level | Standard | Essential | Premium | +| Spending limits | 10 000 | 40 000 | 100 000 | +| Foreign exchange fees* | Standard | Reduced | Waived | +| Card material | Plastic | Plastic | Metal | + +*Note*: Refer to T&Cs for details on FX billing. + +:::info Availability and rollout +Card packages are available for all new card products created after the feature launch (add date). +Currently, insurance and specific package benefits can't be retroactively applied to existing cards. +If you wish to offer a card package to existing users, you must create a new card product and issue new cards. +::: + +### Card package configuration {#card-package-configuration} + +You can assign one of the [three standard insurance packages](/preview/card-insurance) at the card product level. +Once set, the package is automatically linked to any new card issued from that card product. + +:::info Configure your card package +Follow the [step-by-step guide](/preview/card-insurance/guide-insurance-integration) to configure insurance on your card product. +::: + +## Card insurance {#overview} Swan offers different levels of insurance on cards, providing extra protection for cardholders. The level of coverage is defined as part of the card package configured on the Card Product. Insurance can't be added to existing cards. To add insurance, you must issue a new card using a card product that is configured with the desired package. @@ -22,7 +67,7 @@ Once an card package is assigned to a card product, all new cards created under Insurance is not retroactive. Existing cards won't be updated automatically. To add insurance, you must issue a new card. ::: -## Card insurance coverage {#insurance-coverage} +### Card insurance coverage {#insurance-coverage} The following tables outline the card insurance coverage included with Swan cards. @@ -78,16 +123,7 @@ Specific coverage varies by **insurance plan**. To consult the details of a card
-## Card package configuration {#card-package-configuration} - -You can assign one of the [three standard insurance packages](/preview/card-insurance) at the card product level. -Once set, the package is automatically linked to any new card issued from that card product. - -:::info Configure your card package -Follow the [step-by-step guide](/preview/card-insurance/guide-insurance-integration) to configure insurance on your card product. -::: - -## Card insurance billing {#insurance-billing} +### Card insurance billing {#insurance-billing} Pricing varies by insurance level (Standard, Essential, Premium). Partners are billed monthly for active insurance subscriptions. For specific pricing details, refer to your terms and conditions or submit a request to Swan Support. @@ -109,15 +145,15 @@ Insurance subscription creation only happens when the account membership is `Ena Once subscribed, the insurance is automatically activated. Your user can view the insurance notice, and access the URL to the insurance claims portal through their Web Banking interface. ::: -## Card insurance claims {#insurance-claims} +### Card insurance claims {#insurance-claims} When an eligible event occurs, cardholders should submit a claim through the **insurance claims portal**, or by contacting our assistance provider, depending on the type of claim. -### Reporting fraud and phishing {#report-fraud-phishing} +#### Reporting fraud and phishing {#report-fraud-phishing} If the cardholder suspects fraud or phishing, they should **report it to Swan**. Swan will help secure the account or card, and guide the cardholder on any additional steps. -### Standard insurance claims +#### Standard insurance claims In most cases, cardholders should submit the claim through the insurance claims portal, which is available through cardholder's Web Banking interface. It's typically used for standard claims such as: From 2b000c74299778d9ac32224415af97b0246e81e2 Mon Sep 17 00:00:00 2001 From: ntombing Date: Wed, 11 Mar 2026 11:19:01 +0100 Subject: [PATCH 04/15] Card packages page updates --- .../preview/card-insurance/card-insurance.mdx | 128 ++++-------------- docs/topics/cards/design/index.mdx | 10 ++ docs/topics/cards/index.mdx | 39 ++++++ docs/topics/cards/partials/_card-product.mdx | 2 +- 4 files changed, 76 insertions(+), 103 deletions(-) diff --git a/docs/preview/card-insurance/card-insurance.mdx b/docs/preview/card-insurance/card-insurance.mdx index a131d9f22eb..05e9508ff8d 100644 --- a/docs/preview/card-insurance/card-insurance.mdx +++ b/docs/preview/card-insurance/card-insurance.mdx @@ -8,15 +8,15 @@ Card insurance is currently in private beta. ## Overview {#overview} -Swan now offers insurance packages that can be added to payment cards, providing extra protection for cardholders. Partners can choose to create cards with embedded insurance or without it. +Swan offers different levels of insurance on cards, providing extra protection for cardholders. The level of coverage is defined as part of the card package configured on the Card Product. Insurance can't be added to existing cards. To add insurance, you must issue a new card using a card product that is configured with the desired package. -There are three standard insurance packages available: +There are three standard insurance levels available: -- **Basic** +- **Standard** - **Essential** - **Premium** -Once an insurance package is assigned to a card product, all new cards created under that product will automatically include the chosen insurance by default. +Once an card package is assigned to a card product, all new cards created under that product will automatically include the chosen insurance by default. :::caution No coverage for existing cards Insurance is not retroactive. Existing cards won't be updated automatically. To add insurance, you must issue a new card. @@ -36,7 +36,7 @@ Specific coverage varies by **insurance plan**. To consult the details of a card **What's included**: - | Insurance type | Explanation | Basic | Essential | Premium | Coverage limit | + | Insurance type | Explanation | Standard | Essential | Premium | Coverage limit | |---|---|:---:|:---:|:---:|---| | Loss or theft of identity documents | Reimbursement of costs for renewing identity documents (including duplicate fees, stamp duty, and identity document photos). | | | | Up to €350 per year and per claim | | Bank card fraud | Reimbursement for amounts fraudulently debited before reporting loss or theft. | | | | Up to €3,000 per year | @@ -78,113 +78,33 @@ Specific coverage varies by **insurance plan**. To consult the details of a card -## Card insurance product configuration {#insurance-configuration} +## Card package configuration {#card-package-configuration} You can assign one of the [three standard insurance packages](/preview/card-insurance) at the card product level. Once set, the package is automatically linked to any new card issued from that card product. -:::info Configure your card product +:::info Configure your card package Follow the [step-by-step guide](/preview/card-insurance/guide-insurance-integration) to configure insurance on your card product. ::: ## Card insurance billing {#insurance-billing} -Pricing varies by insurance level (Basic, Essential, Premium). Partners are billed monthly for active insurance subscriptions. -For specific pricing details, refer to your terms and conditions or contact your PIM. +Pricing varies by insurance level (Standard, Essential, Premium). Partners are billed monthly for active insurance subscriptions. +For specific pricing details, refer to your terms and conditions or submit a request to Swan Support. ## Insurance subscription {#insurance-subscription} ### Insurance subscription statuses {#subscription-statuses} -When a user orders a card with insurance, Swan begins the process of creating an insurance subscription with our insurance partner. +When a user orders a card package that includes insurance, Swan handles the insurance subscription with our insurance partner. -The subscription progresses through these statuses in order: **Pending** → **Processing** → **Enabled**, or **Canceled** (if the associated card is canceled). +The subscription status is always tied to the card status: it is created when the card is ordered and canceled when the card is canceled, so you don't need to take any specific action. -```mermaid -%%{ init: { 'flowchart': { 'curve': 'linear' } } }%% -flowchart LR - ICO((Insurance card
ordered)) --> P[Pending] - P --> PR[Processing] - PR --> E[Enabled] - E --> C[Canceled] - - NotePending["Waiting for:
• Account holder status = Verified
• Account membership status = Enabled"] -.-> P - - subgraph AS[  Active subscription  ] - E - end - - subgraph F[Final status] - C - end - - style ICO fill:#D4D3D5,stroke:#514F59 - style P fill:#D4D3D5,stroke:#514F59 - style PR fill:#D4D3D5,stroke:#514F59 - style NotePending fill:#f3f3f3,stroke:#bbb,stroke-dasharray: 4 - style AS fill:#dfedf2,stroke:#4d8296,stroke-width:3px - style F fill:#fffdf4,stroke:#cca922 -``` - -| Status | Explanation | -|---|---| -| `Pending`| Insurance subscription is waiting for the account membership to be `Enabled`, and the account holder to be `Verified`. | -| `Processing`| The insurance subscription request is sent to the insurance partner for adhesion. | -| `Enabled` | The insurance subscription is active and insurance is valid.

If you're subscribed to the `cardInsuranceSubscription.Created` webhook, you'll receive a notification when a subscription is `Enabled`. | -| `Canceled`| The insurance subscription is `Canceled` when the associated card is canceled. | - -### Insurance subscription flow {#subscription-flow} - -When a card product with insurance is ordered, Swan creates an insurance subscription (called an "adhesion" by the insurance partner). Swan automatically applies the insurance package set for the card product. - -### Sequence diagram - -The following diagram details a common flow of how the user, Your system (you), Swan and the insurance partner interact when ordering a new card with embedded insurance. - -```mermaid -sequenceDiagram - participant User - participant Your system - participant Swan - participant Insurance partner - - alt User orders card via Web Banking - User->>Swan: Orders card - else You order card via API - Your system->>Swan: Calls card creation API - Note over Your system,Swan: addCard, addCards, or addCardsWithGroupDelivery - end - - Swan-->>Your system: Returns card with insurancePackageId - Swan->>User: Shows consent screen - User->>Swan: Accepts terms - Swan->>Your system: Webhook: subscription.Created - Note over Swan: Waits for:
Account membership = Enabled
& Account holder = Verified - Swan->>Insurance partner: Creates subscription - Insurance partner-->>Swan: Confirms & activates - Swan->>Your system: Webhook: subscription.Updated -``` -### Steps - -1. A card is ordered by either: - - **The user**, through their Web Banking interface. - - **You**, through the API using one of the following mutations: - `addCard` (single card), `addCards` (multiple cards), or `addCardsWithGroupDelivery` (multiple cards with shared delivery). - -2. An `insurancePackageId` is attributed to the card. - -3. **Swan sends a consent request to your user**, and they review and **accept the insurance terms** on the consent screen. -This screen is localized based on the account member's language. - -4. After consent, **Swan sends a** `cardInsuranceSubscription.Created` **webhook** to your system. - -5. Swan creates the **insurance subscription** (called an "adhesion" by our insurance partner). +The subscription progresses through these statuses in order: **Pending** → **Processing** → **Enabled**, or **Canceled** (if the associated card is canceled). :::caution Insurance subscription creation only happens when the account membership is `Enabled` and the account holder verification status is `Verified`. The creation of a subscription may be **delayed** until these conditions are met. ::: -5. **Swan sends a** `cardInsuranceSubscription.Updated` **webhook** to your system once the insurance partner confirms the subscription. - :::info Card insurance activation Once subscribed, the insurance is automatically activated. Your user can view the insurance notice, and access the URL to the insurance claims portal through their Web Banking interface. ::: @@ -193,12 +113,15 @@ Once subscribed, the insurance is automatically activated. Your user can view th When an eligible event occurs, cardholders should submit a claim through the **insurance claims portal**, or by contacting our assistance provider, depending on the type of claim. -### Reporting a card insurance claim {#report-insurance-claims} +### Reporting fraud and phishing {#report-fraud-phishing} -#### Reporting through the claims portal +If the cardholder suspects fraud or phishing, they should **report it to Swan**. Swan will help secure the account or card, and guide the cardholder on any additional steps. + +### Standard insurance claims + +In most cases, cardholders should submit the claim through the insurance claims portal, which is available through cardholder's Web Banking interface. +It's typically used for standard claims such as: -The insurance claims portal is available in the cardholder's Web Banking interface. -It's typically used for standard claims such as: - Lost documents - Travel delays - Purchase protection @@ -206,20 +129,21 @@ It's typically used for standard claims such as: To submit a claim, cardholders must: 1. Create an account in the insurance claims portal using the email linked to their Swan account. +1. On the first login, select Sign up to create a password. 1. Upload the required documents. 1. Track the progress of their claim in the insurance claims portal. -Our **insurance partner handles the entire claims process** after it's submitted. +Our **insurance partner handles the entire claims process** after submission. Cardholders must follow up directly through the portal. If compensation is approved, it's credited directly to the cardholder's Swan account. :::info Customized claims portal -By default, the claims management interface provided by our insurance partner is co-branded with **your logo and accent color**, like your Swan interfaces (Web Banking and consent screens). +By default, the claims management interface provided by our insurance partner is co-branded with your **logo and accent color**, like your Swan interfaces (Web Banking and consent screens). ::: #### Reporting to our assistance provider -Our assistance provider handles urgent claims such as: +Our assistance provider is only available on the Premium card package. They handle urgent claims such as: - Medical emergencies - Repatriation - Hospitalisation @@ -228,7 +152,7 @@ Our assistance provider handles urgent claims such as: These must be reported **by phone** for immediate support. They handle the entire claims process. -If compensation is approved, it is credited directly to the cardholder's Swan account. +If compensation is approved, it's credited directly to the cardholder's Swan account. ### Claim types and reporting process {#insurance-claims-process} @@ -243,8 +167,8 @@ The following table outlines how to report different claim types: | Insurance cover type | How to report | Required documents | |---|---|---| | Loss or theft of identity documents | - Report through the insurance claims portal
- Within 30 business days | - Police report (loss or theft)
- Proof of renewal costs using Swan's card | - | Bank card fraud | - Report card as lost/stolen to Swan
- Within 2 business days
- Then submit the incident through the insurance claims portal
- Within 30 days | - Police report
- Confirmation the card was reported
- Proof that Swan denied coverage
- Screenshot of disputed transactions | - | Phishing guarantee | - Notify Swan and report card
- Within 2 business days
- File police report and submit claim through the insurance claims portal
- Within 2 days | - ID card
- Proof that Swan denied coverage
- Copy of fraudulent messages (email, SMS, etc.) | + | Bank card fraud | - Report card as lost/stolen to Swan
- Within 2 business days | - Police report
- Fraudulent usage declaration form
- Transaction details
- Screenshot of disputed transactions | + | Phishing guarantee | - Notify Swan and report card
- Within 2 business days | - ID card
- Copy of fraudulent messages (email, SMS, etc.) | diff --git a/docs/topics/cards/design/index.mdx b/docs/topics/cards/design/index.mdx index 0ced923f4ff..52f500bde6d 100644 --- a/docs/topics/cards/design/index.mdx +++ b/docs/topics/cards/design/index.mdx @@ -37,6 +37,16 @@ Silver cards feature your logo in **black monochrome**. ![Image displaying connection between account holders, account, account membership, and cards](../../../images/topics/cards/cards-design-standard-silver.png) +### Metal + +Metal cards are available as part of the Premium card package. + +These 22-gram cards are made from stainless steel and tungsten, with a slightly textured dark protective layer on each side and exposed metal edges. + +Your logo will be laser-printed on the cards, revealing the metal underneath. + +Card design example is not yet available. + ## Custom card design {#custom} If the standard black or silver designs won't meet your needs, or you want customize more to your brand's style, Swan also offers [custom card designs](./guide-custom.mdx). diff --git a/docs/topics/cards/index.mdx b/docs/topics/cards/index.mdx index b6f717b9d77..4978170e477 100644 --- a/docs/topics/cards/index.mdx +++ b/docs/topics/cards/index.mdx @@ -122,6 +122,45 @@ The [printing hub](./physical/index.mdx#hubs), where **physical cards are printe You must have one dedicated card product per hub, though the designs can be identical. ::: +### Card packages + +Card packages are preconfigured tiers that group card features and settings. +They help you launch market-ready offers faster, without configuring every feature individually. + +When you create a Card Product, you select a package (**Standard**, **Essential**, or **Premium**). +Each package includes a predefined set of features and settings: + +- **Insurance**: Each package automatically applies a corresponding insurance level to the Card Product: **Standard**, **Essential**, or **Premium** +- **Spending limits**: Higher tiers unlock higher transaction and withdrawal limits. +- **FX fees**: Higher tiers benefit from reduced or waived foreign exchange fees. +- **Card material**: The standard silver and black card designs are available across tiers. The **metal** card is only available with the **Premium** package. + +:::info Configuration +To implement card packages, see our Card package configuration guide. +::: + +Card package comparison + +| Feature | Standard | Essential | Premium | +| --- | --- | --- | --- | +| Insurance level | Standard | Essential | Premium | +| Spending limits | Standard | Higher | Highest | +| Foreign exchange fees | Standard | Reduced | Waived | +| Card material | Plastic | Plastic | Metal | + +:::info Availability and rollout +Card packages are available for all new card products created after the feature launch (add date). +Currently, insurance and specific package benefits can't be retroactively applied to existing cards. +If you wish to offer a card package to existing users, you must create a new card product and issue new cards. +::: + +### Card insurance + +Swan offers different insurance levels to protect cardholders, providing them extra protection. +Insurance is configured through the selected **card package**. When you choose a package during Card Product creation, the corresponding coverage is automatically enabled for all cards issued under that Card Product. + +Learn more about card insurance in the [card insurance section](https://www.google.com/search?q=/preview/card-insurance). + ## Settings {#settings} Use **settings to manage your card product** and all virtual, physical, and digital cards associated with it. diff --git a/docs/topics/cards/partials/_card-product.mdx b/docs/topics/cards/partials/_card-product.mdx index 4c0bbd868be..a1f166359d9 100644 --- a/docs/topics/cards/partials/_card-product.mdx +++ b/docs/topics/cards/partials/_card-product.mdx @@ -2,7 +2,7 @@

A card product is a collection of design information and configuration settings for the cards you ultimately offer your users. You can have several card products within the same project, each with a unique cardProduct.id.

-

Each card product can have a different card design and different settings. +

Each card product can have a different card design, different settings, and a different card package. Alternatively, card products might have common designs and settings, depending on your needs. For example, you might choose to offer a single design, but have several card products with different settings based on the intended users.

From e670ce4253cde73679d29d1614e74452cb45a8a2 Mon Sep 17 00:00:00 2001 From: ntombing Date: Thu, 12 Mar 2026 10:24:28 +0100 Subject: [PATCH 05/15] Updated sidebar --- docs/preview/index.mdx | 12 ------------ .../guide-insurance-integration.mdx | 0 .../cards/card-insurance/index.mdx} | 0 sidebars.js | 18 +++++++++--------- 4 files changed, 9 insertions(+), 21 deletions(-) rename docs/{preview => topics/cards}/card-insurance/guide-insurance-integration.mdx (100%) rename docs/{preview/card-insurance/card-insurance.mdx => topics/cards/card-insurance/index.mdx} (100%) diff --git a/docs/preview/index.mdx b/docs/preview/index.mdx index 3adbf4b8d54..9ab6b959d80 100644 --- a/docs/preview/index.mdx +++ b/docs/preview/index.mdx @@ -17,16 +17,4 @@ These features are in active development and will be available soon. Some may be | [In-person cards](/preview/in-person/cards) | Let merchants accept card payments using their smartphone as a terminal. | Q1, 2026 | | [Account onboarding enhancements](/preview/new-onboarding) | Redesigned onboarding mutations and queries with cleaner naming, typed responses, and improved data collection for compliance. | Q1, 2026 | - - -## Beta - -These features are in beta and available for testing. We use feedback to refine functionality before the full release. - -
- -| Feature | Description | ETA | -|---------|-------------|-----| -| [Card insurance](/preview/card-insurance) | Comprehensive insurance coverage for Swan-issued cards including theft, fraud, and travel protection. | In private beta | -
\ No newline at end of file diff --git a/docs/preview/card-insurance/guide-insurance-integration.mdx b/docs/topics/cards/card-insurance/guide-insurance-integration.mdx similarity index 100% rename from docs/preview/card-insurance/guide-insurance-integration.mdx rename to docs/topics/cards/card-insurance/guide-insurance-integration.mdx diff --git a/docs/preview/card-insurance/card-insurance.mdx b/docs/topics/cards/card-insurance/index.mdx similarity index 100% rename from docs/preview/card-insurance/card-insurance.mdx rename to docs/topics/cards/card-insurance/index.mdx diff --git a/sidebars.js b/sidebars.js index 52bbea22d96..1bc54339f42 100644 --- a/sidebars.js +++ b/sidebars.js @@ -237,6 +237,15 @@ module.exports = { "topics/cards/design/guide-custom", ], }, + { + type: "category", + label: "Card insurance", + link: { type: "doc", id: "topics/cards/card-insurance/index" }, + collapsed: true, + items: [ + "topics/cards/card-insurance/guide-insurance-integration", + ], + }, { type: "category", label: "Virtual cards", @@ -810,15 +819,6 @@ module.exports = { "preview/new-onboarding/company", ], }, - { - type: "category", - label: "Card insurance", - link: { type: "doc", id: "preview/card-insurance/card-insurance" }, - collapsed: true, - items: [ - "preview/card-insurance/guide-insurance-integration", - ], - }, ], }, ], From 19738b57b778ba12806a2aaf3c75f36cc2abe91a Mon Sep 17 00:00:00 2001 From: ntombing Date: Thu, 12 Mar 2026 16:10:59 +0100 Subject: [PATCH 06/15] Update section --- docs/topics/cards/card-insurance/index.mdx | 68 +++++++++++++++++----- 1 file changed, 52 insertions(+), 16 deletions(-) diff --git a/docs/topics/cards/card-insurance/index.mdx b/docs/topics/cards/card-insurance/index.mdx index 05e9508ff8d..724fac26465 100644 --- a/docs/topics/cards/card-insurance/index.mdx +++ b/docs/topics/cards/card-insurance/index.mdx @@ -1,12 +1,57 @@ --- -title: Card insurance +title: Card package --- :::caution No coverage for existing cards Card insurance is currently in private beta. ::: -## Overview {#overview} +## Card package {#overview} + +### Overview + +Card packages are preconfigured tiers that group card features and settings. +They help you launch market-ready offers faster, without configuring every feature individually. + +When you create a Card Product, you select a package (**Standard**, **Essential**, or **Premium**). +Each package includes a predefined set of features and settings: + +- **Insurance**: Each package automatically applies a corresponding insurance level to the Card Product: **Standard**, **Essential**, or **Premium** +- **Spending limits**: Higher tiers unlock higher transaction and withdrawal limits. +- **FX fees**: Higher tiers benefit from reduced or waived foreign exchange fees. +- **Card material**: The standard silver and black card designs are available across tiers. The **metal** card is only available with the **Premium** package. + +:::info Configuration +To implement card packages, see our Card package configuration guide. +::: + +### Card package comparison + +| Feature | Standard | Essential | Premium | +| --- | --- | --- | --- | +| Insurance level | Standard | Essential | Premium | +| Spending limits | 10 000 | 40 000 | 100 000 | +| Foreign exchange fees* | Standard | Reduced | Waived | +| Card material | Plastic | Plastic | Metal | + +*Note*: Refer to T&Cs for details on FX billing. + +:::info Availability and rollout +Card packages are available for all new card products created after the feature launch (add date). +Currently, insurance and specific package benefits can't be retroactively applied to existing cards. +If you wish to offer a card package to existing users, you must create a new card product and issue new cards. +::: + +### Card package configuration {#card-package-configuration} + +You can assign one of the [three standard insurance packages](/preview/card-insurance) at the card product level. +Once set, the package is automatically linked to any new card issued from that card product. + +:::info Configure your card package +Follow the [step-by-step guide](/preview/card-insurance/guide-insurance-integration) to configure insurance on your card product. +::: + +## Card insurance {#overview} Swan offers different levels of insurance on cards, providing extra protection for cardholders. The level of coverage is defined as part of the card package configured on the Card Product. Insurance can't be added to existing cards. To add insurance, you must issue a new card using a card product that is configured with the desired package. @@ -22,7 +67,7 @@ Once an card package is assigned to a card product, all new cards created under Insurance is not retroactive. Existing cards won't be updated automatically. To add insurance, you must issue a new card. ::: -## Card insurance coverage {#insurance-coverage} +### Card insurance coverage {#insurance-coverage} The following tables outline the card insurance coverage included with Swan cards. @@ -78,16 +123,7 @@ Specific coverage varies by **insurance plan**. To consult the details of a card
-## Card package configuration {#card-package-configuration} - -You can assign one of the [three standard insurance packages](/preview/card-insurance) at the card product level. -Once set, the package is automatically linked to any new card issued from that card product. - -:::info Configure your card package -Follow the [step-by-step guide](/preview/card-insurance/guide-insurance-integration) to configure insurance on your card product. -::: - -## Card insurance billing {#insurance-billing} +### Card insurance billing {#insurance-billing} Pricing varies by insurance level (Standard, Essential, Premium). Partners are billed monthly for active insurance subscriptions. For specific pricing details, refer to your terms and conditions or submit a request to Swan Support. @@ -109,15 +145,15 @@ Insurance subscription creation only happens when the account membership is `Ena Once subscribed, the insurance is automatically activated. Your user can view the insurance notice, and access the URL to the insurance claims portal through their Web Banking interface. ::: -## Card insurance claims {#insurance-claims} +### Card insurance claims {#insurance-claims} When an eligible event occurs, cardholders should submit a claim through the **insurance claims portal**, or by contacting our assistance provider, depending on the type of claim. -### Reporting fraud and phishing {#report-fraud-phishing} +#### Reporting fraud and phishing {#report-fraud-phishing} If the cardholder suspects fraud or phishing, they should **report it to Swan**. Swan will help secure the account or card, and guide the cardholder on any additional steps. -### Standard insurance claims +#### Standard insurance claims In most cases, cardholders should submit the claim through the insurance claims portal, which is available through cardholder's Web Banking interface. It's typically used for standard claims such as: From 130a06aea2f1ce281b04308ee6e6dc803e42f647 Mon Sep 17 00:00:00 2001 From: ntombing Date: Thu, 12 Mar 2026 17:02:22 +0100 Subject: [PATCH 07/15] Removed preview links from text --- changelog/coming-up.mdx | 2 +- .../cards/card-insurance/guide-insurance-integration.mdx | 2 +- docs/topics/cards/card-insurance/index.mdx | 6 +++--- docs/topics/cards/index.mdx | 2 -- 4 files changed, 5 insertions(+), 7 deletions(-) diff --git a/changelog/coming-up.mdx b/changelog/coming-up.mdx index cedcc0b789c..825caf3285f 100644 --- a/changelog/coming-up.mdx +++ b/changelog/coming-up.mdx @@ -1,5 +1,5 @@ :::tip Upcoming features -[Card insurance](https://docs.swan.io/preview/card-insurance/), [Belgian IBANs](https://docs.swan.io/preview/belgian-ibans), and more! Check out [Swan's public roadmap](https://swanio.notion.site/Swan-Public-Roadmap-385e4b2e91b3409786a6c8e885654a22) to see what's in the works. 🚀 +[Card insurance](https://docs.swan.io/topics/cards/), [Belgian IBANs](https://docs.swan.io/preview/belgian-ibans), and more! Check out [Swan's public roadmap](https://swanio.notion.site/Swan-Public-Roadmap-385e4b2e91b3409786a6c8e885654a22) to see what's in the works. 🚀 :::
diff --git a/docs/topics/cards/card-insurance/guide-insurance-integration.mdx b/docs/topics/cards/card-insurance/guide-insurance-integration.mdx index 463ba00fa4f..31fd254745b 100644 --- a/docs/topics/cards/card-insurance/guide-insurance-integration.mdx +++ b/docs/topics/cards/card-insurance/guide-insurance-integration.mdx @@ -27,7 +27,7 @@ To issue cards with insurance, it's mandatory to display the [standard marketing ## 3. Card insurance subscription -Swan automatically creates a [card insurance subscription](/preview/card-insurance#insurance-subscription) when a new card is issued, if the following conditions are met: +Swan automatically creates a [card insurance subscription](topics/cards/card-insurance/#insurance) when a new card is issued, if the following conditions are met: - The cardholder's account membership is `Enabled`. - The account holder is `Verified`. diff --git a/docs/topics/cards/card-insurance/index.mdx b/docs/topics/cards/card-insurance/index.mdx index 724fac26465..1880423e340 100644 --- a/docs/topics/cards/card-insurance/index.mdx +++ b/docs/topics/cards/card-insurance/index.mdx @@ -44,14 +44,14 @@ If you wish to offer a card package to existing users, you must create a new car ### Card package configuration {#card-package-configuration} -You can assign one of the [three standard insurance packages](/preview/card-insurance) at the card product level. +You can assign one of the three standard insurance packages at the card product level. Once set, the package is automatically linked to any new card issued from that card product. :::info Configure your card package -Follow the [step-by-step guide](/preview/card-insurance/guide-insurance-integration) to configure insurance on your card product. +Follow the step-by-step guide to configure insurance on your card product. ::: -## Card insurance {#overview} +## Card insurance {#insurance} Swan offers different levels of insurance on cards, providing extra protection for cardholders. The level of coverage is defined as part of the card package configured on the Card Product. Insurance can't be added to existing cards. To add insurance, you must issue a new card using a card product that is configured with the desired package. diff --git a/docs/topics/cards/index.mdx b/docs/topics/cards/index.mdx index 4978170e477..01d05167938 100644 --- a/docs/topics/cards/index.mdx +++ b/docs/topics/cards/index.mdx @@ -159,8 +159,6 @@ If you wish to offer a card package to existing users, you must create a new car Swan offers different insurance levels to protect cardholders, providing them extra protection. Insurance is configured through the selected **card package**. When you choose a package during Card Product creation, the corresponding coverage is automatically enabled for all cards issued under that Card Product. -Learn more about card insurance in the [card insurance section](https://www.google.com/search?q=/preview/card-insurance). - ## Settings {#settings} Use **settings to manage your card product** and all virtual, physical, and digital cards associated with it. From 178e4f25f5b265686cadd0cc6723d108e963ac82 Mon Sep 17 00:00:00 2001 From: ntombing Date: Thu, 12 Mar 2026 17:27:54 +0100 Subject: [PATCH 08/15] Added this / --- .../topics/cards/card-insurance/guide-insurance-integration.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/topics/cards/card-insurance/guide-insurance-integration.mdx b/docs/topics/cards/card-insurance/guide-insurance-integration.mdx index 31fd254745b..6fc0aa8ea68 100644 --- a/docs/topics/cards/card-insurance/guide-insurance-integration.mdx +++ b/docs/topics/cards/card-insurance/guide-insurance-integration.mdx @@ -27,7 +27,7 @@ To issue cards with insurance, it's mandatory to display the [standard marketing ## 3. Card insurance subscription -Swan automatically creates a [card insurance subscription](topics/cards/card-insurance/#insurance) when a new card is issued, if the following conditions are met: +Swan automatically creates a [card insurance subscription](/topics/cards/card-insurance/#insurance) when a new card is issued, if the following conditions are met: - The cardholder's account membership is `Enabled`. - The account holder is `Verified`. From cd5b7284d04397bf1860db8cec7a9a5ead1b54e2 Mon Sep 17 00:00:00 2001 From: ntombing Date: Thu, 12 Mar 2026 17:46:12 +0100 Subject: [PATCH 09/15] Redirects from Preview to Live --- changelog/coming-up.mdx | 2 +- .../guide-packages-integration.mdx} | 12 ++++++------ .../{card-insurance => card-packages}/index.mdx | 12 ++++++------ redirects.js | 8 ++++++++ sidebars.js | 6 +++--- 5 files changed, 24 insertions(+), 16 deletions(-) rename docs/topics/cards/{card-insurance/guide-insurance-integration.mdx => card-packages/guide-packages-integration.mdx} (76%) rename docs/topics/cards/{card-insurance => card-packages}/index.mdx (97%) diff --git a/changelog/coming-up.mdx b/changelog/coming-up.mdx index 825caf3285f..1e22f1621d5 100644 --- a/changelog/coming-up.mdx +++ b/changelog/coming-up.mdx @@ -1,5 +1,5 @@ :::tip Upcoming features -[Card insurance](https://docs.swan.io/topics/cards/), [Belgian IBANs](https://docs.swan.io/preview/belgian-ibans), and more! Check out [Swan's public roadmap](https://swanio.notion.site/Swan-Public-Roadmap-385e4b2e91b3409786a6c8e885654a22) to see what's in the works. 🚀 +[Card packages](https://docs.swan.io/topics/cards/), [Belgian IBANs](https://docs.swan.io/preview/belgian-ibans), and more! Check out [Swan's public roadmap](https://swanio.notion.site/Swan-Public-Roadmap-385e4b2e91b3409786a6c8e885654a22) to see what's in the works. 🚀 :::
diff --git a/docs/topics/cards/card-insurance/guide-insurance-integration.mdx b/docs/topics/cards/card-packages/guide-packages-integration.mdx similarity index 76% rename from docs/topics/cards/card-insurance/guide-insurance-integration.mdx rename to docs/topics/cards/card-packages/guide-packages-integration.mdx index 6fc0aa8ea68..f95e9dbc4c5 100644 --- a/docs/topics/cards/card-insurance/guide-insurance-integration.mdx +++ b/docs/topics/cards/card-packages/guide-packages-integration.mdx @@ -1,16 +1,16 @@ --- -title: Configure card insurance package +title: Configure Card packages package --- :::caution No coverage for existing cards -Card insurance is currently in private beta. +Card packages is currently in private beta. ::: -This guide explains how to configure insurance on card products, issue cards with insurance, support card insurance claims. +This guide explains how to configure insurance on card products, issue cards with insurance, support Card packages claims. ## 1. Configure insurance on card products -When creating a card product, link it to a card insurance object by setting the [`defaultInsurancePackage`](https://api-reference.swan.io/objects/card-insurance-configuration/#cardinsuranceconfigurationdefaultinsurancepackagecardinsurancepackage). +When creating a card product, link it to a Card packages object by setting the [`defaultInsurancePackage`](https://api-reference.swan.io/objects/card-packages-configuration/#cardinsuranceconfigurationdefaultinsurancepackagecardinsurancepackage). This package is automatically applied when a card is issued. The `availableInsurancePackages` field lists all eligible insurance packages for the card product. @@ -25,9 +25,9 @@ After configuring your insurance settings, your PIM will review and validate the To issue cards with insurance, it's mandatory to display the [standard marketing and legal mentions](https://docs.google.com/presentation/d/159nE02OtxcZ_uVQIpX8H7fLVC9VubPAf/edit?slide=id.g33c8ca1d644_0_302#slide=id.g33c8ca1d644_0_302) regarding the insurance coverage package within your app or website. Swan includes this information in the Terms and Conditions. ::: -## 3. Card insurance subscription +## 3. Card packages subscription -Swan automatically creates a [card insurance subscription](/topics/cards/card-insurance/#insurance) when a new card is issued, if the following conditions are met: +Swan automatically creates a [Card packages subscription](/topics/cards/card-packages/#insurance) when a new card is issued, if the following conditions are met: - The cardholder's account membership is `Enabled`. - The account holder is `Verified`. diff --git a/docs/topics/cards/card-insurance/index.mdx b/docs/topics/cards/card-packages/index.mdx similarity index 97% rename from docs/topics/cards/card-insurance/index.mdx rename to docs/topics/cards/card-packages/index.mdx index 1880423e340..32880b370ef 100644 --- a/docs/topics/cards/card-insurance/index.mdx +++ b/docs/topics/cards/card-packages/index.mdx @@ -3,7 +3,7 @@ title: Card package --- :::caution No coverage for existing cards -Card insurance is currently in private beta. +Card packages is currently in private beta. ::: ## Card package {#overview} @@ -51,7 +51,7 @@ Once set, the package is automatically linked to any new card issued from that c Follow the step-by-step guide to configure insurance on your card product. ::: -## Card insurance {#insurance} +## Card packages {#insurance} Swan offers different levels of insurance on cards, providing extra protection for cardholders. The level of coverage is defined as part of the card package configured on the Card Product. Insurance can't be added to existing cards. To add insurance, you must issue a new card using a card product that is configured with the desired package. @@ -69,7 +69,7 @@ Insurance is not retroactive. Existing cards won't be updated automatically. To ### Card insurance coverage {#insurance-coverage} -The following tables outline the card insurance coverage included with Swan cards. +The following tables outline the Card packages coverage included with Swan cards. :::info Specific coverage Specific coverage varies by **insurance plan**. To consult the details of a card's insurance coverage, please **request the terms and conditions notice** directly from your PIM (Product Integration Manager). @@ -123,7 +123,7 @@ Specific coverage varies by **insurance plan**. To consult the details of a card -### Card insurance billing {#insurance-billing} +### Card packages billing {#insurance-billing} Pricing varies by insurance level (Standard, Essential, Premium). Partners are billed monthly for active insurance subscriptions. For specific pricing details, refer to your terms and conditions or submit a request to Swan Support. @@ -141,7 +141,7 @@ The subscription progresses through these statuses in order: **Pending** → **P Insurance subscription creation only happens when the account membership is `Enabled` and the account holder verification status is `Verified`. The creation of a subscription may be **delayed** until these conditions are met. ::: -:::info Card insurance activation +:::info Card packages activation Once subscribed, the insurance is automatically activated. Your user can view the insurance notice, and access the URL to the insurance claims portal through their Web Banking interface. ::: @@ -244,4 +244,4 @@ The following table outlines how to report different claim types: ## Guides {#guides} -- [Configure card insurance package](guide-insurance-integration.mdx) \ No newline at end of file +- [Configure Card packages package](guide-packages-integration.mdx) \ No newline at end of file diff --git a/redirects.js b/redirects.js index be13ff22d4d..9f7bc5f2007 100644 --- a/redirects.js +++ b/redirects.js @@ -454,6 +454,14 @@ module.exports = [ from: '/preview/belgian-ibans', to: '/topics/accounts/ibans/#local', }, + { + from: '/preview/card-insurance/', + to: '/topics/cards/card-packages', + }, + { + from: '/preview/card-insurance/guide-insurance-integration', + to: '/topics/cards/card-packages/guide-packages-integration', + }, { from: '/preview/belgian-ibans/belgian-ibans', to: '/topics/accounts/ibans/#local', diff --git a/sidebars.js b/sidebars.js index 1bc54339f42..6e79c7cb88b 100644 --- a/sidebars.js +++ b/sidebars.js @@ -239,11 +239,11 @@ module.exports = { }, { type: "category", - label: "Card insurance", - link: { type: "doc", id: "topics/cards/card-insurance/index" }, + label: "Card packages", + link: { type: "doc", id: "topics/cards/card-packages/index" }, collapsed: true, items: [ - "topics/cards/card-insurance/guide-insurance-integration", + "topics/cards/card-packages/guide-packages-integration", ], }, { From f8f4101051ebbc827e193f2f52653693e7d8aea7 Mon Sep 17 00:00:00 2001 From: ntombing Date: Thu, 12 Mar 2026 19:04:15 +0100 Subject: [PATCH 10/15] Updated config and retrieval guides --- .../topics/cards/configure-card-package.png | Bin 0 -> 117033 bytes .../guide-get-card-package-details.mdx | 42 +++++++++++++ .../guide-packages-integration.mdx | 58 +++++++----------- 3 files changed, 64 insertions(+), 36 deletions(-) create mode 100644 docs/images/topics/cards/configure-card-package.png create mode 100644 docs/topics/cards/card-packages/guide-get-card-package-details.mdx diff --git a/docs/images/topics/cards/configure-card-package.png b/docs/images/topics/cards/configure-card-package.png new file mode 100644 index 0000000000000000000000000000000000000000..2ca654965c171beb7b1fc7bf793352493b388f14 GIT binary patch literal 117033 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%0D9LyakU$L-DmT_o6 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%0D*V%p3zhPBp$oMj^q} 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 I@0dROAAmHWZ2$lO literal 0 HcmV?d00001 diff --git a/docs/topics/cards/card-packages/guide-get-card-package-details.mdx b/docs/topics/cards/card-packages/guide-get-card-package-details.mdx new file mode 100644 index 00000000000..f81393f3987 --- /dev/null +++ b/docs/topics/cards/card-packages/guide-get-card-package-details.mdx @@ -0,0 +1,42 @@ +--- +title: Get card package level +--- + +# Get card package level + +Card products are associated with a specific package level: Standard, Essential and Premium. You can retrieve the package level for a specific card using the card query. + +## Prerequisites + +## Main IBAN {#guide-main} + +1. Call the `RetrieveCardPackage` query. +1. Enter the `cardId`. +1. Add `cardPackage` to receive the card package level. + +

Query

+ +Open in API Explorer + +```graphql {2} showLineNumbers +query RetrieveCardPackage { + card(cardId: "$YOUR_CARD_ID") { + id + cardPackage + } +} +``` +

Payload

+ +1. The response includes the `cardPackage` (line 4), which is `Premium`. + +```json {4} showLineNumbers +{ + "data": { + "card": { + "id": "$YOUR_CARD_ID", + "cardPackage": Premium + } + } +} +``` diff --git a/docs/topics/cards/card-packages/guide-packages-integration.mdx b/docs/topics/cards/card-packages/guide-packages-integration.mdx index f95e9dbc4c5..3cb0af01030 100644 --- a/docs/topics/cards/card-packages/guide-packages-integration.mdx +++ b/docs/topics/cards/card-packages/guide-packages-integration.mdx @@ -1,52 +1,38 @@ --- -title: Configure Card packages package +title: Configure a card package --- -:::caution No coverage for existing cards -Card packages is currently in private beta. -::: - -This guide explains how to configure insurance on card products, issue cards with insurance, support Card packages claims. +When creating a new card product in the Dashboard, your first step is selecting and configuring the card package. +This selection determines the features, pricing, and capabilities of the card available to your users. -## 1. Configure insurance on card products +This guide explains how to configure card packages on card products. -When creating a card product, link it to a Card packages object by setting the [`defaultInsurancePackage`](https://api-reference.swan.io/objects/card-packages-configuration/#cardinsuranceconfigurationdefaultinsurancepackagecardinsurancepackage). -This package is automatically applied when a card is issued. +## Create a card package card {#create} -The `availableInsurancePackages` field lists all eligible insurance packages for the card product. +1. Go to **Dashboard** > **Settings** > **Cards**. +1. Select **+ New card product**. -By default, new card products include three packages: **Basic**, **Essential**, and **Premium**. For pre-existing card products, contact your PIM (Product Integration Manager) to add the `availableInsurancePackages` and set your `defaultInsurancePackage`. +![Screenshot of the Dashboard modal to add a new card product](../../../images/topics/cards/configure-card-package.png) -## 2. Card product review and validation - -After configuring your insurance settings, your PIM will review and validate the card product before it can be used. +3. Select a card package: choose between **Standard**, **Essential**, or **Premium**. +Select **No package** for to offer a card with basic features (no insurance and our standard spending limits and foreign exchange fees). :::caution -To issue cards with insurance, it's mandatory to display the [standard marketing and legal mentions](https://docs.google.com/presentation/d/159nE02OtxcZ_uVQIpX8H7fLVC9VubPAf/edit?slide=id.g33c8ca1d644_0_302#slide=id.g33c8ca1d644_0_302) regarding the insurance coverage package within your app or website. Swan includes this information in the Terms and Conditions. +This choice is permanent. You can't modify the package level once the card product is created. ::: -## 3. Card packages subscription - -Swan automatically creates a [Card packages subscription](/topics/cards/card-packages/#insurance) when a new card is issued, if the following conditions are met: - -- The cardholder's account membership is `Enabled`. -- The account holder is `Verified`. - -## 4. Support insurance claims - -Include a link to the insurance provider's claims portal in your Web banking app so users can file claims independently. +4. Name your new card product. +5. If you'd like to allow physical cards, toggle **Allow physical cards** to on. +6. Click **Create**. -The `claimsUrl` available in the card query leads to the insurance provider's claims portal. -Use this query to retrieve the `claimsUrl` for a cardholder to access the claims interface: +## Configure your card package design {#configure-design} -Open in API explorer +1. If you'd like to edit your card design, select **+ Create new design**. +1. Choose your card style: Black, Silver or Custom. +1. Choose your logo size. +1. Upload your logo. +1. Submit fo review. +## Card package review and validation -```graphql -query GetClaimsPortalUrl { - card(cardId: "$YOUR_CARD_ID") { - insuranceSubscription { - claimsUrl - } - } -} +After configuring your card package, we will review and validate it before it can be used. From e92ed8e0e848086321a58a730fc95b29c0f47f86 Mon Sep 17 00:00:00 2001 From: ntombing Date: Fri, 13 Mar 2026 10:38:10 +0100 Subject: [PATCH 11/15] Updated sidebar with retrieval guide --- ...card-package-details.mdx => guide-get-card-package-level.mdx} | 0 sidebars.js | 1 + 2 files changed, 1 insertion(+) rename docs/topics/cards/card-packages/{guide-get-card-package-details.mdx => guide-get-card-package-level.mdx} (100%) diff --git a/docs/topics/cards/card-packages/guide-get-card-package-details.mdx b/docs/topics/cards/card-packages/guide-get-card-package-level.mdx similarity index 100% rename from docs/topics/cards/card-packages/guide-get-card-package-details.mdx rename to docs/topics/cards/card-packages/guide-get-card-package-level.mdx diff --git a/sidebars.js b/sidebars.js index 6e79c7cb88b..f909ea4129b 100644 --- a/sidebars.js +++ b/sidebars.js @@ -244,6 +244,7 @@ module.exports = { collapsed: true, items: [ "topics/cards/card-packages/guide-packages-integration", + "topics/cards/card-packages/guide-get-card-package-level", ], }, { From e5569503169e6e3a5a3b9d97f079642314c97afc Mon Sep 17 00:00:00 2001 From: ntombing Date: Fri, 13 Mar 2026 12:41:35 +0100 Subject: [PATCH 12/15] Review and edits --- .../guide-get-card-package-level.mdx | 14 ++- .../guide-packages-integration.mdx | 6 +- docs/topics/cards/card-packages/index.mdx | 102 +++++++++--------- docs/topics/cards/design/index.mdx | 8 +- 4 files changed, 59 insertions(+), 71 deletions(-) diff --git a/docs/topics/cards/card-packages/guide-get-card-package-level.mdx b/docs/topics/cards/card-packages/guide-get-card-package-level.mdx index f81393f3987..9332ba6acf2 100644 --- a/docs/topics/cards/card-packages/guide-get-card-package-level.mdx +++ b/docs/topics/cards/card-packages/guide-get-card-package-level.mdx @@ -4,21 +4,19 @@ title: Get card package level # Get card package level -Card products are associated with a specific package level: Standard, Essential and Premium. You can retrieve the package level for a specific card using the card query. +Card products are associated with a specific card package: **Standard**, **Essential** and **Premium**. You can retrieve the package level for a specific card using the card query. -## Prerequisites +## Retrieve card package level {#guide-main} -## Main IBAN {#guide-main} - -1. Call the `RetrieveCardPackage` query. -1. Enter the `cardId`. -1. Add `cardPackage` to receive the card package level. +1. Call the `RetrieveCardPackage` query (line 1). +1. Enter the `cardId` (line 2). +1. Add `cardPackage` to receive the card package level (line 4).

Query

Open in API Explorer -```graphql {2} showLineNumbers +```graphql {5} showLineNumbers query RetrieveCardPackage { card(cardId: "$YOUR_CARD_ID") { id diff --git a/docs/topics/cards/card-packages/guide-packages-integration.mdx b/docs/topics/cards/card-packages/guide-packages-integration.mdx index 3cb0af01030..9bdfdc78b43 100644 --- a/docs/topics/cards/card-packages/guide-packages-integration.mdx +++ b/docs/topics/cards/card-packages/guide-packages-integration.mdx @@ -7,15 +7,15 @@ This selection determines the features, pricing, and capabilities of the card av This guide explains how to configure card packages on card products. -## Create a card package card {#create} +## Create a card package {#create} 1. Go to **Dashboard** > **Settings** > **Cards**. 1. Select **+ New card product**. ![Screenshot of the Dashboard modal to add a new card product](../../../images/topics/cards/configure-card-package.png) -3. Select a card package: choose between **Standard**, **Essential**, or **Premium**. -Select **No package** for to offer a card with basic features (no insurance and our standard spending limits and foreign exchange fees). +3. Choose between the **Standard**, **Essential**, or **Premium** card packages. +Select **No package** to offer a card with basic features (no insurance, and our standard spending limits and foreign exchange fees). :::caution This choice is permanent. You can't modify the package level once the card product is created. diff --git a/docs/topics/cards/card-packages/index.mdx b/docs/topics/cards/card-packages/index.mdx index 32880b370ef..e203dfff135 100644 --- a/docs/topics/cards/card-packages/index.mdx +++ b/docs/topics/cards/card-packages/index.mdx @@ -1,29 +1,18 @@ --- -title: Card package +title: Card packages --- -:::caution No coverage for existing cards -Card packages is currently in private beta. -::: - -## Card package {#overview} - ### Overview -Card packages are preconfigured tiers that group card features and settings. -They help you launch market-ready offers faster, without configuring every feature individually. +Card packages are preconfigured tailored offers, that help you launch market-ready card products faster. -When you create a Card Product, you select a package (**Standard**, **Essential**, or **Premium**). +When you create a card product, you select a package. Each package includes a predefined set of features and settings: -- **Insurance**: Each package automatically applies a corresponding insurance level to the Card Product: **Standard**, **Essential**, or **Premium** +- **Insurance**: Each package automatically applies a corresponding insurance level to the card product: **Standard**, **Essential**, or **Premium**. - **Spending limits**: Higher tiers unlock higher transaction and withdrawal limits. -- **FX fees**: Higher tiers benefit from reduced or waived foreign exchange fees. -- **Card material**: The standard silver and black card designs are available across tiers. The **metal** card is only available with the **Premium** package. - -:::info Configuration -To implement card packages, see our Card package configuration guide. -::: +- **Foreign exchange (FX) fees**: Higher tiers benefit from reduced or waived FX fees. +- **Card design**: The standard silver and black card designs are available across all packages. The **metal** card is only available with the **Premium** package. ### Card package comparison @@ -32,12 +21,12 @@ To implement card packages, see our Card package configuration guide. | Insurance level | Standard | Essential | Premium | | Spending limits | 10 000 | 40 000 | 100 000 | | Foreign exchange fees* | Standard | Reduced | Waived | -| Card material | Plastic | Plastic | Metal | +| Card design | Plastic: Black or Silver | Plastic: Black or Silver | Metal | -*Note*: Refer to T&Cs for details on FX billing. +*Note: Refer to your T&Cs for details on FX billing.* :::info Availability and rollout -Card packages are available for all new card products created after the feature launch (add date). +Card packages are available for all new card products created after the feature launch (TBC). Currently, insurance and specific package benefits can't be retroactively applied to existing cards. If you wish to offer a card package to existing users, you must create a new card product and issue new cards. ::: @@ -45,34 +34,30 @@ If you wish to offer a card package to existing users, you must create a new car ### Card package configuration {#card-package-configuration} You can assign one of the three standard insurance packages at the card product level. -Once set, the package is automatically linked to any new card issued from that card product. - -:::info Configure your card package -Follow the step-by-step guide to configure insurance on your card product. -::: +Once set, the package is automatically linked to newly issued cards. Read our step-by-step guide to [configure your card package](/topics/cards/card-packages/guide-packages-integration). -## Card packages {#insurance} +## Card insurance {#insurance} -Swan offers different levels of insurance on cards, providing extra protection for cardholders. The level of coverage is defined as part of the card package configured on the Card Product. Insurance can't be added to existing cards. To add insurance, you must issue a new card using a card product that is configured with the desired package. +Swan offers different insurance coverage options on cards, included in the card package associated to the card product. -There are three standard insurance levels available: +There are three insurance coverage options available: -- **Standard** -- **Essential** -- **Premium** +- Standard +- Essential +- Premium -Once an card package is assigned to a card product, all new cards created under that product will automatically include the chosen insurance by default. +Once a card package is assigned to a card product, all new cards created under that product will automatically include the chosen insurance coverage. :::caution No coverage for existing cards -Insurance is not retroactive. Existing cards won't be updated automatically. To add insurance, you must issue a new card. +Insurance can't be added to existing cards. To include insurance, you must issue a new card using a product configured with an insurance package. ::: ### Card insurance coverage {#insurance-coverage} -The following tables outline the Card packages coverage included with Swan cards. +The following tables outline the card packages coverage included with Swan cards. :::info Specific coverage -Specific coverage varies by **insurance plan**. To consult the details of a card's insurance coverage, please **request the terms and conditions notice** directly from your PIM (Product Integration Manager). +Specific coverage varies by **insurance plan**. To consult the details of a card's insurance coverage, please consult your **terms and conditions** or submit a request to Swan Support. ::: @@ -124,36 +109,45 @@ Specific coverage varies by **insurance plan**. To consult the details of a card ### Card packages billing {#insurance-billing} -Pricing varies by insurance level (Standard, Essential, Premium). Partners are billed monthly for active insurance subscriptions. +Pricing varies by insurance coverage. Partners are billed monthly for active insurance subscriptions. For specific pricing details, refer to your terms and conditions or submit a request to Swan Support. -## Insurance subscription {#insurance-subscription} +### Insurance subscription {#insurance-subscription} -### Insurance subscription statuses {#subscription-statuses} +:::tip Prerequisites +- Account membership is `Enabled`. +- Account holder verification status is `Verified`. -When a user orders a card package that includes insurance, Swan handles the insurance subscription with our insurance partner. +The creation of a subscription may be **delayed** until these conditions are met. +::: -The subscription status is always tied to the card status: it is created when the card is ordered and canceled when the card is canceled, so you don't need to take any specific action. +When a user orders a card package that includes insurance, Swan handles the insurance subscription with our insurance partner. -The subscription progresses through these statuses in order: **Pending** → **Processing** → **Enabled**, or **Canceled** (if the associated card is canceled). +The subscription progresses through these statuses: `Pending` → `Processing` → `Enabled`, or `Canceled`. -:::caution -Insurance subscription creation only happens when the account membership is `Enabled` and the account holder verification status is `Verified`. The creation of a subscription may be **delayed** until these conditions are met. -::: +The **subscription status** is always tied to the card status: it's `Enabled` when the card is ordered and `Canceled` when the card is canceled. You don't need to take any specific action. :::info Card packages activation -Once subscribed, the insurance is automatically activated. Your user can view the insurance notice, and access the URL to the insurance claims portal through their Web Banking interface. +Once subscribed, the insurance is automatically activated. Your user can view the insurance notice, and access the URL to the insurance claims portal through in Web Banking. ::: ### Card insurance claims {#insurance-claims} -When an eligible event occurs, cardholders should submit a claim through the **insurance claims portal**, or by contacting our assistance provider, depending on the type of claim. +Depending on the type of claim, cardholders can seek support through the Swan, our claims portal, or assistance provider: + +- **Fraud or phishing**: Report directly to Swan. +- **All other claims**: Submit these through the insurance claims portal. +- **Urgent assistance**: Contact our assistance provider (if included in your offer). #### Reporting fraud and phishing {#report-fraud-phishing} -If the cardholder suspects fraud or phishing, they should **report it to Swan**. Swan will help secure the account or card, and guide the cardholder on any additional steps. +When a cardholder reports fraud or phishing to Swan, we will help secure the account or card, and guide the cardholder on any additional steps. + +:::info Card fraud dispute article +Share the dedicated [Support Center article](https://support.swan.io/hc/en-150/articles/17099978406045-Credit-transfer-and-card-payment-fraud-disputes#h_01HQHA9YY8M234ZE7AV1GY6APF) to help your users file their fraud dispute. +::: -#### Standard insurance claims +#### Reporting through the claims portal {#claims-portal} In most cases, cardholders should submit the claim through the insurance claims portal, which is available through cardholder's Web Banking interface. It's typically used for standard claims such as: @@ -165,12 +159,11 @@ It's typically used for standard claims such as: To submit a claim, cardholders must: 1. Create an account in the insurance claims portal using the email linked to their Swan account. -1. On the first login, select Sign up to create a password. +1. On the first login, select "sign up" to create a password. 1. Upload the required documents. -1. Track the progress of their claim in the insurance claims portal. Our **insurance partner handles the entire claims process** after submission. -Cardholders must follow up directly through the portal. +Cardholders must follow up and track the progress of their claim directly through the portal. If compensation is approved, it's credited directly to the cardholder's Swan account. :::info Customized claims portal @@ -179,7 +172,7 @@ By default, the claims management interface provided by our insurance partner is #### Reporting to our assistance provider -Our assistance provider is only available on the Premium card package. They handle urgent claims such as: +Our assistance provider is only available with the **Premium** card package. They handle urgent claims such as: - Medical emergencies - Repatriation - Hospitalisation @@ -187,7 +180,7 @@ Our assistance provider is only available on the Premium card package. They hand These must be reported **by phone** for immediate support. -They handle the entire claims process. +Our assistance provider handles the entire claims process. If compensation is approved, it's credited directly to the cardholder's Swan account. ### Claim types and reporting process {#insurance-claims-process} @@ -244,4 +237,5 @@ The following table outlines how to report different claim types: ## Guides {#guides} -- [Configure Card packages package](guide-packages-integration.mdx) \ No newline at end of file +- [Configure card package](guide-packages-integration.mdx) +- [Retrieve card package level](guide-packages-integration.mdx) \ No newline at end of file diff --git a/docs/topics/cards/design/index.mdx b/docs/topics/cards/design/index.mdx index 52f500bde6d..62b07c06b6e 100644 --- a/docs/topics/cards/design/index.mdx +++ b/docs/topics/cards/design/index.mdx @@ -39,13 +39,9 @@ Silver cards feature your logo in **black monochrome**. ### Metal -Metal cards are available as part of the Premium card package. +Metal cards are available with the **Premium** card package. The cards are made from **stainless steel and tungsten** and weigh 22 grams. They feature a textured dark protective layer on each side and exposed metal edges. Your logo will be laser-printed on the cards, revealing the metal underneath. -These 22-gram cards are made from stainless steel and tungsten, with a slightly textured dark protective layer on each side and exposed metal edges. - -Your logo will be laser-printed on the cards, revealing the metal underneath. - -Card design example is not yet available. +*Note: Card design example is not yet available.* ## Custom card design {#custom} From d3f0877d355b519c8f8d5675a6be2bea1cc28f7b Mon Sep 17 00:00:00 2001 From: ntombing Date: Fri, 13 Mar 2026 14:30:18 +0100 Subject: [PATCH 13/15] Billing entry --- docs/topics/accounts/billing/index.mdx | 1 + docs/topics/cards/card-packages/index.mdx | 16 +++++++++++----- 2 files changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/topics/accounts/billing/index.mdx b/docs/topics/accounts/billing/index.mdx index 5ae1c02b1ac..bf4fc1516f6 100644 --- a/docs/topics/accounts/billing/index.mdx +++ b/docs/topics/accounts/billing/index.mdx @@ -95,6 +95,7 @@ The following table lists each billable metric and the event that triggers billi | | Card subscriptions | Virtual cards `Enabled` at least one day during the billing period. | | | Card transactions | Number of card-out booked transactions (including Apple Pay). | | | Card products | Number of card products `Enabled` for a project. Monthly fees still apply to `Suspended` card products that have at least one `Enabled` card. | +| | Foreign exchange (FX) fees | Transactions for goods and services (in-store or online) purchased in non-euro currencies. | | | Physical cards printing & shipping | Number of cards shipped during the billing period. | | | Single-use virtual (SUV) cards | Number of SUV cards created during the billing period. | | **SEPA** | SEPA transactions | Number of transactions booked during the billing period (Instant SCT, SCT, SDD Core, SDD B2B). | diff --git a/docs/topics/cards/card-packages/index.mdx b/docs/topics/cards/card-packages/index.mdx index e203dfff135..f4281d98302 100644 --- a/docs/topics/cards/card-packages/index.mdx +++ b/docs/topics/cards/card-packages/index.mdx @@ -19,7 +19,7 @@ Each package includes a predefined set of features and settings: | Feature | Standard | Essential | Premium | | --- | --- | --- | --- | | Insurance level | Standard | Essential | Premium | -| Spending limits | 10 000 | 40 000 | 100 000 | +| Spending limits | €10 000 | €40 000 | €100 000 | | Foreign exchange fees* | Standard | Reduced | Waived | | Card design | Plastic: Black or Silver | Plastic: Black or Silver | Metal | @@ -57,7 +57,7 @@ Insurance can't be added to existing cards. To include insurance, you must issue The following tables outline the card packages coverage included with Swan cards. :::info Specific coverage -Specific coverage varies by **insurance plan**. To consult the details of a card's insurance coverage, please consult your **terms and conditions** or submit a request to Swan Support. +Specific coverage varies by **insurance plan**. To consult the details of a card's insurance coverage, please consult your **terms and conditions (T&Cs)** or submit a request to Swan Support. ::: @@ -109,8 +109,14 @@ Specific coverage varies by **insurance plan**. To consult the details of a card ### Card packages billing {#insurance-billing} -Pricing varies by insurance coverage. Partners are billed monthly for active insurance subscriptions. -For specific pricing details, refer to your terms and conditions or submit a request to Swan Support. + +Partner billing varies by card package and contract. + +- Insurance: Billed monthly per active subscription; rates vary by coverage level. +- FX Fees: Applied per transaction, depending on your specific card package and Swan contract. +- Physical Cards: One-time fee for printing and shipping. + +Refer to your T&Cs or submit a request to Swan Support for specific pricing. ### Insurance subscription {#insurance-subscription} @@ -133,7 +139,7 @@ Once subscribed, the insurance is automatically activated. Your user can view th ### Card insurance claims {#insurance-claims} -Depending on the type of claim, cardholders can seek support through the Swan, our claims portal, or assistance provider: +Depending on the type of claim, cardholders can seek support through the Swan, our claims portal, or our emergency assistance provider: - **Fraud or phishing**: Report directly to Swan. - **All other claims**: Submit these through the insurance claims portal. From ba13728002ba247a63cfb415d64e256962f974a2 Mon Sep 17 00:00:00 2001 From: ntombing Date: Fri, 13 Mar 2026 14:37:16 +0100 Subject: [PATCH 14/15] Update guide --- .../topics/cards/card-packages/guide-get-card-package-level.mdx | 2 +- docs/topics/cards/card-packages/index.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/topics/cards/card-packages/guide-get-card-package-level.mdx b/docs/topics/cards/card-packages/guide-get-card-package-level.mdx index 9332ba6acf2..8da01ef1381 100644 --- a/docs/topics/cards/card-packages/guide-get-card-package-level.mdx +++ b/docs/topics/cards/card-packages/guide-get-card-package-level.mdx @@ -16,7 +16,7 @@ Card products are associated with a specific card package: **Standard**, **Essen Open in API Explorer -```graphql {5} showLineNumbers +```graphql {1-2,4} showLineNumbers query RetrieveCardPackage { card(cardId: "$YOUR_CARD_ID") { id diff --git a/docs/topics/cards/card-packages/index.mdx b/docs/topics/cards/card-packages/index.mdx index f4281d98302..e5faa3d3b43 100644 --- a/docs/topics/cards/card-packages/index.mdx +++ b/docs/topics/cards/card-packages/index.mdx @@ -244,4 +244,4 @@ The following table outlines how to report different claim types: ## Guides {#guides} - [Configure card package](guide-packages-integration.mdx) -- [Retrieve card package level](guide-packages-integration.mdx) \ No newline at end of file +- [Retrieve card package level](guide-get-card-package-level.mdx) \ No newline at end of file From b8a51366f326822a6f9c7c44bfe0e8f45b0d6a41 Mon Sep 17 00:00:00 2001 From: ntombing Date: Fri, 13 Mar 2026 14:51:17 +0100 Subject: [PATCH 15/15] Links to relevant sections --- docs/topics/cards/index.mdx | 35 ++++------------------------------- 1 file changed, 4 insertions(+), 31 deletions(-) diff --git a/docs/topics/cards/index.mdx b/docs/topics/cards/index.mdx index 01d05167938..833504bfef7 100644 --- a/docs/topics/cards/index.mdx +++ b/docs/topics/cards/index.mdx @@ -124,40 +124,13 @@ You must have one dedicated card product per hub, though the designs can be iden ### Card packages -Card packages are preconfigured tiers that group card features and settings. -They help you launch market-ready offers faster, without configuring every feature individually. - -When you create a Card Product, you select a package (**Standard**, **Essential**, or **Premium**). -Each package includes a predefined set of features and settings: - -- **Insurance**: Each package automatically applies a corresponding insurance level to the Card Product: **Standard**, **Essential**, or **Premium** -- **Spending limits**: Higher tiers unlock higher transaction and withdrawal limits. -- **FX fees**: Higher tiers benefit from reduced or waived foreign exchange fees. -- **Card material**: The standard silver and black card designs are available across tiers. The **metal** card is only available with the **Premium** package. - -:::info Configuration -To implement card packages, see our Card package configuration guide. -::: - -Card package comparison - -| Feature | Standard | Essential | Premium | -| --- | --- | --- | --- | -| Insurance level | Standard | Essential | Premium | -| Spending limits | Standard | Higher | Highest | -| Foreign exchange fees | Standard | Reduced | Waived | -| Card material | Plastic | Plastic | Metal | - -:::info Availability and rollout -Card packages are available for all new card products created after the feature launch (add date). -Currently, insurance and specific package benefits can't be retroactively applied to existing cards. -If you wish to offer a card package to existing users, you must create a new card product and issue new cards. -::: +When you create a card product, you select a [card package](/topics/cards/card-packages): **Standard**, **Essential**, or **Premium**. +Each package includes a predefined set of features and settings. ### Card insurance -Swan offers different insurance levels to protect cardholders, providing them extra protection. -Insurance is configured through the selected **card package**. When you choose a package during Card Product creation, the corresponding coverage is automatically enabled for all cards issued under that Card Product. +Swan offers [insurance coverage](/topics/cards/card-packages/#insurance) to protect cardholders. +Insurance is configured through the selected **card package** and the coverage corresponds with the card package level. ## Settings {#settings}