SumUp Checkout Examples

Learn how to quickly collect payments with SumUp checkouts. In this repository you will find backend examples for all our SDKs and a few sample frontends to get you started with accepting your first online payment.

All you need to get started is an API key (if you don't have one yet, create it in the SumUp Dashboard) and your merchant code (which you can find in the settings). We recommend starting with a Sandbox account that you can create in the dashboard to be able to test as many payments as you want without processing real money.

Set your environment:

export SUMUP_API_KEY="your_api_key"
export SUMUP_MERCHANT_CODE="your_merchant_code"

Backend Examples

Minimal servers that expose POST /checkouts and use the SumUp SDKs, plus front-end examples that mount the card widget.

• Node.js SDK (https://github.com/sumup/sumup-ts)

  • Runtime: Node.js

    cd backend/node
    npm install
    npm start

  • Runtime: Bun

    cd backend/bun
    bun install
    bun run index.ts

  • Runtime: Deno

    cd backend/deno
    deno run --allow-env --allow-net main.ts

• Python SDK (https://github.com/sumup/sumup-py)

  cd backend/python
  uv run app.py

• Java SDK (https://github.com/sumup/sumup-java)

  cd backend/java
  gradle run

• Go SDK (https://github.com/sumup/sumup-go)

  cd backend/go
  go run .

• Rust SDK (https://github.com/sumup/sumup-rs)

  cd backend/rust
  cargo run

• .NET SDK (https://github.com/sumup/sumup-dotnet)

  cd backend/dotnet
  dotnet run

Frontend Examples

Both front-ends create a checkout via POST /checkouts and mount the SumUp card widget for a one-time payment.

• Static
• React

Environment

All backend examples use:

export SUMUP_API_KEY="your_api_key"
export SUMUP_MERCHANT_CODE="your_merchant_code"

If the front-end is served from another origin, enable CORS on the backend or use a proxy.