Go SDK | SumUp Developer

sumup-go(Opens in a new tab) is the official Go module. It exposes typed clients for every endpoint, handles authentication headers, and surfaces helpers for common request payloads.

Installation

Install the module with go get github.com/sumup/sumup-go (or go install for reproducible builds).

Configure Authentication

Create a secret API key or OAuth access token in the developer dashboard(Opens in a new tab). The SDK reads SUMUP_API_KEY by default, so setting SUMUP_API_KEY=sup_sk_MvxmLOl0... before running your binary is enough. You can also pass the key explicitly:

1client := sumup.NewClient(client.WithAPIKey("sup_sk_MvxmLOl0..."))

Examples

Online Payment Checkout

1package main
2
3import (
4	"context"
5	"fmt"
6	"log"
7	"os"
8
9	sumup "github.com/sumup/sumup-go"
10)
11
12func main() {
13	ctx := context.Background()
14	client := sumup.NewClient()
15
16	merchantCode := os.Getenv("SUMUP_MERCHANT_CODE")
17	desc := "Online payment via Payment Widget"
18
19	checkout, err := client.Checkouts.Create(ctx, sumup.CheckoutsCreateParams{
20		Amount:            25.00,
21		CheckoutReference: "ORDER-1001",
22		Currency:          sumup.CurrencyEUR,
23		Description:       &desc,
24		MerchantCode:      merchantCode,
25	})
26	if err != nil {
27		log.Fatalf("create checkout: %v", err)
28	}
29
30	fmt.Println(*checkout.ID)
31	// Return checkout ID to your webpage so the SumUp Payment Widget can complete the payment.
32}

Cloud API Checkout

1package main
2
3import (
4	"context"
5	"fmt"
6	"log"
7	"os"
8	"strings"
9	"time"
10
11	sumup "github.com/sumup/sumup-go"
12)
13
14func main() {
15	ctx := context.Background()
16	client := sumup.NewClient()
17
18	merchantCode := os.Getenv("SUMUP_MERCHANT_CODE")
19	affiliateKey := os.Getenv("SUMUP_AFFILIATE_KEY")
20	appID := os.Getenv("SUMUP_APP_ID")
21
22	readerList, err := client.Readers.List(ctx, merchantCode)
23	if err != nil {
24		log.Fatalf("list readers: %v", err)
25	}
26
27	var solo sumup.Reader
28	for _, rdr := range readerList.Items {
29		if strings.EqualFold(string(rdr.Device.Model), "solo") {
30			solo = rdr
31			break
32		}
33	}
34	if solo.ID == "" {
35		log.Fatal("Pair a Solo reader before using the Cloud API.")
36	}
37
38	checkout, err := client.Readers.CreateCheckout(ctx, merchantCode, string(solo.ID), sumup.CreateCheckoutRequest{
39		TotalAmount: sumup.CreateCheckoutRequestTotalAmount{
40			Currency: "EUR",
41			MinorUnit: 2,
42			Value:    1500,
43		},
44	})
45	if err != nil {
46		log.Fatalf("create checkout: %v", err)
47	}
48
49	fmt.Println(checkout.Data.ClientTransactionId)
50}