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.
Headers
Authorizationstring required
Access token in the format 'Bearer {token}'.
Request body
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"
}
}