---
title: "Create a Go Reader Payment"
method: POST
path: "/v0/merchants/{merchant_code}/readers/{reader_id}/go-checkout"
tags: ["Readers"]
---

# Create a Go Reader Payment

`POST /v0/merchants/{merchant_code}/readers/{reader_id}/go-checkout`

Initiates a payment on the SumUp Go terminal identified by the reader ID.

Use `client_transaction_id` as an idempotency key: retrying the request with the same value returns the result of the original payment instead of creating a duplicate.

## Path parameters

- `merchant_code` string, required
- `reader_id` string, required — Unique identifier of the reader that the payment is initiated on.

## Request body

- ReaderPaymentRequestParams
  - `affiliate` Affiliate
    - `app_id` string, required
    - `key` string, required
  - `client_transaction_id` string, required — Caller-supplied correlation identifier, used as the idempotency key.
  - `tip_amount` integer — Optional tip amount in minor units, added on top of total_amount.
  - `total_amount` Amount, required
    - `currency` string, required — Currency ISO 4217 code
    - `value` integer, required — Amount in minor units (e.g. cents).

## Response `200`

Returns the result of the payment initiated on the reader.

- ReaderPaymentResponse
  - `data` ReaderPaymentResponseData
    - `client_transaction_id` string — Caller-supplied correlation identifier that was provided in the request.
    - `transaction_code` string — Transaction code returned by the acquirer/processing entity after processing the transaction.

## Other responses

- `400` — The request is invalid.
- `401` — Authentication failed or missing required scope.
- `404` — The requested Reader resource does not exist.
- `422` — The request could not be processed as it violates a business rule.

## Changes

- **2026-08-13** `e3f010a5eddd` — 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - removed the non-success response with the status `500`
- **2026-08-03** `f50e1dc97523` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v0/merchants/:merchant_code/readers/:reader_id/go-checkout/post.md)

---

[API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) · [All operations](https://skmtc.dev/sumup/apis/sumup-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sumup/sumup-rest-api/revisions/b050b86c35d1/schema)