Link Terminal

Last updated: 2026-03-25

POST

/in-store/api/v1/terminal/link

Link a payment terminal to your merchant account using a registration code

Request Body

terminalIdstringrequired

The unique identifier of the terminal to link.

registrationCodestringrequired

The time-limited registration code displayed on the terminal screen. Obtained from the terminal's registration flow.

HTTP Status Code Summary

Code	Description
200	Terminal linked successfully.
400	Bad request. Check that terminalId and registrationCode are provided and valid.
401	Unauthorized. Ensure your bearer token and subscription key are valid.
422	Unprocessable entity. The registration code may be expired or the terminal is not in a linkable state.

Request

cURL

1curl -X 'POST' \
2  'https://demo-api.westpay.se/in-store/api/v1/terminal/link' \
3  -H 'accept: application/json' \
4  -H 'Ocp-Apim-Subscription-Key: <merchant-subscription-key>' \
5  -H 'Authorization: Bearer <access-token>' \
6  -H 'Content-Type: application/json' \
7  -d '{
8  "terminalId": "<your-terminal-id>",
9  "registrationCode": "ABC123"
10}'

Response

1{
2  "printerEnabled": true
3}