---
title: "Create device registration"
method: POST
path: "/v1/device_registrations"
tags: ["Devices"]
---

# Create device registration

`POST /v1/device_registrations`

Create a device registration for payment processing on a specific merchant. When a device is registered, the device receives a new device_registration_id for payment processing. The merchant status must be `ACTIVE` to register a device.

## Parameters

- `#/paths/~1v1~1payins/get/parameters/0` — unresolved $ref

## Request body

- object
  - `merchant_id` string, required — The unique merchant identifier. Prefix is "mid" in production and "sbx_mid" in sandbox.
  - `registration_code` string, required — The code that appears on an internet-connected device when it is not yet registered or has been deregistered. On sandbox, a virtual device can be registered to test the device integration without a physical device. Use the registration code `VIRTUAL_DEVICE` to register a virtual device to any sandbox merchant account.
  - `device_name` string, required — The name that will appear on the device screen when internet-connected.

## Response `200`

OK

- object
  - `status` Status — unresolved $ref
  - `data` object
    - `device_registration_id` unknown
    - `merchant_id` unknown
    - `make` string — The make of the device.
    - `model` string — The model of the device.
    - `serial_number` string — The serial number of the device.
    - `device_name` string — The name that will appear on the device screen when internet-connected.
    - `capabilities` string[] — The supported device registration capabilities. `SIGNATURE` - supports collecting a digital signature
    - `created_at` string, date-time — Date and time the device registration was created in UTC RFC 3339 format.
    - `deleted_at` string, date-time — Date and time the device registration was deleted in UTC RFC 3339 format.
  - `errors` Errors — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `5XX` — unresolved $ref

---

[API](https://skmtc.dev/rainforestpay/apis/authentication.md) · [All operations](https://skmtc.dev/rainforestpay/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rainforestpay/authentication/revisions/529a0dab0f90/schema)