---
title: "Changes to Create a Merchant Device"
method: POST
path: "/merchants/{merchant_id}/devices"
---

# Changes to Create a Merchant Device

`POST /merchants/{merchant_id}/devices`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 9 revisions.

- **2026-08-21** `96653f0c196b` — 1 breaking, 17 warning, 5 info
- **2026-08-13** `3173732208e4` — 1 warning, 2 info
- **2026-08-11** `425a15f60e06` — 2 warning

## Changes

- **2026-08-21** `96653f0c196b` — 1 breaking, 17 warning, 5 info
  - the `configuration` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - removed the optional property `configuration/allow_debit` from the response with the `201` status
  - removed the optional property `configuration/allow_standalone_authorizations` from the response with the `201` status
  - removed the optional property `configuration/allow_standalone_refunds` from the response with the `201` status
  - removed the optional property `configuration/allow_standalone_sales` from the response with the `201` status
  - removed the optional property `configuration/bypass_device_on_capture` from the response with the `201` status
  - removed the optional property `configuration/check_for_duplicate_transactions` from the response with the `201` status
  - removed the optional property `configuration/display_tip_on_receipt` from the response with the `201` status
  - removed the optional property `configuration/idle_image_file_id` from the response with the `201` status
  - removed the optional property `configuration/idle_message` from the response with the `201` status
  - removed the optional property `configuration/prompt_amount_confirmation` from the response with the `201` status
  - removed the optional property `configuration/prompt_for_signature` from the response with the `201` status
  - removed the optional property `configuration/prompt_manual_entry` from the response with the `201` status
  - removed the optional property `configuration/prompt_receipt_confirmation` from the response with the `201` status
  - removed the optional property `configuration/prompt_tip_on_screen` from the response with the `201` status
  - removed the optional property `configuration/signature_threshold_amount` from the response with the `201` status
  - removed the optional property `configuration/surcharge_basis_points` from the response with the `201` status
  - removed the optional property `configuration/tipping_details` from the response with the `201` status
  - added the new optional request property `configuration/automatic_receipt_delivery_methods`
  - added the new optional request property `configuration/available_receipt_methods`
  - the request property `configuration/surcharge_basis_points` became nullable
  - added the optional property `configuration_details` to the response with the `201` status
  - added `#/components/schemas/device_configuration` to the `configuration` response property `allOf` list for the response status `201`
- **2026-08-13** `3173732208e4` — 1 warning, 2 info
  - added the new `IOS_TAP_TO_PAY` enum value to the `model` response property for the response status `201`
  - added the new optional request property `app_bundle_id`
  - added the new `IOS_TAP_TO_PAY` enum value to the request property `model`
- **2026-08-11** `425a15f60e06` — 2 warning
  - added the new `PAX_A35` enum value to the `model` response property for the response status `201`
  - added the new `PAX_A3700` enum value to the `model` response property for the response status `201`

---

[Operation](https://skmtc.dev/finix/apis/finix-api-reference/docs/merchants/:merchant_id/devices/post.md) · [API](https://skmtc.dev/finix/apis/finix-api-reference.md) · [Page](https://skmtc.dev/finix/apis/finix-api-reference/changes/merchants/:merchant_id/devices/post)
