# Create a new invoice payment event

Create a new invoice payment event. Used for disputing an invoice, writing off an invoice, undisputing, un-writting off and undoing a payment for an invoice made in error

Endpoint: POST /invoice-payment-events
Version: 1.21
Security: bearerAuth

## Request fields (application/json):

  - `invoiceId` (integer, required)
    Invoice identifier

  - `billRunType` (string, required)
    Billing run type
    Enum: "NORMAL", "ADHOC"

  - `paymentStatus` (string, required)
    Invoice payment status
    Enum: "NA", "PAID", "UNPAID", "PENDING", "REFUNDED", "PART_REFUNDED", "REFUND_PENDING", "WRITTEN_OFF", "DISPUTED", "PARTIALLY_PAID"

  - `notes` (string, required)
    Notes on payment change

  - `amountInMajorCurrency` (number)
    Amount in major currency (e.g pounds/dollars/euros)
    Example: 10.5

## Response 200 fields (application/json):

  - `id` (integer)
    Invoice History identifier
    Example: 1

  - `invoiceId` (integer, required)
    Invoice identifier

  - `customerId` (integer)
    Customer identifier
    Example: 1

  - `billRunType` (string, required)
    Billing run type
    Enum: "NORMAL", "ADHOC"

  - `paymentStatus` (string, required)
    Invoice payment status
    Enum: "NA", "PAID", "UNPAID", "PENDING", "REFUNDED", "PART_REFUNDED", "REFUND_PENDING", "WRITTEN_OFF", "DISPUTED", "PARTIALLY_PAID"

  - `notes` (string, required)
    Notes on payment change

  - `amountInMajorCurrency` (number)
    Amount in major currency (e.g pounds/dollars/euros)
    Example: 10.5

## Response 201 fields (application/json):

  - `id` (integer)
    Invoice History identifier
    Example: 1

  - `invoiceId` (integer, required)
    Invoice identifier

  - `customerId` (integer)
    Customer identifier
    Example: 1

  - `billRunType` (string, required)
    Billing run type
    Enum: "NORMAL", "ADHOC"

  - `paymentStatus` (string, required)
    Invoice payment status
    Enum: "NA", "PAID", "UNPAID", "PENDING", "REFUNDED", "PART_REFUNDED", "REFUND_PENDING", "WRITTEN_OFF", "DISPUTED", "PARTIALLY_PAID"

  - `notes` (string, required)
    Notes on payment change

  - `amountInMajorCurrency` (number)
    Amount in major currency (e.g pounds/dollars/euros)
    Example: 10.5


## Response 400 fields

## Response 401 fields

## Response 403 fields