# Create paymentmethod

Creates a new Paymentmethod record. Paymentmethod resource in the Animal Health Data Store

Endpoint: POST /site/{siteId}/ahds/v1/paymentmethod
Version: 1.0
Security: bearer

## Security:

  - `bearer` (unknown)
    http bearer JWT

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `commissionRate` (string)
    Commission rate as a decimal fraction (e.g., '0.025' for 2.5%).
    Example: example

  - `extensions` (object)
    Vendor- or practice-specific extensions. Keys SHOULD be URIs or namespaced identifiers to avoid collisions.

  - `isActive` (boolean, required)
    Whether this payment method is active and can be used.
    Example: true

  - `name` (string, required)
    Human-readable name of the payment method (e.g., Cash, Visa).
    Example: Example Name

  - `paymentMethodType` (string)
    High-level category of the payment method.
    Enum: "cash", "card", "bankTransfer", "check", "online", "other"

  - `paymentmethodId` (string)
    Canonical identifier for the payment method.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `surcharge` (object)
    Configuration for any surcharge applied when using this payment method.

  - `isUsingEftposTerminal` (boolean)
    Indicates if this payment method uses an EFTPOS/credit card terminal.
    Example: true

## Response 201:

  - `201` (unknown)
    Paymentmethod created successfully

## Response 201 fields (application/json):

  - `commissionRate` (string, required)
    Commission rate as a decimal fraction (e.g., '0.025' for 2.5%).
    Example: example

  - `createdAt` (string, required)
    Timestamp when the payment method was created, in RFC 3339 format with timezone offset.
    Example: 2025-01-01T00:00:00.000Z

  - `extensions` (object, required)
    Vendor- or practice-specific extensions. Keys SHOULD be URIs or namespaced identifiers to avoid collisions.

  - `isActive` (boolean, required)
    Whether this payment method is active and can be used.
    Example: true

  - `name` (string, required)
    Human-readable name of the payment method (e.g., Cash, Visa).
    Example: Example Name

  - `paymentMethodType` (string, required)
    High-level category of the payment method.
    Enum: "cash", "card", "bankTransfer", "check", "online", "other"

  - `paymentmethodId` (string, required)
    Canonical identifier for the payment method.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `surcharge` (object, required)
    Configuration for any surcharge applied when using this payment method.

  - `updatedAt` (string, required)
    Timestamp when the payment method was last updated.
    Example: 2025-01-01T00:00:00.000Z

  - `isUsingEftposTerminal` (boolean, required)
    Indicates if this payment method uses an EFTPOS/credit card terminal.
    Example: true

## Response 400:

  - `400` (unknown)
    Invalid request body

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 409:

  - `409` (unknown)
    Paymentmethod with this ID already exists

