xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Payment — entity reference
REFERENCE · Last reviewed

Payment — entity reference

A single money movement: a customer receipt (Payment Type Payment Taken) or a payment you make, for example to a supplier (Payment Given). It is recorded on the payment form, which lists the account's open documents so the payment can be applied to invoices, bills, orders, credit and debit notes or expense vouchers. When the payment's company has GL posting enabled, saving a new payment posts it immediately: the money side goes to the bank account picked on the form or, failing that, to the company's account for the mode (Cash, Bank, Cheques In Hand or Credit Card), against accounts receivable or payable. Whatever is not applied stays on the account as an advance.

Fields

FieldLabelTypeRequiredWhat it does
AccountIdAccountLookup → AccountThe customer who paid or the supplier who was paid. Selecting it on the payment form loads the account's open documents. Locked once the payment is saved.
AdjustedAmountAdjusted AmountCurrencyHow much of the payment has been applied to documents, maintained from the payment's allocations.
AmountAmountCurrencyThe total amount of money, always positive; the direction comes from Payment Type. Must be greater than zero. Changing it on a posted payment re-posts the payment.
BankNameBank NameTextThe bank named on a cheque or card, or the bank of the company bank account picked in Deposited to / Paid from.
BillIdBillLookup → BillLegacy direct link to a bill. Payments are now applied to bills through allocations made on the payment form or with Apply payment on the bill, and this field is not filled by the standard form.
BranchIdBranchLookup → BranchThe branch of the company whose books take the payment. Defaults to the user's own branch; required when the company works with branches. Locked once saved.
CardExpiryCard ExpiryDateExpiry date of the card used, entered on the payment form in Bank mode.
CardNumberCard NumberNumberCard number entered in Bank mode. Enter only the last four digits.
CardTypeCard TypePickListCredit card or debit card, entered in Bank mode. Values: 3.
ChequeDateCheque DateDateThe date written on the cheque.
ChequeNumberCheque NumberNumberThe cheque number. For a cheque you pay out, leaving it empty takes the next number from the company's active cheque register.
ClaimIdClaimLookup → ClaimNot filled by the standard screens.
ClaimReconciliationIdClaim ReconciliationLookup → ClaimReconciliationNot filled by the standard screens.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CreditNoteIdCredit NoteLookup → CreditNoteOn a refund payment, the credit note being refunded. Not on the standard payment form.
DebitNoteIdDebit NoteLookup → DebitNoteNot filled by the standard payment form; debit notes are applied to bills through allocations.
ElectronicModeElectronic ModePickListThe transfer method for an Electronic Transfer payment, such as NEFT, RTGS, IMPS or UPI. Values: 2.
ExpenseVoucherIdExpense VoucherLookup → ExpenseVoucherLegacy direct link to an expense voucher. Vouchers are now settled through allocations made on the payment form.
ExternalIdExternalText, uniqueReference of the payment in an external system, such as an online payment gateway or an accounting integration.
GeneralLedgerIdGeneral LedgerLookup → GeneralLedgerNot filled for payments; the posted journal is found from the payment itself.
GLAccountIdGL AccountLookup → GLAccountThe money-side GL account the payment posts to. Set by choosing a bank account in Deposited to / Paid from. When empty, posting uses a Payment posting definition with role Header or the company's account of the type matching the mode.
GLAmountGL AmountCalculatedCalculated signed amount: positive for a receipt, negative for a payment given. Posting uses Amount.
IdIdGuidYes
InvoiceIdInvoiceLookup → InvoiceLegacy direct link to an invoice. Payments are now applied to invoices through allocations made on the payment form or with Apply payment on the invoice, and this field is not filled by the standard form.
IsGLPostedGL PostedBooleanNot filled for payments; use GL Posting Status.
IsGLPostingApprovedGL Posting ApprovedBooleanSet by posting when a new payment is saved in a company with GL posting enabled. The Post General Ledger action sets it for a payment that was saved while posting was off.
IsRelatedGLPostedRelated GL PostedBooleanNot used.
LastModifiedByIdLastModifiedByGuidNot stored.
ModeOfPaymentMode Of PaymentPickListHow the money moved, chosen under How was it paid? on the payment form. Cash posts to Cash, Bank and Electronic Transfer to Bank, Cheque to Cheques In Hand (Bank if the company has none), Card to Credit Card when paying out or Bank when receiving; any other value posts to Cash. Values: Cash, Cheque, Bank, Electronic Transfer.
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberTextThe payment's document number, set from the PAY series.
Name (dup-9bd92512)Document NumberText
OpenAmountOpen AmountCalculated (calculated)What is still unapplied: Amount minus Adjusted Amount, less any related GL amount. This is the advance left on the account.
OrderIdOrderLookup → OrderThe sales order a receipt was taken against as an advance. The payment stays open and is applied to the invoice raised from the order.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe company (partner account) whose books take the payment. Defaults to the user's own company. GL posting must be enabled on it for the payment to post. Locked once saved.
PaymentDateDocument DateDateThe accounting date of the payment; its fiscal period must be open. Defaults to today.
PaymentModePaymentModeTextA second copy of the mode, read by the cheque register: a payment creates its cheque transaction only when this is Cheque. The web payment form fills it with the same value as Mode Of Payment; the mobile app does not.
PaymentTypePayment TypePickListPayment Taken (a receipt from a customer, posted against accounts receivable) or Payment Given (a payment you make, posted against accounts payable). Defaults to Payment Taken; locked once saved. Values: Payment Given, Payment Taken.
PayrollRunIdPayroll RunLookup → PayrollRunNot filled by the standard screens; payroll is paid through payroll payment batches.
PurchaseOrderIdPurchase OrderLookup → PurchaseOrderThe purchase order a supplier payment was made against as an advance. It is applied to the bill raised from that order.
RecordTypeIdRecord TypeGuid, hidden
RelatedGeneralLedgerIdRelated General LedgerLookup → GeneralLedgerNot filled by the standard screens.
RelatedGLAccountIdRelated GL AccountLookup → GLAccountOptional account for a third journal line, such as exchange gain or loss or bank charges. Must be filled together with Related GL Amount. Not on the standard web form.
RelatedGLAmountRelated GL AmountCalculatedAmount of the third journal line: positive for a gain, negative for a charge or loss. Must be smaller than the payment amount.
RemarksRemarksLongMultiLineTextFree text entered on the payment form and shown on the receipt.
ServiceOrderIdService OrderLookup → ServiceOrderThe service order a receipt was taken against.
StatusStatusPickListDraft when the payment is created; set to Posted when the payment posts, and back to Draft if the posting is withdrawn. Not changed when a cheque bounces. Values: Draft, Posted.
TransactionDateTransaction DateDateThe date the bank executed an electronic transfer.
TransactionReferenceTransaction ReferenceTextThe bank's reference for the payment, entered as the UTR number for an electronic transfer.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete in a list page
EditEntityEditEditEditEntity
EditInLineEditEditInlineDelete in page.
EditInListEditEditInlineEdit
EditListRowEditEditEditListRow
NewNewNewNew
PostGeneralLedgerPost General LedgerServerAction (PostGeneralLedger)Despite the name, the action body only turns IsGLPostingApproved on and saves. The journal, the settlement allocation or on-account open item, and the cheque, TDS and TCS side effects are all produced afterwards by the payment's save pipeline, which posts whenever that flag becomes true. Payments created through the ordinary insert path already post without this action, so it is mainly a way to post one that was entered while GL posting was withheld.
UIActionUI ActionUIActionA placeholder entry of UI type; the payment handler supports only PostGeneralLedger, so nothing on the server claims this name and invoking it performs no server-side work.

Lookup filters

FilterLookup fieldNotes
BranchFilterBranchId
Customer Account FilterAccountId
PartnerAccountFilterPartnerAccountId