diff --git a/src/content/docs/tools/glossary/countries-and-currencies.mdx b/src/content/docs/tools/glossary/countries-and-currencies.mdx new file mode 100644 index 00000000..3e96ad33 --- /dev/null +++ b/src/content/docs/tools/glossary/countries-and-currencies.mdx @@ -0,0 +1,282 @@ +--- +title: Countries and Currencies +description: Default merchant-account currencies for countries where SumUp operates. +sidebar: + order: 30 +--- + +import Callout from "@components/content/Callout"; +import SearchableTable from "@components/content/SearchableTable"; + +A SumUp merchant account has a default currency based on the country where the +merchant is registered. When an API request requires a currency, use the +merchant account's `default_currency` in the format defined by +[ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). + + + This table describes merchant-account markets and currencies, not universal + product availability. An API, SDK, payment method, or card reader might + support fewer countries or currencies. Check the relevant product guide and + API schema before building an integration. + + +## Supported countries and currencies + +The country coverage follows SumUp's current +[list of markets](https://www.sumup.com/en-us/press/). Search by country name, +country code, currency, or currency code. + + + +## Use the correct currency in an integration + +1. Retrieve the merchant account and read its `default_currency` from the + [Retrieve a Merchant endpoint](/api/merchants/get/). +2. Send that value in payment requests that require a currency, such as + [Create a Checkout](/api/checkouts/create/). +3. Confirm that the value is accepted by the endpoint's current API schema and + that the product is available for the merchant's country. + +For online payments, also use the payment methods returned for the checkout +rather than assuming that every method is available for a country or currency. +See [Payment methods](/online-payments/payment-methods/). diff --git a/src/content/help/affiliate-key.mdx b/src/content/help/affiliate-key.mdx index d91b9460..cc56da52 100644 --- a/src/content/help/affiliate-key.mdx +++ b/src/content/help/affiliate-key.mdx @@ -1,5 +1,7 @@ --- -title: How do I retrieve an affiliate key? +title: How do I create an Affiliate Key? --- -You need to create your key by logging in to the Developer page of the [SumUp Dashboard](https://me.sumup.com/developers). Details on its implementation can be found in our [step-by-step guide](/terminal-payments). +Open [Developer Settings](https://me.sumup.com/settings/developer) in the SumUp Dashboard, then go to **For Developers** > **Toolkit** > **Affiliate Keys**. Enter an application identifier that matches your app ID or bundle ID, then select **Add**. + +An Affiliate Key identifies your card-present integration; it does not authorize API requests. Follow the [Affiliate Keys guide](/tools/authorization/affiliate-keys/) for creation steps, credential requirements, and request examples. diff --git a/src/content/help/oauth-credentials.mdx b/src/content/help/oauth-credentials.mdx index e39de237..e8385434 100644 --- a/src/content/help/oauth-credentials.mdx +++ b/src/content/help/oauth-credentials.mdx @@ -2,4 +2,6 @@ title: How do I set up OAuth credentials? --- -You can create credentials by logging in on the [SumUp Developer](https://me.sumup.com/developers) page and navigating to the "Create Client Credentials" section. Detailed information on how to authenticate further can be found in our [step-by-step guide](/tools/authorization/oauth/#steps) or in this [video](https://www.youtube.com/watch?v=0ALwF_tm8wII). +Open the [OAuth apps page](https://me.sumup.com/settings/oauth2-applications) in the SumUp Dashboard and select **Create application**. After registering the application, open it and select **Create client secret**. + +Follow the [OAuth application registration guide](/tools/authorization/oauth/#register-an-oauth-application) for redirect URI, scope, and credential-storage requirements. diff --git a/src/content/help/support-libraries.mdx b/src/content/help/support-libraries.mdx index 95b29934..33075c8f 100644 --- a/src/content/help/support-libraries.mdx +++ b/src/content/help/support-libraries.mdx @@ -9,13 +9,13 @@ SumUp maintains multiple SDKs and APIs to simplify your integration work across - [JavaScript / TypeScript, Go, Python, Java, PHP, .NET, and Rust SDK guides](/tools/sdks/) cover server-to-SumUp API calls for online payments and remote Solo reader management through the Cloud API. - Use these when you’re building checkout pages, recurring billing, or card-present integrations from a backend or platform that can make API requests. -## Card-present SDKs +## Card-Present Integrations - [Android SDK](https://github.com/sumup/sumup-android-sdk) and [iOS SDK](https://github.com/sumup/sumup-ios-sdk) let you embed our reader experience inside native apps. -- [Android URL scheme](https://github.com/sumup/sumup-android-url-scheme) and [iOS URL scheme](https://github.com/sumup/sumup-ios-url-scheme) are lightweight options for launching the SumUp app to take a payment. -- See the [terminal payments docs](/terminal-payments/) for installation and certification requirements. +- [Payment Switch](/terminal-payments/payment-switch/) provides Android and iOS URL schemes for launching the SumUp app. It is a legacy fallback for integrations that cannot use the native SDKs or Cloud API. +- See the [terminal payments comparison](/terminal-payments/#choose-your-integration) before choosing an integration, then follow its canonical implementation guide. -## Cloud API for Solo readers +## Cloud API for Supported Readers -- The [Cloud API](/terminal-payments/cloud-api/) triggers card-present transactions on Solo readers from any backend or platform that can make HTTPS calls. +- The [Cloud API](/terminal-payments/cloud-api/) triggers card-present transactions on supported readers from any backend or platform that can make HTTPS calls. - Use it when your POS runs on web, desktop, or another environment that can’t embed the native Android/iOS SDKs but still needs in-person payments. diff --git a/src/content/help/supported-currencies.mdx b/src/content/help/supported-currencies.mdx index cf9894b1..2cacc533 100644 --- a/src/content/help/supported-currencies.mdx +++ b/src/content/help/supported-currencies.mdx @@ -1,19 +1,9 @@ --- -title: Which currencies are supported by SumUp? +title: Which currency should I use for a payment? --- -We provide support coverage on three continents and in the following currencies: +Use the default currency of the merchant account receiving the payment. The currency in a checkout or reader-payment request must match that merchant account; it is not a per-transaction settlement-currency choice. -- EUR -- GBP -- USD -- BRL -- CLP -- PLN -- CHF -- SEK -- CZK -- NOK -- DKK -- HUF -- BGN +Currency availability depends on the merchant's registered country and the product or payment method being used. For online payments, use a value accepted by the [`currency` field in Create a Checkout](/api/checkouts/create/) and check [payment-method availability](/online-payments/payment-methods/) for the merchant and checkout. For in-person payments, use the merchant account currency and confirm that the selected reader and integration are available in that market. + +For a country-by-country reference, see [Countries and Currencies](/tools/glossary/countries-and-currencies/). When building a payment request, do not derive the value from that table. Read the merchant account's `default_currency` through the [Retrieve a Merchant endpoint](/api/merchants/get/) or from the SumUp Dashboard, and use that value. diff --git a/src/content/help/supported-os.mdx b/src/content/help/supported-os.mdx index b06b9cee..d169c5f0 100644 --- a/src/content/help/supported-os.mdx +++ b/src/content/help/supported-os.mdx @@ -1,5 +1,11 @@ --- -title: Which operating systems are supported by SumUp card readers? +title: Which operating systems support SumUp in-person integrations? --- -The SumUp card readers support iOS & Android. +Platform support depends on the integration you choose: + +- [Cloud API](/terminal-payments/cloud-api/) works with web, desktop, and other server-capable platforms that can make HTTPS requests. The payment is completed on a supported reader. +- [Terminal SDKs](/terminal-payments/sdks/) are available for native Android and iOS applications. +- [Payment Switch](/terminal-payments/payment-switch/) supports Android and iOS app handoff as a legacy fallback. + +Reader compatibility and market availability also vary. Use the [in-person payments comparison](/terminal-payments/#choose-your-integration) and [reader compatibility table](/terminal-payments/#reader-compatibility) before choosing a platform and reader. diff --git a/src/content/help/terminal-standalone-setup.mdx b/src/content/help/terminal-standalone-setup.mdx index 10d92147..0dc88b19 100644 --- a/src/content/help/terminal-standalone-setup.mdx +++ b/src/content/help/terminal-standalone-setup.mdx @@ -2,4 +2,6 @@ title: Do SumUp card readers work in a standalone setup? --- -Our devices are designed to follow a payment flow that doesn’t allow them to operate unattended. +Some do. [Solo](/terminal-payments/readers/solo/) has its own touchscreen and connectivity, so merchants can take payments without a paired phone or tablet. Other readers, such as [Solo Lite](/terminal-payments/readers/solo-lite/), require a compatible companion device. + +For a web-based, desktop, kiosk, or server-driven integration, use the [Cloud API](/terminal-payments/cloud-api/) with a supported reader. If by "standalone" you mean an unattended or self-service deployment, confirm the requirements for your reader, market, and commercial setup with SumUp before implementation; standalone operation does not by itself establish suitability for unattended use. diff --git a/src/content/help/web-app-terminal-communication.mdx b/src/content/help/web-app-terminal-communication.mdx index 49fac0f3..b076627d 100644 --- a/src/content/help/web-app-terminal-communication.mdx +++ b/src/content/help/web-app-terminal-communication.mdx @@ -2,4 +2,6 @@ title: Can my web app communicate with SumUp devices? --- -Yes. For web applications running on mobile devices where the SumUp app is installed, you can call the SumUp app via URL. Read more on this preferred merchant approach in our [API Payment Switch](/terminal-payments/payment-switch/) guide. +Yes. For a web-based or server-driven point of sale, use the [Cloud API](/terminal-payments/cloud-api/). Your backend makes authenticated HTTPS requests to start a payment on a supported reader, so the integration can run on any server-capable platform. Keep secret API keys out of browser code. + +If a mobile web application must hand off the payment to the installed SumUp app, [Payment Switch](/terminal-payments/payment-switch/) remains available as a legacy fallback. It is not the preferred path for new web integrations.