Sign in
Readers

Create a Go Reader Payment

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.

post/v0/merchants/{merchant_code}/readers/{reader_id}/go-checkout

Path parameters

merchant_codestring required
Example:MK10CL2A

Short unique identifier for the merchant.

reader_idstring required

Unique identifier of the reader that the payment is initiated on.

Example:rdr_3MSAFM23CK82VSTT4BN6RWSQ65

The unique identifier of the reader.

Request body

client_transaction_idstring required

Caller-supplied correlation identifier, used as the idempotency key.

tip_amountinteger

Optional tip amount in minor units, added on top of total_amount.

Example request

{
  "affiliate": {
    "app_id": "com.example.app",
    "key": "123e4567-e89b-12d3-a456-426614174000"
  },
  "client_transaction_id": "19e12390-72cf-4f9f-80b5-b0c8a67fa43f",
  "tip_amount": 100,
  "total_amount": {
    "currency": "MXN",
    "value": 1000
  }
}

Response

Returns the result of the payment initiated on the reader.

Example response

{
  "data": {
    "client_transaction_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "transaction_code": "TEENSK4W2K"
  }
}

Changes

Changed in 2 of the 53 revisions of this API.12