fix: add missing go card reader checkout

README.md

@@ -113,6 +113,17 @@ sumup readers checkout \
 
 When using affiliate attribution, pass all affiliate flags: `--affiliate-app-id`, `--affiliate-key`, and `--affiliate-foreign-transaction-id`.
 
+Trigger a checkout on a SumUp Go reader. `--client-transaction-id` is required and used as the idempotency key:
+
+```bash
+sumup readers go-checkout \
+  --merchant-code M123 \
+  --amount 14.99 \
+  --currency EUR \
+  --client-transaction-id 19e12390-72cf-4f9f-80b5-b0c8a67fa43f \
+  reader_42
+```
+
 Check the last known status of a paired reader:
 
 ```bash

go.mod

@@ -9,7 +9,7 @@ require (
 	github.com/mergestat/timediff v0.0.4
 	github.com/shopspring/decimal v1.4.0
 	github.com/stretchr/testify v1.11.1
-	github.com/sumup/sumup-go v0.17.2
+	github.com/sumup/sumup-go v0.19.0
 	github.com/urfave/cli-docs/v3 v3.1.0
 	github.com/urfave/cli/v3 v3.10.1
 	golang.org/x/term v0.45.0
@@ -34,7 +34,7 @@ require (
 	github.com/rivo/uniseg v0.4.7 // indirect
 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
 	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
-	golang.org/x/oauth2 v0.35.0 // indirect
+	golang.org/x/oauth2 v0.36.0 // indirect
 	golang.org/x/sync v0.21.0 // indirect
 	golang.org/x/sys v0.47.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect

go.sum

@@ -48,8 +48,8 @@ github.com/shopspring/decimal v1.4.0 h1:bxl37RwXBklmTi0C79JfXCEBD1cqqHt0bbgBAGFp
 github.com/shopspring/decimal v1.4.0/go.mod h1:gawqmDU56v4yIKSwfBSFip1HdCCXN8/+DMd9qYNcwME=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
-github.com/sumup/sumup-go v0.17.2 h1:OpxHJ5yX0N2aCgrWhGqHcKoElMFHT38QanvVOd0e3pM=
-github.com/sumup/sumup-go v0.17.2/go.mod h1:D++G2u9zvobimuUrgvSbah/tS3ON2Dmi6yb6ScA2Jpg=
+github.com/sumup/sumup-go v0.19.0 h1:/AT4t6R4geRDdAtXiEI/JgOK/PyfPd7va77KEjzYoqU=
+github.com/sumup/sumup-go v0.19.0/go.mod h1:D++G2u9zvobimuUrgvSbah/tS3ON2Dmi6yb6ScA2Jpg=
 github.com/urfave/cli-docs/v3 v3.1.0 h1:Sa5xm19IpE5gpm6tZzXdfjdFxn67PnEsE4dpXF7vsKw=
 github.com/urfave/cli-docs/v3 v3.1.0/go.mod h1:59d+5Hz1h6GSGJ10cvcEkbIe3j233t4XDqI72UIx7to=
 github.com/urfave/cli/v3 v3.10.1 h1:7Kx9H50hrHbRbyxgO1KP6/BcbiGRz0uYh5YyQ30JEEY=
@@ -58,8 +58,8 @@ github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavM
 github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
 golang.org/x/exp v0.0.0-20231006140011-7918f672742d h1:jtJma62tbqLibJ5sFQz8bKtEM8rJBtfilJ2qTU199MI=
 golang.org/x/exp v0.0.0-20231006140011-7918f672742d/go.mod h1:ldy0pHrwJyGW56pPQzzkH36rKxoZW1tw7ZJpeKx+hdo=
-golang.org/x/oauth2 v0.35.0 h1:Mv2mzuHuZuY2+bkyWXIHMfhNdJAdwW3FuWeCPYN5GVQ=
-golang.org/x/oauth2 v0.35.0/go.mod h1:lzm5WQJQwKZ3nwavOZ3IS5Aulzxi68dUSgRHujetwEA=
+golang.org/x/oauth2 v0.36.0 h1:peZ/1z27fi9hUOFCAZaHyrpWG5lwe0RJEEEeH0ThlIs=
+golang.org/x/oauth2 v0.36.0/go.mod h1:YDBUJMTkDnJS+A4BP4eZBjCqtokkg1hODuPjwiGPO7Q=
 golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
 golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
 golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=

internal/codesamples/codesamples.go

@@ -75,10 +75,6 @@ var optionalSampleFlags = map[string]map[string]string{
 	"checkouts update": {
 		"description": "Updated order",
 	},
-	"checkouts process": {
-		"customer-id": "$CUSTOMER_ID",
-		"token":       "$PAYMENT_INSTRUMENT_TOKEN",
-	},
 	"customers create": {
 		"email": "customer@example.com",
 	},
@@ -94,21 +90,22 @@ var optionalSampleFlags = map[string]map[string]string{
 }
 
 var flagSampleValues = map[string]string{
-	"amount":        "10.00",
-	"context":       "example.com",
-	"currency":      "EUR",
-	"email":         "member@example.com",
-	"end-date":      "2026-01-31",
-	"merchant-code": "$SUMUP_MERCHANT_CODE",
-	"name":          "Example",
-	"pairing-code":  "4WLFDSBF",
-	"password":      "$MEMBER_PASSWORD",
-	"payment-type":  "card",
-	"permission":    "members_access",
-	"reference":     "order-123",
-	"role":          "role_employee",
-	"start-date":    "2026-01-01",
-	"target":        "https://apple-pay-gateway-cert.apple.com/paymentservices/startSession",
+	"amount":                "10.00",
+	"client-transaction-id": "19e12390-72cf-4f9f-80b5-b0c8a67fa43f",
+	"context":               "example.com",
+	"currency":              "EUR",
+	"email":                 "member@example.com",
+	"end-date":              "2026-01-31",
+	"merchant-code":         "$SUMUP_MERCHANT_CODE",
+	"name":                  "Example",
+	"pairing-code":          "4WLFDSBF",
+	"password":              "$MEMBER_PASSWORD",
+	"payment-type":          "card",
+	"permission":            "members_access",
+	"reference":             "order-123",
+	"role":                  "role_employee",
+	"start-date":            "2026-01-01",
+	"target":                "https://apple-pay-gateway-cert.apple.com/paymentservices/startSession",
 }
 
 var argumentSampleValues = map[string]string{

internal/codesamples/codesamples_test.go

@@ -65,7 +65,7 @@ func TestGenerate(t *testing.T) {
   --merchant-code "$SUMUP_MERCHANT_CODE"
 `, sampleByID(t, catalog.Samples, "GetPerson").Source)
 	assert.Contains(t, sampleByID(t, catalog.Samples, "UpdateCheckout").Source, `--description "Updated order"`)
