---
title: "PaymentByNumber (Visma.net Financials)"
description: "Payment by Number"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.Payment.PaymentByNumber
original: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.Payment.PaymentByNumber
updated: 2026-11-01T17:49:50Z
license: https://documentation.invantive.eu/en/
---

# PaymentByNumber: Visma.net Financials Payment by Number

`read only` `REST`

- Catalog: `VismaNet`
- Schema: `Payment`
- Label: Payment by Number

Get a specific Payment
Payment is deprecated, please use CustomerPayment instead.

Can only retrieve data.

## API Source

- Endpoint: `/v1/payment/{paymentNumber}`
- Operation: `get /v1/payment/{paymentNumber}`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 155 |
| Full scan rows per minute | 29,100 |
| Point query rows per minute | 387 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `paymentNumber` | `` | [x] |  | Identifies the Payment |

## Table Columns

The columns of the table `PaymentByNumber` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `COMPANY_CODE` | `varchar2(30)` | Company Code | [x] | writable | Partition code, segmenting the data. |
| `COMPANY_NAME` | `varchar2(240)` | Company Name | [x] | writable | Name of the partition. |
| `applicationDate` | `datetime` | Application Date | [ ] | filters on the platform, writable, `applicationDate` | Mandatory field: The top part &gt; Date* &gt; The date when a payment is applied to a document (invoice or note). The field display the current business date for tunapplied or partially applied payments and the latest application date for the closed payment |
| `applicationPeriod` | `varchar2` | Application Period | [ ] | filters on the platform, writable, `applicationPeriod` | Mandatory field: The top part &gt; Financial period* &gt; The period to which the payment should be applied, which the system fills in based on the date. |
| `appliedToDocuments` | `double` | itgen_vnet_appliedtodocuments | [ ] | filters on the platform, writable, `appliedToDocuments` | The top part &gt; Applied to documents &gt; The total of the documents to which payment is to be applied. |
| `appliedToOrders` | `double` | itgen_vnet_appliedtoorders | [ ] | filters on the platform, writable, `appliedToOrders` | The top part &gt; Applied to orders &gt; The total of the orders for which payment is reserved, minus the amount transferred to invoice. |
| `availableBalance` | `double` | Available Balance | [ ] | filters on the platform, writable, `availableBalance` | The top part &gt; Available balance &gt; The amount that has not been applied. |
| `availableBalanceInCurrency` | `double` | itgen_vnet_availablebalanceincurrency | [ ] | filters on the platform, writable, `availableBalanceInCurrency` | Available Balance calculated in your default (base) currency. This field is applicable if the amount is given in another currency than your default. |
| `branch` | `varchar2` | Branch | [ ] | filters on the platform, writable, `branch` |  |
| `cashAccount` | `varchar2` | Cash Account | [ ] | filters on the platform, writable, `cashAccount` | Mandatory field: The top part &gt; Cash account* &gt; The default cash account associated with the payment method; this field is not available for credit notes. |
| `currency` | `varchar2` | Currency | [ ] | filters on the platform, writable, `currency` | The top part &gt; Currency &gt; The currency of the payment document. |
| `customer_name` | `varchar2` | Customer Name | [ ] | filters on the platform, writable, `customer.name` | Click the magnifier. &gt; The name. |
| `customer_number` | `varchar2` | Customer Number | [ ] | filters on the platform, writable, `customer.number` |  |
| `deductedCharges` | `double` | Deducted Charges | [ ] | filters on the platform, writable, `deductedCharges` | The top part &gt; Deducted charges &gt; The total amount of bank charges deducted by bank from the payment amount on your cash account (bank account). |
| `errorInfo` | `varchar2` | Error Message | [ ] | filters on the platform, writable, `errorInfo` |  |
| `financeCharges` | `double` | Finance Charges | [ ] | filters on the platform, writable, `financeCharges` | The top part &gt; Finance charges &gt; The total on all finance charges applied to this document. |
| `financialDetails_paymentDate` | `datetime` | itgen_vnet_financialdetails_paymentdate | [ ] | filters on the platform, writable, `financialDetails.paymentDate` | Financial Details tab &gt; Payment date |
| `hold` | `char` | Hold | [ ] | filters on the platform, writable, `hold` | The top part &gt; Hold &gt;  A check box that indicates (if selected) that the document is a draft with the On hold status. This check box is unavailable for debit adjustments. |
| `invoiceText` | `varchar2` | Invoice Text | [ ] | filters on the platform, writable, `invoiceText` | The top part &gt; Invoice text &gt; A user-defined description of the payment. 50 alphanumeric characters. |
| `lastModifiedDateTime` | `datetime` | Last Modified | [ ] | filters on the platform, writable, `lastModifiedDateTime` | Systemgenerated information. |
| `location_countryId` | `varchar2` | Location Country ID | [ ] | filters on the platform, writable, `location.countryId` | Location*. |
| `location_id` | `varchar2` | Location ID | [ ] | filters on the platform, writable, `location.id` | Click the magnifier &gt; The identifier |
| `location_name` | `varchar2` | Location Name | [ ] | filters on the platform, writable, `location.name` | Click the magnifier &gt; The displayed name |
| `metadata_maxPageSize` | `int64` | Metadata Max Pagesize | [ ] | filters on the platform, writable, `metadata.maxPageSize` |  |
| `metadata_totalCount` | `int64` | Total Count | [ ] | filters on the platform, writable, `metadata.totalCount` |  |
| `paymentAmount` | `double` | Payment Amount | [ ] | filters on the platform, writable, `paymentAmount` | The top part &gt; Payment amount &gt; The total of the payment that is entered manually. |
| `paymentAmountInCurrency` | `double` | itgen_vnet_paymentamountincurrency | [ ] | filters on the platform, writable, `paymentAmountInCurrency` | Payment amount calculated in your default (base) currency. This field is applicable if the amount is given in another currency than your default. |
| `paymentMethod_description` | `varchar2` | Payment Method Description | [ ] | filters on the platform, writable, `paymentMethod.description` | Click on the magnifier. &gt; The description. |
| `paymentMethod_id` | `varchar2` | Payment Method ID | [ ] | filters on the platform, writable, `paymentMethod.id` | Click on the magnifier. &gt; The identifier. |
| `paymentRef` | `varchar2` | Payment Reference | [ ] | filters on the platform, writable, `paymentRef` | Mandatory field: The top part &gt; Payment ref.* &gt; A secondary payment reference identifier, which can be a system-generated number or an external reference number entered manually. |
| `refNbr` | `varchar2` | Reference Number | [ ] | filters on the platform, writable, `refNbr` | The top part &gt; Ref.no &gt; The unique identifier for the payment. This number is automatically generated by the system for a new payment document, based on the number series	in the AR101000 window. |
| `status` | `varchar2` | Status | [ ] | filters on the platform, writable, `status` | The top part &gt; Status &gt; The status of the customer payment, which for a new document is either Balanced or On hold. [On hold, Balanced, Voided, Scheduled, Open, Closed, Pending print, Pending email, Credit hold, CcHold, Reserved] |
| `timeStamp` | `blob` | Timestamp | [ ] | filters on the platform, writable, `timeStamp` | Identifier that represents a specific version of the resource. It helps to prevent simultaneous updates of the resource from overwriting each other (by using ETags and If-Match headers) |
| `type` | `varchar2` | Type | [ ] | filters on the platform, writable, `type` | The top part &gt; Type &gt; The type of a document. The following types are available: Payment, CreditNote, Prepayment, Customer refund, Void payment, Balance write-off |
| `writeOffAmount` | `double` | Write-off Amount | [ ] | filters on the platform, writable, `writeOffAmount` | The top part &gt; Write-off amount &gt; The amount that has been written off. |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Visma.net Financials](/en/release-notes/drivers?driver=visma-net-financials)

