feat: restructure content

matoous · matoous · commit ef8eeefc2e19 · 2026-02-13T14:09:50.000+01:00
Address Tatiana's feedback: https://sumup.slack.com/archives/C090ZU2KVPT/p1770893443069369
diff --git a/astro.config.ts b/astro.config.ts
@@ -200,9 +200,13 @@ export default defineConfig({
           autogenerate: { directory: "online-payments", collapsed: true },
         },
         {
-          label: "Common Topics",
+          label: "Developer Resources",
           autogenerate: { directory: "tools", collapsed: true },
         },
+        {
+          label: "SDKs",
+          autogenerate: { directory: "sdks", collapsed: true },
+        },
         {
           label: "Resources",
           autogenerate: { directory: "resources", collapsed: true },
diff --git a/public/_redirects b/public/_redirects
@@ -19,24 +19,34 @@
 /docs/integration-bookings/                                                  /terminal-payments
 
 # Online Payments - Tools & SDKs
-/online-payments/sdks/                                                       /online-payments/checkouts/sdks
-/docs/online-payments/sdks/                                                  /online-payments/checkouts/sdks
-/online-payments/sdks/react-native-sdk/                                      /online-payments/checkouts/react-native-sdk
-/docs/online-payments/sdks/react-native-sdk/                                 /online-payments/checkouts/react-native-sdk
+/tools/sdks/                                                                 /online-payments/sdks
+/docs/tools/sdks/                                                            /online-payments/sdks
+/tools/sdks/nodejs/                                                          /online-payments/sdks/nodejs
+/tools/sdks/go/                                                              /online-payments/sdks/go
+/tools/sdks/python/                                                          /online-payments/sdks/python
+/tools/sdks/java/                                                            /online-payments/sdks/java
+/tools/sdks/php/                                                             /online-payments/sdks/php
+/tools/sdks/php-sdk/                                                         /online-payments/sdks/php
+/tools/sdks/dotnet/                                                          /online-payments/sdks/dotnet
+/tools/sdks/rust/                                                            /online-payments/sdks/rust
+/online-payments/sdks/react-native-sdk/                                      /online-payments/sdks/react-native
+/docs/online-payments/sdks/react-native-sdk/                                 /online-payments/sdks/react-native
 /online-payments/sdks/swift-checkout/                                        /online-payments/checkouts/swift-checkout
 /docs/online-payments/sdks/swift-checkout/                                   /online-payments/checkouts/swift-checkout
-/online-payments/checkouts/sdks/react-native-sdk/                            /online-payments/checkouts/react-native-sdk
-/docs/online-payments/checkouts/sdks/react-native-sdk/                       /online-payments/checkouts/react-native-sdk
+/online-payments/checkouts/react-native-sdk/                                 /online-payments/sdks/react-native
+/docs/online-payments/checkouts/react-native-sdk/                            /online-payments/sdks/react-native
+/online-payments/checkouts/sdks/react-native-sdk/                            /online-payments/sdks/react-native
+/docs/online-payments/checkouts/sdks/react-native-sdk/                       /online-payments/sdks/react-native
 /online-payments/checkouts/sdks/swift-checkout/                              /online-payments/checkouts/swift-checkout
 /docs/online-payments/checkouts/sdks/swift-checkout/                         /online-payments/checkouts/swift-checkout
-/online-payments/tools/react-native-sdk/                                     /online-payments/checkouts/react-native-sdk
+/online-payments/tools/react-native-sdk/                                     /online-payments/sdks/react-native
 /online-payments/tools/hosted-checkout/                                      /online-payments/checkouts/hosted-checkout
 /docs/online-payments/tools/swift-checkout/                                  /online-payments/checkouts/swift-checkout
-/docs/online-payments/tools/php-sdk/                                         /tools/sdks/php-sdk
+/docs/online-payments/tools/php-sdk/                                         /online-payments/sdks/php
 /docs/online-payments/tools/card-widget/                                     /online-payments/checkouts/card-widget
-/docs/php-sdk/                                                               /tools/sdks/php-sdk
-/online-payments/sdks/php-sdk/                                               /tools/sdks/php-sdk
-/docs/online-payments/sdks/php-sdk/                                          /tools/sdks/php-sdk
+/docs/php-sdk/                                                               /online-payments/sdks/php
+/online-payments/sdks/php-sdk/                                               /online-payments/sdks/php
+/docs/online-payments/sdks/php-sdk/                                          /online-payments/sdks/php
 
 # Online Payments - Plugins
 /docs/sumup-woocommerce-plugin/                                              /online-payments/plugins/woocommerce
@@ -78,7 +88,7 @@
 /docs/category/guides/                                                       /online-payments/guides
 /docs/category/alternative-payment-methods/                                  /online-payments/apm
 /docs/category/tools-1/                                                      /terminal-payments/sdks
-/docs/category/tools/                                                        /online-payments/checkouts/sdks
+/docs/category/tools/                                                        /online-payments/sdks
 /docs/category/introduction-1/                                               /terminal-payments
 /docs/category/features/                                                     /online-payments
 
@@ -88,6 +98,7 @@
 /affiliate-keys/                                                             /tools/authorization/affiliate-keys
 /docs/authorization/                                                         /tools/authorization
 /docs/register-app/                                                          /tools/authorization/register-app
+/tools/models/merchant/                                                      /tools/glossary/merchant
 
 # Resources
 /extdev/                                                                     /getting-started
diff --git a/src/content/docs/online-payments/guides/index.mdx b/src/content/docs/online-payments/guides/index.mdx
@@ -3,7 +3,7 @@ title: Custom Integrations
 description: Integration guides for building with SumUp SDKs and APIs.
 sidebar:
   label: Overview
-  order: 149
+  order: 90
 icon: article
 ---
 
diff --git a/src/content/docs/online-payments/guides/refund.mdx b/src/content/docs/online-payments/guides/refund.mdx
@@ -2,7 +2,7 @@
 title: Refunds
 description: Walks through looking up transactions and issuing full or partial refunds.
 sidebar:
-  order: 400
+  order: 92
 ---
 
 import { Aside, Tabs, TabItem } from '@astrojs/starlight/components';
diff --git a/src/content/docs/online-payments/guides/response-handling.mdx b/src/content/docs/online-payments/guides/response-handling.mdx
@@ -2,7 +2,7 @@
 title: Response Handling
 description: Explains how to interpret SumUp API responses.
 sidebar:
-  order: 300
+  order: 93
 ---
 
 ## Overview
diff --git a/src/content/docs/online-payments/guides/single-payment.mdx b/src/content/docs/online-payments/guides/single-payment.mdx
@@ -2,7 +2,7 @@
 title: Accept a Payment
 description: Create and process a checkout for a single card payment.
 sidebar:
-  order: 150
+  order: 91
 ---
 
 import { Aside, Tabs, TabItem } from '@astrojs/starlight/components';
diff --git a/src/content/docs/online-payments/sdks/dotnet.mdx b/src/content/docs/online-payments/sdks/dotnet.mdx
@@ -2,7 +2,7 @@
 title: .NET SDK
 description: Use the official .NET client to talk to every SumUp public API.
 sidebar:
-  order: 45
+  order: 102
 links:
   - title: Source code
     href: https://github.com/sumup/sumup-dotnet
@@ -56,7 +56,7 @@ var checkoutResponse = await client.Checkouts.CreateAsync(new CheckoutCreateRequ
 Console.WriteLine($"Checkout ID: {checkoutResponse.Data?.Id}");
 ```
 
-### Solo Cloud API Checkout
+### Cloud API Checkout
 
 ```csharp
 using SumUp;
diff --git a/src/content/docs/online-payments/sdks/go.mdx b/src/content/docs/online-payments/sdks/go.mdx
@@ -2,7 +2,7 @@
 title: Go SDK
 description: Call the SumUp APIs from idiomatic Go code.
 sidebar:
-  order: 20
+  order: 105
 links:
   - title: Source code
     href: https://github.com/sumup/sumup-go
@@ -63,7 +63,7 @@ func main() {
 }
 ```
 
-### Solo Cloud API Checkout
+### Cloud API Checkout
 
 ```go
 package main
diff --git a/src/content/docs/online-payments/sdks/index.mdx b/src/content/docs/online-payments/sdks/index.mdx
@@ -3,7 +3,7 @@ title: SDKs
 description: Build on SumUp's APIs with officially supported server-side SDKs.
 sidebar:
   label: Overview
-  order: 1
+  order: 100
 ---
 
 SumUp maintains open-source SDKs that wrap the public API and handle the heavy lifting of authentication, pagination, and resource helpers. Each package ships with examples and type definitions so you spend less time wiring HTTP requests and more time on your business logic.
diff --git a/src/content/docs/online-payments/sdks/java.mdx b/src/content/docs/online-payments/sdks/java.mdx
@@ -2,7 +2,7 @@
 title: Java SDK
 description: Use the official Java client to talk to every SumUp public API.
 sidebar:
-  order: 35
+  order: 103
 links:
   - title: Source code
     href: https://github.com/sumup/sumup-java
@@ -82,7 +82,7 @@ var checkout = client.checkouts().createCheckout(request);
 System.out.println(checkout.id());
 ```
 
-### Solo Cloud API Checkout
+### Cloud API Checkout
 
 ```java
 import com.sumup.sdk.SumUpClient;
diff --git a/src/content/docs/online-payments/sdks/nodejs.mdx b/src/content/docs/online-payments/sdks/nodejs.mdx
@@ -2,7 +2,7 @@
 title: Node.js SDK
 description: Use the official TypeScript client to talk to every SumUp public API.
 sidebar:
-  order: 10
+  order: 100
 links:
   - title: Source code
     href: https://github.com/sumup/sumup-ts
@@ -56,7 +56,7 @@ createOnlineCheckout().catch((error) => {
 });
 ```
 
-### Solo Cloud API Checkout
+### Cloud API Checkout
 
 ```ts
 import SumUp from "@sumup/sdk";
diff --git a/src/content/docs/online-payments/sdks/php.mdx b/src/content/docs/online-payments/sdks/php.mdx
@@ -2,7 +2,7 @@
 title: PHP SDK
 description: Introduction to the SumUp PHP SDK and first steps to get you started.
 sidebar:
-  order: 40
+  order: 104
 links:
   - title: Source code
     href: https://github.com/sumup/sumup-php
@@ -59,7 +59,7 @@ try {
 }
 ```
 
-### Solo Cloud API Checkout
+### Cloud API Checkout
 
 ```php
 <?php
@@ -89,7 +89,7 @@ try {
             'foreign_transaction_id' => 'solo-' . time(),
             'key' => getenv('SUMUP_AFFILIATE_KEY'),
         ],
-        'description' => 'Solo Cloud API checkout',
+        'description' => 'Cloud API checkout',
     ];
 
     $checkoutResponse = $sumup->readers->createCheckout(
diff --git a/src/content/docs/online-payments/sdks/python.mdx b/src/content/docs/online-payments/sdks/python.mdx
@@ -2,7 +2,7 @@
 title: Python SDK
 description: Build synchronous or async SumUp integrations with Python.
 sidebar:
-  order: 30
+  order: 101
 links:
   - title: Source code
     href: https://github.com/sumup/sumup-py
@@ -50,7 +50,7 @@ print(checkout.id)
 # Return checkout.id to your webpage so the SumUp card widget can complete the payment.
 ```
 
-### Solo Cloud API Checkout
+### Cloud API Checkout
 
 ```py
 import asyncio
diff --git a/src/content/docs/online-payments/sdks/react-native.mdx b/src/content/docs/online-payments/sdks/react-native.mdx
@@ -1,8 +1,8 @@
 ---
-title: React Native Payment SDK
+title: React Native Checkout SDK
 description: Step-by-step guide for integrating the SumUp React Native Payment SDK, from prerequisites to checkout creation and mounting the payment sheet.
 sidebar:
-  order: 140
+  order: 107
   hidden: true
 ---
 
@@ -27,7 +27,7 @@ Here are the things that you need in order to complete the steps in this guide:
 - The restricted `payment_instruments` scope is enabled for your client application. If it isn't enabled, [contact us](/contact) and request it.
 - Review how to create a single payment [here](https://developer.sumup.com/online-payments/guides/single-payment/#before-you-begin).
 
-### Create a Checkout 
+### Create a Checkout
 
 Initializing the SDK works by passing it a `checkout_id`. To [create a checkout](/api/checkouts/create) on your backend make the following request:
 
@@ -237,7 +237,7 @@ export default function App() {
 }
 ```
 
-## Provide Payment Details 
+## Provide Payment Details
 
 Before showing the payment sheet, it needs to be initialized. Call `initPaymentSheet` with the parameters like in example below:
 
@@ -572,7 +572,7 @@ Obtain an Apple Merchant ID by registering for a new identifier on the Apple Dev
 **Create a new Apple Pay certificate - needs to be implemented.**
 
 To enable Apple Pay in Xcode:
-1. Open your target settings 
+1. Open your target settings
 2. Go to Signing & Capabilities tab
 3. Click on Add Capability button
 4. Select your merchant identifier
diff --git a/src/content/docs/online-payments/sdks/rust.mdx b/src/content/docs/online-payments/sdks/rust.mdx
@@ -2,7 +2,7 @@
 title: Rust SDK
 description: Use the `sumup` crate to access SumUp APIs from Rust.
 sidebar:
-  order: 50
+  order: 106
 links:
   - title: Source code
     href: https://github.com/sumup/sumup-rs
@@ -65,7 +65,7 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
 }
 ```
 
-### Solo Cloud API Checkout
+### Cloud API Checkout
 
 ```rs
 use std::{
diff --git a/src/content/docs/terminal-payments/accept-payments.mdx b/src/content/docs/terminal-payments/accept-payments.mdx
diff --git a/src/content/docs/terminal-payments/sdks/android-sdk.mdx b/src/content/docs/terminal-payments/sdks/android-sdk.mdx
diff --git a/src/content/docs/terminal-payments/sdks/android-ttp.mdx b/src/content/docs/terminal-payments/sdks/android-ttp.mdx
diff --git a/src/content/docs/terminal-payments/sdks/ios-sdk.mdx b/src/content/docs/terminal-payments/sdks/ios-sdk.mdx
diff --git a/src/content/docs/tools/glossary/merchant.mdx b/src/content/docs/tools/glossary/merchant.mdx
diff --git a/src/overrides/SidebarSublist.astro b/src/overrides/SidebarSublist.astro
