Allocations allow you to allocate funds to multiple line items on the same Invoice from a single 'Transaction'. For Example, when a payment is made for 4 invoices using the same transaction, allocations help to split the funds across those four invoices.

Use Cases

  1. Receive a bulk payment and distribute the payment across multiple invoices. For example, one $10,000 check can be applied from one Transaction across multiple Line Items on the same Invoice.
  2. Auto-create an Allocation record for each Line Item as part of a paid Event checkout.
  3. Manually create full or partial refund allocations between a Transaction and one or more Line Items.


You cannot allocate more than the amount.

Parent Object Relationship

Allocations are related to the Invoice, Line Item, and Transaction objects. The Invoice lookup field is automatically populated from the Line Item's 'Invoice' field. This allows you to relate your allocation record to Line Item & Invoice or Invoice with Transaction that paid for this Invoice.


Create an Allocation

  • Navigate to our Allocation object.

Lightning: Click on the App Launcher | Under "All Items" | Click on Allocation.

Classic: Click on "All Tabs" ("+" icon in the top right) | Click on Allocation.

  • Click "New".


  • Amount: This field determines the amount for this allocation.

  • Transaction: This field determines the transaction that paid for the Line Item.

  • Line Item: This field determines which line item this allocation is associated with.

  • Invoice: Optional. Automatically populates if the Line Item is set. Populate this only if the allocation is not associated with Line item

  • Type: Set it to either Payment or Refund depending on the type of Allocation. Default is Payment.

  • Click "Save".

Automate the Allocation Creation for Event Checkout

You can automate the allocation creation for event checkouts.

  • Navigate to our Blackthorn | Payment Trigger Settings (Go to Setup --> Custom Settings)
  • Click "Manage".
  • Set the Automatically Create Allocation = true.
  • Click "Save".

When this setting is enabled and an Invoice is created by the checkout process, the allocations are automatically created for the Line Items and Invoice.

Use Allocation to show Refunds on Line Item and Invoice

You can use allocation to handle refunds against the line items or the Invoice.

  • Create an Allocation record.
  • Set Allocation type = Refund.
  • Set the Line Item/Invoice Lookup. Setting a line item lookup will auto-populate the Invoice.
  • Select the Refund Transaction for the allocation
  • Save.

Allocation Rollups

From version 4.131 and above, we have introduced new fields on the Line Item Object.

  • Balance Due

  • Balance Paid

  • Retained Amount

  • Amount Refunded

  • When Allocation type = Payment is associated with the line item object, the value is automatically rolled up to Balance Paid.

  • When Allocation type = Refund is associated with the line item object, the value is automatically rolled up to Amount Refunded.

  • Balance Due = Total Amount - Balance Paid

  • Retained Amount = Total Amount Paid - Amount Refunded.

Did this page help you?