Skip to content
Merged
20 changes: 12 additions & 8 deletions changelog/network/2026/additions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,25 +13,25 @@

| **Brand Name** |
| :------------- |
| Zalando |

Check warning on line 16 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L16

Did you really mean 'Zalando'?

## Lithuania

| **Brand Name** |
| :------------- |
| Zalando |

Check warning on line 22 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L22

Did you really mean 'Zalando'?

## Latvia

| **Brand Name** |
| :------------- |
| Zalando |

Check warning on line 28 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L28

Did you really mean 'Zalando'?

## Estonia

| **Brand Name** |
| :------------- |
| Zalando |

Check warning on line 34 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L34

Did you really mean 'Zalando'?

## Luxembourg

Expand All @@ -47,15 +47,19 @@

## United States

| **Brand Name** |
| :------------- |
| Adam & Eve |
| **Brand Name** |
| :----------------------- |
| Adam & Eve |
| Visa Reload Card USD |
| Visa Reward Card 3M USD |
| Visa Reward Card 6M USD |
| Visa Reward Card 12M USD |

## United Kingdom

| **Brand Name** |
| :------------- |
| Cadbury |

Check warning on line 62 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L62

Did you really mean 'Cadbury'?

## Australia

Expand All @@ -69,14 +73,14 @@

| **Brand Name** |
| :------------- |
| Eram |

Check warning on line 76 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L76

Did you really mean 'Eram'?
| Animalis |

Check warning on line 77 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L77

Did you really mean 'Animalis'?
| Joué Club |
| Furet de Nord |

Check warning on line 79 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L79

Did you really mean 'Furet'?

Check warning on line 79 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L79

Did you really mean 'Nord'?
| Passion Beauté |
| Kiabi |

Check warning on line 81 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L81

Did you really mean 'Kiabi'?
| Billabong |
| Havas |

Check warning on line 83 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L83

Did you really mean 'Havas'?

# February 2026

Expand All @@ -92,43 +96,43 @@

| **Brand Name** |
| :------------- |
| Wolt |

Check warning on line 99 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L99

Did you really mean 'Wolt'?

## Sweden

| **Brand Name** |
| :------------- |
| Wolt |

Check warning on line 105 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L105

Did you really mean 'Wolt'?

## Luxembourg

| **Brand Name** |
| :------------- |
| Wolt |

Check warning on line 111 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L111

Did you really mean 'Wolt'?

## Finland

| **Brand Name** |
| :------------- |
| Wolt |

Check warning on line 117 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L117

Did you really mean 'Wolt'?

## Denmark

| **Brand Name** |
| :------------- |
| Wolt |

Check warning on line 123 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L123

Did you really mean 'Wolt'?

## Germany

| **Brand Name** |
| :------------- |
| Wolt |

Check warning on line 129 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L129

Did you really mean 'Wolt'?

## Austria

| **Brand Name** |
| :------------- |
| Wolt |

Check warning on line 135 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L135

Did you really mean 'Wolt'?

## Ireland

Expand All @@ -148,22 +152,22 @@

| **Brand Name** |
| -------------- |
| Albert Heijn |

Check warning on line 155 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L155

Did you really mean 'Heijn'?
| Tinder |

## Netherlands

| **Brand Name** |
| :------------- |
| Albert Heijn |

Check warning on line 162 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L162

Did you really mean 'Heijn'?

## United States
## United States

| **Brand Name** |
| :--------------------------- |
| Unleashed Brands [Urban Air] |
| GCM |
| Mugsy |

Check warning on line 170 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L170

Did you really mean 'Mugsy'?

## Norway

Expand All @@ -189,7 +193,7 @@
| :------------- |
| Tinder |

## Portugal
## Portugal

| **Brand Name** |
| :------------- |
Expand All @@ -199,25 +203,25 @@

| **Brand Name** |
| :------------- |
| Jacqui E |

Check warning on line 206 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L206

Did you really mean 'Jacqui'?
| Champion |
| Everlast |

