---
title: "Create merchant"
method: POST
path: "/merchant-account/create"
tags: ["Merchant Account"]
---

# Create merchant

`POST /merchant-account/create`

Register a new merchant account. The merchant ID is the primary identifier used in all subsequent routing and scoring calls.

## Request body

- CreateMerchantRequest
  - `merchant_id` string, required
  - `gateway_success_rate_based_decider_input` string, nullable

## Response `200`

Merchant created

- MerchantAccountCreateResponse
  - `message` string
  - `merchant_id` string
  - `gateway_success_rate_based_decider_input` string, nullable
  - `api_key` string, nullable — Default API key minted for the new merchant. Shown only once.

## Changes

- **2026-08-04** `36e7a0972ee6` — 1 breaking, 1 info
  - the request property `gateway_success_rate_based_decider_input` became not nullable
  - added the optional property `api_key` to the response with the `200` status
- **2026-04-25** `986e537b0455` — 1 info
  - the endpoint scheme security `AdminSecret` was added to the API
- **2026-04-10** `9618544de91a` — 1 info
  - the endpoint scheme security `AdminSecret` was removed from the API

[Change history](https://skmtc.dev/juspay/apis/decision-engine/changes/merchant-account/create/post.md)

---

[API](https://skmtc.dev/juspay/apis/decision-engine.md) · [All operations](https://skmtc.dev/juspay/apis/decision-engine/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/juspay/decision-engine/revisions/a35ceeb59faf/schema)