# Create a new customer payment

Create a new customer payment to be disbursed to invoices and/or customer's outstanding balance

Endpoint: POST /customer-payments
Version: 1.37
Security: bearerAuth

## Request fields (application/json):

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

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

  - `description` (string)
    Payment description

  - `reference` (string)
    Payment reference from third party payment system

  - `type` (string, required)
    Payment method
    Enum: "CHEQUE", "DIRECT_DEBIT", "CANCELLED_DD", "CANCELLED_CARD", "CREDIT_CARD", "PAYPAL", "BACS", "POST_OFFICE_PAYMENT_CARD", "EZYPAY", "GO_CARDLESS", "GC_INSTANT_BANK_PAYMENTS", "STRIPE", "STRIPE_CARD", "STRIPE_DD", "FINASTRA", "FAST_PAY", "OTHER"

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

## Response 200 fields (application/json):

  - `id` (integer)
    Customer Payment identifier
    Example: 1

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

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

  - `resultingCustomerBalance` (number)
    customer balance after transaction has been applied in major currency (e.g pounds/dollars/euros)
    Example: 10.5

  - `currencyId` (integer, required)
    Currency Id
    Example: 1

  - `description` (string)
    Payment description

  - `reference` (string)
    Payment reference from third party payment system

  - `type` (string, required)
    Payment method
    Enum: "CHEQUE", "DIRECT_DEBIT", "CANCELLED_DD", "CANCELLED_CARD", "CREDIT_CARD", "PAYPAL", "BACS", "POST_OFFICE_PAYMENT_CARD", "EZYPAY", "GO_CARDLESS", "GC_INSTANT_BANK_PAYMENTS", "STRIPE", "STRIPE_CARD", "STRIPE_DD", "FINASTRA", "FAST_PAY", "OTHER"

  - `paymentDate` (string)
    When payment was made

  - `customerPaymentType` (string)
    Type of payment
    Enum: "CUSTOMER", "NORMAL_INVOICE", "ADHOC_INVOICE", "ADJUSTMENT"

  - `txnType` (string)
    Type of transaction
    Enum: "INVOICE_CREATED", "INVOICE_DISPUTED", "INVOICE_WRITTEN_OFF", "INVOICE_UNDISPUTED", "INVOICE_UNWRITTEN_OFF", "INVOICE_REFUNDED", "INVOICE_CHARGED_BACK", "INVOICE_PAYMENT", "CUSTOMER_PAYMENT", "BALANCE_ADJUSTMENT", "INVOICE_UNPAID"

  - `invoiceNumber` (string)
    Invoice Number

  - `invoiceId` (integer)
    Invoice identifier

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


## Response 400 fields

## Response 401 fields

## Response 403 fields