---
title: "Generate a new Verifone Merchant ID based on Range"
method: POST
path: "/entities/mid/{rangeId}"
tags: ["MID/TID Generation"]
---

# Generate a new Verifone Merchant ID based on Range

`POST /entities/mid/{rangeId}`

Generate a new Verifone Merchant ID based on range, which is configured in the Order Service configuration database.

## Path parameters

- `rangeId` string, required

## Response `201`

MID Generated.

- MidAllocation — VFI Merchant ID allocated.
  - `altVfiEntityId` string, required — A friendly ID associated with the merchant site/company. This will be visible/searchable in Verifone central. In many cases this will be the same value as merchantId. <strong>This value is not guaranteed as globally unique within Verifone. That value is the entityUid (uuid) property that will be assigned on creation of the Entity and returned on the response.</strong>.

## Other responses

- `400` — Bad Request
- `401` — Unauthorised Request
- `403` — Forbidden Request.
- `404` — Not Found Request
- `429` — Too Many Requests
- `500` — Internal Error
- `503` — Service Not Available
- `504` — Service Timeout

---

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