-	assert.Contains(t, sampleByID(t, catalog.Samples, "ProcessCheckout").Source, `--token "$PAYMENT_INSTRUMENT_TOKEN"`)
+	assert.Contains(t, sampleByID(t, catalog.Samples, "CreateGoReaderCheckout").Source, "sumup readers go-checkout")
 	assert.Contains(t, sampleByID(t, catalog.Samples, "CreateMerchantMember").Source, "sumup members create")
 	assert.NotContains(t, sampleByID(t, catalog.Samples, "CreateMerchantMember").Source, "members invite")
 

internal/commands/checkouts/checkouts.go

@@ -10,7 +10,6 @@ import (
 	"github.com/urfave/cli/v3"
 
 	sumup "github.com/sumup/sumup-go"
-	"github.com/sumup/sumup-go/datetime"
 	"github.com/sumup/sumup-go/nullable"
 
 	"github.com/sumup/sumup-cli/internal/apicommands"
@@ -19,7 +18,6 @@ import (
 	"github.com/sumup/sumup-cli/internal/currency"
 	"github.com/sumup/sumup-cli/internal/display"
 	"github.com/sumup/sumup-cli/internal/display/attribute"
-	"github.com/sumup/sumup-cli/internal/display/message"
 )
 
 func NewCommand() *cli.Command {
@@ -185,28 +183,6 @@ func NewCommand() *cli.Command {
 					},
 				},
 			}),
-			apicommands.Bind("ProcessCheckout", &cli.Command{
-				Name:      "process",
-				Usage:     "Process a checkout.",
-				Action:    processCheckout,
-				ArgsUsage: "<checkout-id>",
-				Flags: []cli.Flag{
-					&cli.StringFlag{
-						Name:     "payment-type",
-						Usage:    "Payment type to use when processing the checkout.",
-						Required: true,
-					},
-					&cli.StringFlag{Name: "customer-id", Usage: "Customer ID for tokenized payments."},
-					&cli.StringFlag{Name: "token", Usage: "Saved payment instrument token."},
-					&cli.IntFlag{Name: "installments", Usage: "Installment count for supported regions."},
-					&cli.StringFlag{Name: "first-name", Usage: "Customer first name."},
-					&cli.StringFlag{Name: "last-name", Usage: "Customer last name."},
-					&cli.StringFlag{Name: "email", Usage: "Customer email."},
-					&cli.StringFlag{Name: "phone", Usage: "Customer phone."},
-					&cli.StringFlag{Name: "tax-id", Usage: "Customer tax ID."},
-					&cli.StringFlag{Name: "birth-date", Usage: "Customer birth date in YYYY-MM-DD format."},
-				},
-			}),
 		},
 	}
 }
