# Create Rate Card

Create a new rate card to group related rates.

Scope:
- MERCHANT - Available to all accounts
- ACCOUNT - Available to specific accounts only

Endpoint: POST /rateCards
Version: 1.0.0
Security: OAuth2

## Request fields (application/json):

  - `name` (string, required)

  - `scope` (string, required)
    Scope of rate card availability
    Enum: "MERCHANT", "ACCOUNT"

  - `tags` (object)

## Response 201 fields (application/json):

  - `id` (string, required)

  - `entityId` (string, required)

  - `name` (string, required)

  - `scope` (string, required)
    Scope of rate card availability
    Enum: "MERCHANT", "ACCOUNT"

  - `tags` (object)

  - `optimisticLockVersion` (integer)
    Optimistic locking version (managed by Hibernate @Version). Prevents concurrent update conflicts.

  - `createdAt` (string, required)

  - `updatedAt` (string)

## Response 400 fields (application/json):

  - `result` (object, required)

  - `result.status` (string, required)
    Response status (always ERROR for error responses)
    Enum: "ERROR"

  - `error` (object, required)

  - `error.responseCode` (string, required)
    Response code (numeric or contains numbers, e.g., "404", "409", "500", "ERR001")
    Example: "404"

  - `error.responseMessage` (array, required)
    Array of error message strings for multiple error details
    Example: ["Charge not found","The requested charge ID does not exist in the system"]

## Response 401 fields (application/json):

  - `result` (object, required)

  - `result.status` (string, required)
    Response status (always ERROR for error responses)
    Enum: "ERROR"

  - `error` (object, required)

  - `error.responseCode` (string, required)
    Response code (numeric or contains numbers, e.g., "404", "409", "500", "ERR001")
    Example: "404"

  - `error.responseMessage` (array, required)
    Array of error message strings for multiple error details
    Example: ["Charge not found","The requested charge ID does not exist in the system"]