---
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.

---

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