---
title: "Request terminal pairing code"
method: POST
path: "/v2/terminals/pairing-codes"
tags: ["Terminals API"]
---

# Request terminal pairing code

`POST /v2/terminals/pairing-codes`

> ℹ️ **Test mode**
>
> This endpoint currently does not support test mode yet.

Request a pairing code to onboard a point-of-sale terminal.

The response includes a human-readable `code` for manual entry on the terminal, and a QR Code as a
base64 encoded SVG data URI for scanning if you specify the query parameter `include` with value `details.qrCode`.

Pairing codes expire after 90 days (see `expiresAt`) and can be used multiple times.

## Query parameters

- `include` string, nullable

## Headers

- `idempotency-key` string

## Request body

- object
  - `profileId` string, required — The ID of the profile to pair the terminal with.

## Response `201`

The requested terminal pairing code object.

## Other responses

- `403` — Your organization is not eligible for terminal pairing codes. Complete onboarding, then try again.
- `422` — The request contains issues. For example, if the `profileId` field is missing or invalid.
- `429` — Rate Limit has been reached.

## Changes

> 78 revisions in range; 9 not diffed.

- **2026-08-14** `2dbdaaf46550` — 1 info
  - added the non-success response with the status `403`
- **2026-05-21** `4c6a6cf47ca8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/terminals/pairing-codes/post.md)

---

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