Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions src/components/ContactForm.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -63,8 +63,8 @@ const supportCategoryOptions = [
value: "Sales Enquiry",
},
{
label: "Test Account Request",
value: "Test Account Request",
label: "Sandbox Merchant Account Request",
value: "Sandbox Merchant Account Request",
},
{
label: "Online Integration",
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ sidebar:

Welcome to the SumUp Developer Portal. Here you'll find everything you need to integrate SumUp's payment solutions into your product. The documentation is divided into several sections:

- **[Quick start](/docs/quickstart/)** – set up a test account and run through a first payment in minutes.
- **[Quick start](/docs/quickstart/)** – set up a sandbox merchant account and run through a first payment in minutes.
- **[Online Payments](/docs/online-payments/)** – accept card payments on the web or in mobile apps.
- **[Terminal Payments](/docs/terminal-payments/)** – use SumUp card readers to take in-person payments.
- **[Tools](/docs/tools/)** – explore our APIs, SDKs, and other utilities.

Create a [test account](https://me.sumup.com) to experiment safely and then dive into the section that best fits your use case.
Create a [sandbox merchant account](https://me.sumup.com) to experiment safely and then dive into the section that best fits your use case.
2 changes: 1 addition & 1 deletion src/content/docs/online-payments/3ds.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Each of these elements must be independent, to ensure the security of others is

## How It Works

Both the merchant profile and card issuer must support 3-D Secure. The flow adds a checkout step, dependent on the card scheme and issuing bank.​
Both the merchant account and card issuer must support 3-D Secure. The flow adds a checkout step, dependent on the card scheme and issuing bank.​

![Challenge screen](/img/guides/challenge_screen.png)

Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/online-payments/apm/apple-pay.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@ In this guide, you will learn how to directly integrate Apple Pay with SumUp, so

## Prerequisites

- You have a merchant profile with [SumUp](https://me.sumup.com/login) and have already filled in your [profile details](https://me.sumup.com/account).
- You have a SumUp merchant account and have already filled in your [account details](https://me.sumup.com/account).
- Get familiar with [Apple Pay on the Web guide](https://developer.apple.com/documentation/apple_pay_on_the_web).
- Offering Apple Pay requires registering with Apple on all web domains that will expose an Apple Pay button (includes TLD and subdomains). This is a requirement for production AND test environments.
- If you want to test payments without involving real funds, [create a test profile](/online-payments/#getting-a-test-account).
- If you want to test payments without involving real funds, [create a sandbox merchant account](/online-payments/#getting-a-sandbox-merchant-account).
- Complete the domain onboarding setup steps described in your Dashboard under **Settings** > **For developers** > **Payment wallets**.

<Image
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/online-payments/apm/google-pay.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ In this guide, you will learn how to directly integrate Google Pay with SumUp. P

## Prerequisites

- You have a merchant profile with [SumUp](https://me.sumup.com/login) and have already filled in your [profile details](https://me.sumup.com/account).
- If you want to test payments without involving real funds, [create a test profile](/online-payments/#getting-a-test-account).
- You have a SumUp merchant account and have already filled in your [account details](https://me.sumup.com/account).
- If you want to test payments without involving real funds, [create a sandbox merchant account](/online-payments/#getting-a-sandbox-merchant-account).
- Review [Google Pay API terms of service](https://payments.developers.google.com/terms/sellertos).
- Complete the domain onboarding setup steps described in your Dashboard under **Settings** > **For developers** > **Payment wallets**. You can read Google's tutorial [Google Pay for Payments](https://developers.google.com/pay/api/web/guides/tutorial), which covers the requirements you're expected to follow in order to successfully offer this payment method.

Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/online-payments/apm/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,9 +36,9 @@ The APMs you can offer depend on the country your business is registered and ope

## Enabling Alternative Payment Methods

As a **sole trader** APMs are automatically enabled in your profile after completing the regular registration steps and performing a test transaction with one of our remote payment products, such as [Payment Links](https://sumup.co.uk/payment-links/), [Invoices](https://sumup.co.uk/invoices) and [Online Store](https://sumup.co.uk/online-store/).
As a **sole trader**, APMs are automatically enabled for your merchant account after completing the regular registration steps and performing a test transaction with one of our remote payment products, such as [Payment Links](https://sumup.co.uk/payment-links/), [Invoices](https://sumup.co.uk/invoices), and [Online Store](https://sumup.co.uk/online-store/).

As with any other legal type, you must request the activation from our support team or via our [contact form here](/contact), providing us with your merchant ID (MXXXXX). Our team will onboard your profile and grant you access to the APMs applicable to your business location. Once your request is processed, APMs will instantly become available to you within [Payment Links](https://sumup.co.uk/payment-links/), [Invoices](https://sumup.co.uk/invoices) and [Online Store](https://sumup.co.uk/online-store/).
As with any other legal type, you must request activation from our support team or via our [contact form here](/contact), providing your merchant ID (MXXXXX). Our team will onboard your merchant account and grant access to the APMs applicable to your business location. Once your request is processed, APMs become available within [Payment Links](https://sumup.co.uk/payment-links/), [Invoices](https://sumup.co.uk/invoices), and [Online Store](https://sumup.co.uk/online-store/).

<Aside type="note">

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/online-payments/apm/integration-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Alternative Payment Methods (further referred to as APMs) are similar to normal

## Check Available APMs

Check which payment methods are available to your merchant profile.
Check which payment methods are available to your merchant account.

1. [Create a checkout](/api/checkouts/create) and use the checkout `id` to fetch the list of available payment methods from the following endpoint `https://api.sumup.com/v0.1/checkouts/{checkout_id}/payment-methods`.

Expand Down
14 changes: 7 additions & 7 deletions src/content/docs/online-payments/guides/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,26 +13,26 @@ import Image from '@components/content/Image.astro';

Guides in this section cover the basics of SumUp APIs, allowing you to develop a custom integration if SumUp products don't fully support your use case.

## Getting a Test Account
## Getting a Sandbox Merchant Account

Create a test account to test APIs without real money:
Create a sandbox merchant account to test APIs without real money:

<Steps>

1. Log in to your SumUp account.

2. Open the drop-down menu between **Support** and your user panel.

3. Select **Test Account**. Your merchant account is now switched to test mode.
3. Select **Sandbox Merchant Account**. Your merchant account is now switched to sandbox mode.

</Steps>

<Image alt="A screenshot of the account selection dropdown in the SumUp dashboard with the test account highlighted with red circle" src="/img/guides/test_acc.png" width="40%" />
<Image alt="A screenshot of the account selection dropdown in the SumUp dashboard with the sandbox merchant account highlighted with red circle" src="/img/guides/test_acc.png" width="40%" />

With your test account, begin making API calls with real data. Test accounts **do not** process transactions with real funds. The test account has a different ID and displays a clear warning. Requests with a value of 11 (in any currency) always fail by design, to test failed transaction scenarios.
With your sandbox merchant account, begin making API calls with real data. Sandbox merchant accounts **do not** process transactions with real funds. The sandbox merchant account has a different ID and displays a clear warning. Requests with a value of 11 (in any currency) always fail by design, to test failed transaction scenarios.

<Image alt="A screenshot of the dashboard with test account selected" src="/img/guides/test-account-warning.png" width="100%" />
<Image alt="A screenshot of the dashboard with sandbox merchant account selected" src="/img/guides/test-account-warning.png" width="100%" />

When finished experimenting with the test account, switch back to a regular account for business purposes.
When finished experimenting with the sandbox merchant account, switch back to a regular account for business purposes.

SumUp provides official SDKs for Node.js, Go, Python, Java, PHP, .NET, and Rust — visit the [SDKs overview page](/tools/sdks/) to choose the client that fits your stack.
2 changes: 1 addition & 1 deletion src/content/docs/online-payments/guides/refund.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ When you complete these steps, the payment you have previously processed through
Here are the things that you need in order to complete the steps in this guide:

- [SumUp merchant account](https://me.sumup.com/login) with completed [account details](https://me.sumup.com/account).
- You can also use a [test account](/online-payments/#getting-a-test-account).
- You can also use a [sandbox merchant account](/online-payments/#getting-a-sandbox-merchant-account).
- [Registered client application](/tools/authorization/register-app/) with SumUp.
- Valid access token obtained with the [Authorization code flow](/tools/authorization/authorization/#authorization-code-flow).
- You have processed a checkout and you have the checkout ID.
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/online-payments/guides/single-payment.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ When you complete these steps, you will have processed a payment with a payment
## Prerequisites

- [SumUp merchant account](https://me.sumup.com/login) with completed [account details](https://me.sumup.com/account).
- You can also use a [test account](/online-payments/#getting-a-test-account).
- You can also use a [sandbox merchant account](/online-payments/#getting-a-sandbox-merchant-account).
- [Registered client application](/tools/authorization/register-app/) with SumUp.
- Valid access token obtained either with the [Authorization code flow](/tools/authorization/authorization/#authorization-code-flow) or [Client credentials flow](/tools/authorization/authorization/#client-credentials-flow).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ You will go through the following steps:
## Prerequisites

- You have a merchant account with [SumUp](https://me.sumup.com/login) and have already filled in your [account details](https://me.sumup.com/account).
- You can also create a [test account](/online-payments/#getting-a-test-account). Please note that setting up 3DS verification in a test account requires contact with our team at integrations@sumup.com.
- You can also create a [sandbox merchant account](/online-payments/#getting-a-sandbox-merchant-account). Please note that setting up 3DS verification in a sandbox merchant account requires contact with our team at integrations@sumup.com.
- You have an API Key. For more details see the [Authorization Guide](/tools/authorization/authorization/#api-keys).
- You have control over the backend server to retrieve data securely.

Expand Down Expand Up @@ -396,7 +396,7 @@ You should expect a standard `201 Created` response, with the checkout reference
"id": "7164c99b-13cb-42a1-8ba1-3c2c46a29de7",
"merchant_code": "MDEERENR",
"merchant_country": "PL",
"merchant_name": "Test Account",
"merchant_name": "Sandbox Merchant Account",
"pay_to_email": "a8e019f9bb2f49159182e8bd61eb5ea6@developer.sumup.com",
"purpose": "SETUP_RECURRING_PAYMENT",
"status": "PENDING",
Expand Down
16 changes: 8 additions & 8 deletions src/content/docs/online-payments/index.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Online Payments
description: Get started with accepting online payments. This guide walks you through creating a test profile and processing your first transaction in minutes.
description: Get started with accepting online payments. This guide walks you through creating a sandbox merchant account and processing your first transaction in minutes.
sidebar:
label: Quickstart
order: 1
Expand All @@ -15,27 +15,27 @@ Online payments form an integral part of the SumUp product portfolio. SumUp supp

To get started, review the options SumUp offers for managing online payments.

## Getting a Test Account
## Getting a Sandbox Merchant Account

To test SumUp APIs and tools without involving real money, use a test account. Create one from your Dashboard account as follows.
To test SumUp APIs and tools without involving real money, use a sandbox merchant account. Create one from your Dashboard account as follows.

<Steps>

1. Log in to your SumUp account.

2. Open the drop-down menu between **Support** and your user panel.

3. Select **Test Account**. Your merchant account is now in test mode.
3. Select **Sandbox Merchant Account**. Your merchant account is now in sandbox mode.

</Steps>

<Image alt="A screenshot of the account selection dropdown in the SumUp dashboard with the test account highlighted with red circle" src="/img/guides/test_acc.png" width="40%" />
<Image alt="A screenshot of the account selection dropdown in the SumUp dashboard with the sandbox merchant account highlighted with red circle" src="/img/guides/test_acc.png" width="40%" />

With your test account, begin making API calls with real data. Test accounts **do not** process transactions with real funds. The test account has a different ID and displays a clear warning. Requests with a value of 11 (in any currency) always fail by design, to test failed transaction scenarios.
With your sandbox merchant account, begin making API calls with real data. Sandbox merchant accounts **do not** process transactions with real funds. The sandbox merchant account has a different ID and displays a clear warning. Requests with a value of 11 (in any currency) always fail by design, to test failed transaction scenarios.

<Image alt="A screenshot of the dashboard with test account selected" src="/img/guides/test-account-warning.png" width="100%" />
<Image alt="A screenshot of the dashboard with sandbox merchant account selected" src="/img/guides/test-account-warning.png" width="100%" />

When finished experimenting with the test account, switch back to a regular account for business purposes.
When finished experimenting with the sandbox merchant account, switch back to a regular account for business purposes.

## Authorization

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/online-payments/sdks/php.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ links:

The [`sumup-php`](https://github.com/sumup/sumup-php) package is the official PHP SDK for SumUp APIs. It provides service clients for common resources, such as:

- managing merchant profiles
- managing merchant accounts
- managing checkouts
- managing customers
- managing payouts
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/online-payments/sdks/react-native.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ SumUp's React Native Payment SDK provides a payment sheet that is displayed on t

Here are the things that you need in order to complete the steps in this guide:
- You have a merchant account with [SumUp](https://me.sumup.com/login) and have already filled in your [account details](https://me.sumup.com/account).
- For a **test account** reach out to our support team through this [contact form](/contact).
- For a **sandbox merchant account** reach out to our support team through this [contact form](/contact).
- You have [registered your client application](/tools/authorization/register-app/) with SumUp.
- You have a valid access token obtained via the [Authorization code flow](/tools/authorization/authorization/#authorization-code-flow).
- The restricted `payment_instruments` scope is enabled for your client application. If it isn't enabled, [contact us](/contact) and request it.
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/terminal-payments/accept-payments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ For platform-specific setup details, permissions, and advanced options, use the

## Prerequisites

- A SumUp merchant account (or [test account](/terminal-payments/#getting-a-test-account)).
- A SumUp merchant account (or [sandbox merchant account](/terminal-payments/#getting-a-sandbox-merchant-account)).
- An [Affiliate Key](/tools/authorization/affiliate-keys/) linked to your app.
- A compatible card reader paired with the merchant account.

Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/terminal-payments/cloud-api.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,12 +38,12 @@ The { cloudapiname } integration supports:

## Solo Virtual Terminal

If you don’t have a Solo reader yet, you can try out the flow using the [Virtual Solo](https://virtual-solo.sumup.com) with a [SumUp test account](/online-payments/#getting-a-test-account).
If you don’t have a Solo reader yet, you can try out the flow using the [Virtual Solo](https://virtual-solo.sumup.com) with a [SumUp sandbox merchant account](/online-payments/#getting-a-sandbox-merchant-account).

Virtual Solo works like the real device but with some limitations. The following actions are not supported virtually:

* Physical card insertion or tap simulation (since there is no physical Solo device)
* Real funds transfer (test accounts only)
* Real funds transfer (sandbox merchant accounts only)
* PIN entry simulation (always auto-approved)
* Offline transactions
* Custom receipt printing
Expand Down
Loading