v1

latestSwagger 2.02026-07-13107162315.5 KB
Payment

Records a new customer payment. Optionally include allocations to apply the payment against specific invoices.

post/api/Payment

Request body

Amountnumber double

Total amount of the payment.

PaymentNumberstring

Optional. If not specified will be automatically generated

DateIssuedstring date-time

Date of Payment. If not specified, assumes today.

TransactionPrefixstring

Optional to override the default prefix added to Payment Numbers

CustomerIDFKinteger

Only required if no invoice allocations specified.

ExchangeRatenumber double

Optional. Only used when the Customer's currecy is different from the Avaza account's base currency. Specifies the exchange rate that should apply between the customer currency and base currency. If not provided we will obtain an up to date exchange rate for the Payment Issue Date.

TransactionReferencestring

Optional for storing the reference # of the payment method.

Notesstring
PaymentProviderCodestring

Optional for storing the payment provider who was the source of funds.

SendWebhooksboolean

If true, fires the invoice_updated webhook event for each invoice that was allocated against. Defaults to false to preserve existing integration behaviour.

Response

Returns the created payment with allocations.

TransactionIDinteger

Unique identifier for the payment transaction.

AccountIDFKinteger

The Avaza account this payment belongs to.

TransactionPrefixstring

The prefix used in the payment number.

PaymentNumberstring

The full payment number including prefix.

TransactionReferencestring

External reference number (e.g. cheque number or bank reference).

CustomerIDFKinteger

The customer company ID this payment is from.

DateIssuedstring date-time

The date the payment was made.

TransactionStatusCodestring

Current status of the payment.

PaymentProviderCodestring

Code identifying the payment provider/method used.

ExchangeRatenumber double

Exchange rate to the account's base currency.

Balancenumber double

Unallocated balance remaining on the payment.

CurrencyCodestring

ISO 3-character currency code for the payment.

TotalAmountnumber double

Total payment amount.

Notesstring

Additional notes on the payment.

DateCreatedstring date-time

Date and time the record was created.

DateUpdatedstring date-time

Date and time the record was last updated.

ViewPaymentURLstring

URL to view this payment in the Avaza web application.