Check warning on line 208 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L208

Did you really mean 'Everlast'?
| Hush Puppies |
| Reebok |
| Shoes & Sox |

Check warning on line 211 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L211

Did you really mean 'Sox'?
| Superdry |

Check warning on line 212 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L212

Did you really mean 'Superdry'?

## New Zealand
## New Zealand

| **Brand Name** |
| :------------- |
| Jacqui E |

Check warning on line 218 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L218

Did you really mean 'Jacqui'?

## France
## France

| **Brand Name** |
| :------------- |
| Naturalia |

Check warning on line 224 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L224

Did you really mean 'Naturalia'?
| E-Recycle |

## Germany
Expand All @@ -230,10 +234,10 @@

| **Brand Name** |
| :------------- |
| Jysk |

Check warning on line 237 in changelog/network/2026/additions.mdx

View check run for this annotation

Mintlify / Mintlify Validation (runa) - vale-spellcheck

changelog/network/2026/additions.mdx#L237

Did you really mean 'Jysk'?

## United Kingdom

| **Brand Name** |
| :------------- |
| TJ Jones |
| TJ Jones |
8 changes: 8 additions & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,14 @@
"features/pay-to-card/testing",
"features/pay-to-card/support"
]
},
{
"group": "Prepaid Visa Cards",
"icon": "credit-card",
"pages": [
"features/prepaid-visa/introduction",
"features/prepaid-visa/support"
]
}
]
},
Expand Down
127 changes: 127 additions & 0 deletions features/prepaid-visa/introduction.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
---
title: "Using Prepaid Visa Cards"
description: "Send funds to recipients via instantly delivered, digital Visa prepaid cards."
icon: "credit-card"
---

Runa Prepaid Cards are instantly delivered, digital Visa prepaid cards that recipients can spend online or in-store anywhere Visa is accepted. They are sent through the same ordering flow as any other payout on the Runa Network.

- **No bank account needed**: Perfect for users without access to traditional financial tools
- **Custom branding options**: Make every payout feel personal and on-brand with a fully customizable experience
- **Two prepaid options**: Enable both the Runa Reward Card and the Runa Reload Card for your business needs

<Info>
To get access to Prepaid Visa Cards, please reach out to your Account Manager or
email support@runa.io.
</Info>

## Card types

| | Runa Reload Card | Runa Reward Card |
|---|---|---|
| **Type** | Reloadable | Single-load |
| **Expiry** | 47 months from first activation | 3, 6, or 12 months from first activation |
| **Product code** | `VISARL-USD` | `VISASL-3M-USD`, `VISASL-6M-USD`, `VISASL-12M-USD` |

<Warning>
For Reload Cards, recipients must use the same email address the card was originally sent to. Future top-ups will fail if a different email is used.
</Warning>

## Getting started

- Ensure you have [created an API key](/getting-started/api-key).
- Ensure you have funded your account with the required balance to cover the cards you intend to issue. You can use the [balance endpoint](/reference/2024-02-05/endpoint/balance/get) to check your account balance.
- Retrieve the Prepaid Visa Card products using the [product list endpoint](/reference/2024-02-05/endpoint/products/list). Each Prepaid Visa Card product supports a different use case (reward or reload), and Reward Card products are available with different expiry durations. You can refer to the [product listing guide](/features/product-catalog) for more information on this endpoint.
- Familiarize yourself with the [ordering endpoint](/getting-started/first-order/sync). To make an order for a prepaid card you simply specify the Prepaid Visa Card product code you wish to issue.

## Placing a Prepaid Visa Card order

To place an order you simply specify the Prepaid Visa Card product code you wish to issue.

For our example, we will be using the `VISASL-3M-USD` product code for a $10 Reward Card. The card will be sent to the recipient's email address via the `EMAIL` distribution method.

