37 Fee paid

Request: 37
Response: 38
Set: optional
Position in BX: 9

With this command a device reports a payment it has already taken: The money is in the till or the card payment has gone through. The library system credits the amount to the patron account.

The order matters and cannot be reversed: collect first, then report. A device must not send this message in advance to ask whether it may collect – the fee balance in the patron information is there for that.

Request 37#

37<timestamp><fee type><payment type><currency><BV...><AO...><AA...>
  <AC...><AD...><CG...><BK...>

Field	Length	Required	Content
timestamp	18	yes	date and time on the device
fee type	2	yes	what was paid for, see below
payment type	2	yes	how it was paid, see below
currency	3	yes	`EUR`

Identifier	Required	Content
`BV`	yes	amount paid
`AO`	yes	institution identifier
`AA`	yes	patron identifier
`AC`	no	terminal password
`AD`	no	patron password
`CG`	no	identifier of the individual fee paid
`BK`	no	transaction number of the device

Fee type#

Value	Meaning	Value	Meaning
`01`	other	`06`	rental
`02`	administrative	`07`	replacement
`03`	damage	`08`	computer access charge
`04`	overdue	`09`	hold fee
`05`	processing

Payment type#

Value	Meaning
`00`	cash
`01`	card payment
`02`	other cashless payment

The distinction is not cosmetic: Cash belongs in the library's till, cashless payments in the bank account. A library system that keeps the two apart needs this information for its daily closing.

Response 38#

38<payment accepted><timestamp><AO...><AA...><BK...><AF...><AG...>

Field	Length	Required	Content
payment accepted	1	yes	`Y` posted, `N` not posted
timestamp	18	yes	date and time on the library system

Identifier	Required	Content
`AO`	yes	institution identifier
`AA`	yes	patron identifier
`BK`	no	transaction number from the request
`AF`	no	message for the screen
`AG`	no	message for the receipt

The transaction number BK belongs on the patron's receipt. It is the only thread by which a disputed payment can later be traced.

Example#

3720260728    1430120400EURBV2.50|AOBVS|AA1140360000042|BK20260728-0042|AY0AZEE51<CR>
38Y20260728    143012AOBVS|AA1140360000042|BK20260728-0042|AFPayment accepted|AG|AY0AZE942<CR>

Overdue fine (04), paid in cash (00), 2.50 EUR.

This page was translated automatically from the German original. If anything reads oddly or looks wrong, please let us know — the German edition prevails.