@@ -521,66 +497,6 @@ func listPaymentMethods(ctx context.Context, cmd *cli.Command) error {
 	})
 }
 
-func processCheckout(ctx context.Context, cmd *cli.Command) error {
-	appCtx, err := app.GetAppContext(cmd)
-	if err != nil {
-		return err
-	}
-	checkoutID, err := util.RequireSingleArg(cmd, "checkout ID")
-	if err != nil {
-		return err
-	}
-
-	body := sumup.CheckoutsProcessParams{
-		PaymentType: sumup.ProcessCheckoutPaymentType(cmd.String("payment-type")),
-	}
-	if customerID := cmd.String("customer-id"); customerID != "" {
-		body.CustomerID = &customerID
-	}
-	if token := cmd.String("token"); token != "" {
-		body.Token = &token
-	}
-	if cmd.IsSet("installments") {
-		value := cmd.Int("installments")
-		body.Installments = &value
-	}
-	if details, changedCount, err := checkoutPersonalDetailsFromFlags(cmd); err != nil {
-		return err
-	} else if changedCount > 0 {
-		body.PersonalDetails = details
-	}
-
-	response, err := appCtx.Client.Checkouts.Process(ctx, checkoutID, body)
-	if err != nil {
-		return fmt.Errorf("process checkout: %w", err)
-	}
-
-	if appCtx.JSONOutput {
-		return display.PrintJSON(appCtx.Output, response)
-	}
-
-	if response.CheckoutSuccess != nil {
-		if err := message.Success(appCtx.StatusOutput, "Checkout processed"); err != nil {
-			return err
-		}
-		return renderCheckout(appCtx, response.CheckoutSuccess)
-	}
-
-	if response.CheckoutAccepted != nil {
-		if err := message.Success(appCtx.StatusOutput, "Checkout accepted"); err != nil {
-			return err
-		}
-		if response.CheckoutAccepted.NextStep != nil {
-			return display.DataList(appCtx.Output, []attribute.KeyValue{
-				attribute.OptionalString("Method", response.CheckoutAccepted.NextStep.Method),
-				attribute.OptionalString("URL", response.CheckoutAccepted.NextStep.URL),
-				attribute.OptionalString("Redirect URL", response.CheckoutAccepted.NextStep.RedirectURL),
-			})
-		}
-	}
-	return nil
-}
-
 func renderCheckout(appCtx *app.Context, checkout *sumup.CheckoutSuccess) error {
 	if checkout == nil {
 		return nil
@@ -627,46 +543,6 @@ func checkoutMutationDetails(appCtx *app.Context, checkout *sumup.Checkout) []at
 	return details.Pairs()
 }
 
-func checkoutPersonalDetailsFromFlags(cmd *cli.Command) (*sumup.PersonalDetails, int, error) {
-	details := &sumup.PersonalDetails{}
-	changedCount := 0
-
-	if value := cmd.String("first-name"); value != "" {
-		details.FirstName = &value
-		changedCount++
-	}
-	if value := cmd.String("last-name"); value != "" {
-		details.LastName = &value
-		changedCount++
-	}
-	if value := cmd.String("email"); value != "" {
-		details.Email = &value
-		changedCount++
-	}
-	if value := cmd.String("phone"); value != "" {
-		details.Phone = &value
-		changedCount++
-	}
-	if value := cmd.String("tax-id"); value != "" {
-		details.TaxID = &value
-		changedCount++
-	}
-	if value := cmd.String("birth-date"); value != "" {
-		parsedDate, err := time.Parse(time.DateOnly, value)
-		if err != nil {
-			return nil, 0, fmt.Errorf("invalid birth date %q: %w", value, err)
-		}
-		date := datetime.Date{Time: parsedDate}
-		details.BirthDate = &date
-		changedCount++
-	}
-
-	if changedCount == 0 {
-		return nil, 0, nil
-	}
-	return details, changedCount, nil
-}
-
 func parseRFC3339Time(value string, label string) (time.Time, error) {
 	parsed, err := time.Parse(time.RFC3339, value)
 	if err != nil {