```http title="Example Prepaid Visa Card order" icon="globe" expandable
POST https://api.runa.io/v2/order
Content-Type: application/json
X-Api-Key: <your API key>

{
"payment_method": {
"type": "ACCOUNT_BALANCE",
"currency": "USD"
},
"items": [
{
"face_value": 10,
"distribution_method": {
"type": "EMAIL",
"email_address": "<your recipient's email address>"
},
"products": {
"type": "SINGLE",
"value": "VISASL-3M-USD"
}
}
]
}
```

### Distribution methods

In the example above we used the `EMAIL` distribution method to send the card to the recipient's email address.

- You can also use the `PAYOUT_LINK` distribution method to receive a link in the API response and handle distribution yourself.

## Reloading a Prepaid Visa Card

For Reload Cards, you can use the `RECIPIENT` distribution method to enable automatic top-ups. Specify a unique `recipient_reference` to identify the recipient. For subsequent orders, use the same `recipient_reference` and we will automatically reload the existing card.

```http title="Example Reload Card order" icon="globe" expandable
POST https://api.runa.io/v2/order
Content-Type: application/json
X-Api-Key: <your API key>

{
"payment_method": {
"type": "ACCOUNT_BALANCE",
"currency": "USD"
},
"items": [
{
"face_value": 10,
"distribution_method": {
"type": "RECIPIENT",
"recipient_reference": "<your unique recipient identifier>",
"email_address": "<your recipient's email address>"
},
"products": {
"type": "SINGLE",
"value": "VISARL-USD"
}
}
]
}
```

Refer to the [order endpoint reference](/reference/2024-02-05/endpoint/orders/create) for more information on the request schema and other options available.

## Recipient redemption experience

### Reward Card

When a recipient opens the payout link, they will immediately see their Visa card and card details. No authentication is required.

Recipients can also view their transaction history, including balances, merchant details, and dates for each transaction.

### Reload Card

When a recipient opens the payout link for the first time, they will be guided through the following flow:

1. Enter their email address to authenticate with Runa
2. Enter their first and last name
3. Set a card PIN
4. View their Visa card details and start spending anywhere Visa is accepted

For subsequent reloads, the card will be automatically topped up with the payout amount. If the recipient wishes to see their card details again, the confirmation email will contain a link where the card details will be securely presented upon authentication.

Recipients can also view their transaction history, including balances, merchant details, and dates for each transaction.
41 changes: 41 additions & 0 deletions features/prepaid-visa/support.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
title: "Support"
description: "Potential error scenarios for Prepaid Visa Cards and their resolution."
icon: "circle-info"
---

Below are potential error scenarios and their resolutions.


### Multiple Payments to Unactivated Card

If a consumer receives multiple payment emails for the same reloadable card, but this card is not activated yet, each email must be opened to load its associated funds.

- When the consumer clicks one link and activates the card, only that payment is loaded.
- To receive the full balance, they must also click the second link (the order doesn't matter).

<Info>
Each payment is attached to its own activation link. The card must first be activated before any funds are loaded.
</Info>

### Add to Wallet

Recipients can add their card to a mobile wallet (Apple Pay, Google Pay, or Samsung Pay) by clicking the **Add to Wallet** button in the UI. A one-time verification code from the wallet provider is required as part of the card tokenisation step.

- **Reward Cards**: The recipient will be asked to provide their email address and optionally their phone number to receive the verification code.
- **Reload Cards**: The email address from authentication is used by default. The recipient can optionally provide their phone number instead.

### Reload Card — recipient using a different email

Recipients must always authenticate with the same email address their Reload Card was originally sent to. Using a different email address will result in the recipient not seeing their funds. Ensure your recipients are aware they must use the same email address each time.

### Insufficient funds

Insufficient balance at order time.

- If your account has insufficient balance you will be unable to create the order for the payment. The API responds with a 400 status code, the error message body will contain the type `insufficient_funds`. Check the [order endpoint reference](/reference/2024-02-05/endpoint/orders/create) for more information.


## All other issues

Your point of contact for any other issues: [support@runa.io](mailto:support@runa.io)
133 changes: 0 additions & 133 deletions features/reloadable-prepaid-card.mdx

This file was deleted.

Loading