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

# Request terminal pairing code

`POST /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.

> 🔑 Access with
>
> [API key](/reference/authentication)
>
> [OAuth access with **terminals.write**](/reference/authentication)

## Query parameters

- `include` 'details.qrCode', nullable

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

- `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/accepting-payments.md) · [All operations](https://skmtc.net/mollie/apis/accepting-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mollie/accepting-payments/revisions/4b45df3039ef/schema)