Documentation · For Developers

Bank POS integration: POS command and BONOK response

Send the amount to the terminal and explicitly handle the accepted, rejected, or unknown response before issuing the receipt.

Order for the bank payment terminal

The documented command is available in the edition PLUS. The value represents the amount with two decimal places, transmitted without decimal separator. Example: 1000 represents 10.00 RON.

Example · transfer 10.00 RON

POS^1000;

This article retains the classic POS integration protocol. For the transport methods and the version conventions used, also see general guide for integrators.

Interprets the BONOK response

Response	Meaning	Application action
`BONOK=1`	The payment has been accepted.	Continue with the receipt issuance flow.
`BONOK=0`	The payment was not accepted.	Notify the operator; do not issue the receipt as an accepted payment.
`BONOK=-1`	Unknown result or information not received in a timely manner.	Request verification of the transaction on the terminal and confirmation from the operator.

Manual validation in the sales interface

The original example allows the operator to activate manual validation of the transaction, with the actions Accept and Invalidate. At BONOK=1, the application continues automatically; at BONOK=0, notifies of rejection; at BONOK=-1, request verification of the result.

In the documented example, the wait for a response is no more than 2–3 minutes. This interval illustrates the respective flow; configure the waiting time according to the integrated version and terminal.

Original example of manual validation of a POS transaction — Original interface example: Manual confirmation occurs when the transaction result needs to be verified. Click on the image for the original size.

Response file fields

The first line contains BONOK=1, BONOK=0 or BONOK=-1. For a successful response, the original article lists the following fields:

Field structure · values are provided by the integration

BONOK=1
RaspunsTranzactie=
IdComerciant=
IdTerminal=
NrBatch=
NrTranzactie=
CodAutorizare=
Suma=
DataTranzactie=
OraTranzactie=
TipCard=

Continue with the appropriate guide

POS preparation

Activation of communication and parameters from the bank.

POS Configuration

API Documentation

Transport, jobs and responses for integration.

View the documentation

Do you need help?

Send to suport@fiscalnet.ro FiscalNET version, equipment model, connection type and the exact message displayed.