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

# Create device registration

`POST /v1/device_registrations`

## Request

- Base URL: `https://api.sandbox.rainforestpay.com`
- URL: `https://api.sandbox.rainforestpay.com/v1/device_registrations`
- Auth: HTTP bearer

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/payments.md) - [All operations](https://skmtc.dev/rainforestpay/apis/payments/llms.txt) - [OpenAPI document](https://skmtc.dev/rainforestpay/apis/payments/revisions/9d7d0b1553a8?raw)