Skip to main content

Getting Started

At SumUp accepting online payments is possible through a number of different approaches, to cater every merchants' use case. With the SumUp APIs you are able to build a complete and custom payments flow. Your app can communicate with SumUp via HTTP requests, all defined in our API Reference.

To get started, we will walk you through the options SumUp offers for managing online payments.

info

Do you have specific questions? Check out our help page for the most frequently asked questions or contact us here.

Getting a test account

To start testing SumUp APIs and tools you need to request a test account through our contact form.

Once you've received your test account you can begin making API calls with real data. Our test accounts do not process transactions with real funds.

SumUp APIs

SumUp provides REST API for most of its services like creating and executing payments, storing cards for future payments, issuing refunds among others. Our API uses OAuth 2.0 authorization standards to authenticate applications access to its services. We also support Cross-origin resource sharing (CORS) allowing web browsers securely to consume our API from a different domain origin.

The API receives requests and communicates responses mostly in JSON format, except for when the request needs to contain form encoded data. Typically, the requests are data objects consisting of name/value pairs sent to the SumUp API URI: api.sumup.com

Receiving payments

In order to receive payments, you need to create a checkout. Whether you would like to receive payments as a merchant directly, or initiate payments on a merchant's behalf depends on the type of authorization provided. Checkouts are created in a server-to-server communication. This ensures that you can keep your access token and client credentials secret and guarantees that sensitive checkout details, e.g. amount or recepient, cannot be changed.

Completing checkouts could be done via your web browser or mobile application, which guarantees you do not need to worry about sensitive data, like card data, ever hitting your servers and thus avoiding the need to be PCI DSS compliant.

tip

A checkout can be completed in a browser only from a domain that is present as an authorized JavaScript origin when creating your client credentials.

SumUp provides flexibility to complete a checkout by offering a couple of integration approaches:

Once you complete the checkout, you would have processed a payment successfully to a merchant’s SumUp account.

SumUp Card Widget

For a quick and seemless integration, we've developed a sleek payment widget. Incorporating the SumUp Card Widget only requires adding a script to your payment page.

WooCommerce Plugin

You can also integrate the SumUp Card Widget to your WordPress website via our in-house built solution. The SumUp Payment Gateway for WooCommerce does not require coding in order to be integrated.

Alternative Payment Methods

Alternative Payment Methods (APMs) enable you to accept payments other than traditional card schemes, like VISA, MASTERCARD, ELO, etc.. APMs can be accessed through the SumUp Card Widget. Request access by contacting us via our contact form.

At SumUp you can make use of the following APMs:

  • Apple Pay
  • Bancontact
  • Blik
  • Boleto
  • EPS
  • Giropay
  • iDeal
  • MyBank
  • PIX
  • Przelewy24
  • Satispay
  • Sofort
tip

The APMs you can offer depend on the location your business is registered and operates in.