POST https://api.legendonlineservices.co.uk/POS/BillingPayments

Records payments againt set of billing items

Request Parameters

From Body Type Description
ContactId Guid Contact who owns the Billing items
PaymentDate DateTime The date the payment was collected
TenderTypeId Int32 Check Legend support for the TenderTypeId
[BillingPaymentsRequestLineItem] List of billing items and payments. Make sure there is always one BillingId per request
Name Type Description
Amount Decimal Must be greater than zero and must not exceed the balance
AuthorizationCode String Max 100 characters
BillingId Int32 Legend BillingId
Notes String Optional. Any user friendly not to help during the reconcillation process
ThirdPartyReference String This will be used for reconcillation with external system 




{
  "ContactId": "c3147346-8bd9-4445-9790-f57cafbe3887",
  "PaymentDate": "2025-09-16T18:54:05.6355329+01:00",
  "BillingPayments": [
    {
      "BillingId": 1,
      "Amount": 2.0,
      "ThirdPartyReference": "sample string 3",
      "Notes": "sample string 4",
      "AuthorizationCode": "sample string 5"
    },
    {
      "BillingId": 1,
      "Amount": 2.0,
      "ThirdPartyReference": "sample string 3",
      "Notes": "sample string 4",
      "AuthorizationCode": "sample string 5"
    },
    {
      "BillingId": 1,
      "Amount": 2.0,
      "ThirdPartyReference": "sample string 3",
      "Notes": "sample string 4",
      "AuthorizationCode": "sample string 5"
    }
  ],
  "TenderTypeId": 2
}

Response - (Status 200 - OK)

BillingPaymentsResponse

Name Type Description
ContactId Guid Contact who the Billing items belongs to
ErrorMessage String Error message if there is a global failure
Success Boolean
[BillingPaymentsResponseLineItem] For each payment request, you will get one line item
Name Type Description
Balance Decimal Balance left on the billing item
BillingId Int32 Legend BillingId
ErrorMessage String For basic validation like not enough balance etc
PaymentDate DateTime
ProcessDate DateTime 




{
  "ContactId": "f20fe592-fcb9-4535-809a-af281b04204e",
  "BillingPayments": [
    {
      "BillingId": 1,
      "Balance": 1.0,
      "ProcessDate": "2025-09-16T18:54:05.6511706+01:00",
      "PaymentDate": "2025-09-16T18:54:05.6511706+01:00",
      "ErrorMessage": "sample string 2"
    },
    {
      "BillingId": 1,
      "Balance": 1.0,
      "ProcessDate": "2025-09-16T18:54:05.6511706+01:00",
      "PaymentDate": "2025-09-16T18:54:05.6511706+01:00",
      "ErrorMessage": "sample string 2"
    },
    {
      "BillingId": 1,
      "Balance": 1.0,
      "ProcessDate": "2025-09-16T18:54:05.6511706+01:00",
      "PaymentDate": "2025-09-16T18:54:05.6511706+01:00",
      "ErrorMessage": "sample string 2"
    }
  ],
  "ErrorMessage": "sample string 2",
  "Success": false
}

Bundle(s)
BillingPayment