Start of Payment or Management transaction

The following routines are recommended for starting a transaction on CliSiTef.

What differentiates the transaction to be executed is the Function code passed as a parameter. (See Table 5.2.2)

The various transactions initiated by commercial automation are grouped by fiscal data, which is the pair (CupomFiscal, DataFiscal) and with this data, controls on transactions pending confirmations from CliSiTef are carried out.

HoraFiscal is important for security validations of some pinpad manufacturers (in order to prevent attacks and fraud).

int IniciaFuncaoSiTefInterativo (Function, Value, Tax Coupon, Tax Data,

HoraFiscal, Operator, ParamAdic)

Interface ASCII

IniciaFuncaoSiTefInterativoA (Result, Function, Value, Tax Coupon, Tax Data,

HoraFiscal, Operator, ParamAdic)

---

The functions below were used for Self-Service terminals, and are considered obsolete.

int IniciaFuncaoAASiTefInterativo (Function, Value, Tax Coupon, Tax Data,

HoraFiscal, Operator, ParamAdic, Products)

ASCII interface

IniciaFuncaoAASiTefInterativoA (Result, Function, Value, Tax Coupon, Tax Date,

HoraDiscal, Operator, ParamAdic, Products)

---

Parameter	Type	Standard Interface	ASCII Interface	Description
Result	Output, please	Not used	Fixed 6	Contains the result of the response to the routine call
Function	Input please	int	Fixed 6	Select the payment method, according to the “Function Codes” table below.
Value	Input please	char *	Variable	Contains the amount to be paid including the decimal separator (“,”). It must always be passed with two decimal places after the comma (“,”). If the operation does not have a value defined a priori (e.g. prepaid recharge), this field must be empty.
Tax Coupon	Entry, please	char *	Max 20	Tax Coupon Number corresponding to the sale It is important that the tax coupon number is always increasing (increased with each transaction), as the entire transaction control process CliSiTef pending and confirmations are based on the CouponFiscal + DataFiscal set.
Tax Date	Entry, please	char *	Fixed 8	Fiscal Date in AAAAMMDD format
Tax Time	Entry, please	char *	Fixed 6	Fiscal Schedule in HHMMSS format
Operator	Entry please	char *	Max. 20	Identification of the cashier
ParamAdic	Entry please	char *	Variable	Additional parameters. Allows the application to limit the type of payment method. It is optional and can be passed empty. When this field is used, CliSiTef will limit the navigation menus only to codes not present in the list. See item 5 for the description of the internal format of this field
Products	Entry please	char *	Variable	Contains the list of products that the customer is purchasing at the Self-Service terminal. It is mandatory as these products will form an integral part of the Tef operation receipt to be printed. The basic format of this field is: See Example below

Basic product field format:

[<Description1>;<Code1>;<Quantity1>;<Total Value1>];

[<Description2>;<Code2>;<Quantity2>;<Total Value2>];...

Field	Format
Description	1 to 14 characters
Code	1 to 08 characters
Quantity	1 to 04 digits
Value	999,999.99

It must be repeated as many times as the number of distinct products purchased by the customer.

---

IMPORTANT: This routine only starts the payment process. If the return is 10000 the payment process must be continued through the routine ContinuaFuncaoSiTefInterativo or ContinuaFuncaoSiTefInterativoA until the latter returns a final result (see item that describes this function).

---

---

IMPORTANT: up to version 6.1.114.39 (inclusive) of clisitef, whenever a payment is initiated on a new tax document (a pair <CupomFiscal, DataFiscal> different from the previous one), data from the previous transaction will be replaced by those of the newly started one, making it impossible for some treatments, such as pending issues, to be carried out successfully. Therefore, all necessary treatments must be resolved before starting a new transaction

---

From version 6.1.114.40 (inclusive), CliSiTef allows you to start a new payment, without deleting any pending issues from the previous tax document

5.2.1 Return code table

Value	Description
0	Success in executing the function
10000	The process continuity routine must be called.
other positive value	Denied by authorizer.
-1	Module not initialized. The POS tried to call some routine without first executing the configure function.
-2	Operation canceled by operator
-3	The function / modality parameter is non-existent/invalid.
-4	Lack of memory in the POS.
-5	No communication with SiTef.
-6	Operation canceled by user (on pinpad).
-7	Reserved
-8	CliSiTef does not have the necessary function implementation, it is probably outdated (CliSiTefI is more recent).
-9	The automation called the routine ContinuaFuncaoSiTefInterativo without first starting an iterative function.
-10	Some mandatory parameter was not passed by commercial automation.
-12	Error executing the iterative routine. Probably the previous iterative process was not executed until the end (while the return is equal to 10000).
-13	Tax document not found in CliSiTef records. Returned in query functions such as GetPendingTransactionQuantity.
-15	Operation canceled by commercial automation.
-20	Invalid parameter passed to the function.
-21	A prohibited word, for example PASSWORD, is used to collect open data on pinpad. For example, in the function ObtemDadoPinpadDiretoEx
-25	Banking Correspondent Error: Bloodletting must be carried out.
-30	File access error. Make sure that the user running the application has read/write rights.
-40	Transaction denied by SiTef server.
-41	Invalid data
-42	Reserved
-43	Problem executing any of the routines on the pinpad.
-50	Unsecured transaction.
-100	Internal module error.
other negative value	Errors detected internally by the routine.

2.2 Function code table

The following codes are available to be used in the Function parameter described above¹

Function	Description
0	Generic payment. CliSiTef allows the operator to choose the payment method through menus.
1	Check
2	Debt
3	Credit
4	Fininvest
5	Benefit Card
6	Centralized Credit
7	Fuel Card
8	Pay More Redecard
10	Wappa Meal Benefit
11	Wappa Food Benefit
12	Infocard
13	PayPass
15	Sale with Gift Card
16	Debit for payment of carnet
17	Credit for payment of carnets
28	Sales with Quality Card (ICI Card)
...
100	Telemarketing: Initiates collection of transaction data at the point needed to handle an entered credit card transaction
...
101	Cancellation of sales with a Quality card (ICI Card)
110	Open the Management transactions menu
111	Communication test with SiTef
112	Reprint Menu
113	Re-print specific voucher
114	Reprint last receipt
115	Pre-authorization
116	Pre-authorization capture
117	Pre-authorization adjustment
118	Pre-authorization consultation
...
130	Querying pending transactions on the terminal
131	Querying pending transactions in a specific tax document

• ¹ See specific product documents for other function codes

Function	Description
150	Bonus Consultation
151	Gift Card Balance Inquiry
152	Gift Card Balance Inquiry
...
160	EMS Card Consultations
161	EMS Card Sales
...
200	Normal Cancellation: Starts data collection at the point necessary to cancel a debit or credit transaction, without having to first go through the administrative transactions menu
201	Telemarketing Cancellation: Similar to modality 200 but for the function of canceling entered credit transactions
202	Pre-authorization Cancellation
203	Cancellation of Pre-Authorization Capture
210	Cancellation of credit card sales
211	Cancellation of sales with Debit card
212	Cancellation of sales with Fuel card
213	Cancellation of Gift Card Sales
250	Bonus Consultation Cancellation
251	Cancellation Gift Card Recharge
253	Cancellation Accumulation of Points Bonus Card
254	Points Redemption Bonus Card
255	Cancellation of Bonus Card Points Redemption
256	Accumulation of Bonus Card Points
257	Gift Card Recharge Cancellation
...
264	Gift Card Recharge
265	Activation Linked Payment Gift Card
266	Gift Card Consultation
267	Gift Card Activation Without Payment
268	Gift Card Activation With Payment
269 ​​	Activation Unlinked Gift Card
...
310	Bank Correspondence (Bill Payment)
311	Payment of Bills with Withdrawal
...
312	Consultation for Unlinked Payment (Generic)
313	Unlinked Payment (Generic)
314	Corban SE Prepaid Recharge with Withdrawal
315	Withdrawal for Payment
316	Unlinked Payment Cancellation (Generic)
317	Consultation Banking Correspondent Limits
318	Bradesco Prepaid Recharge
319	Bradesco Prepaid Recharge disconnected from payment
320	Corban SE Prepaid Recharge
321	Corban SE Prepaid Recharge disconnected from payment
...
322	Identified Deposit
323	Transfer between Accounts
324	Pay Easy
325	INSS Password Revalidation
...
350	Sell ​​Product (No Value)
351	Product Sale Cancellation (No Value)
...
400	Vale-Gás
401	Vale-Gás Validation
410	Surprise Change
...
422	Insurance Membership
...
430	Le Cartão Seguro (LeCartaoSeguro)
431	Le Trilha Chip (LeTrilhaChipInterativoEx)
...
500	ACSP Detailed Consultation
501	Serasa Detailed Consultation
...
600	Balance Inquiry
601	Debit Card Balance Inquiry
602	Credit Card Balance Inquiry
...
657	Withdraw Credit Transfer
658	Withdraw Credit
...
660	IBI Withdrawal Menu
661	IBI Bank Withdrawal Consultation
...
662	IBI Bank Withdrawal
...
663	GetNet Withdrawal
664	GetNet Withdrawal Cancellation
...
665	Points Redemption
667	Points Issuance
668	Cancellation of Point Issuance
669	Prepaid Load
670	Cancellation of Prepaid Load
...
671	Withdrawal Consultation with IBI Bank Withdrawal
672	IBI Bank Withdrawal Cancellation
...
680	Prepaid Balance Inquiry
...
698	Debit Withdrawal
...
700	Sale Oi Paggo
701	Hi Paggo Cancellation
702	Bill Payment
703	Benefit Card Payment Cancellation
...
705	Invoice Payment
...
740	Adm Credit Installment Consultation
...
770	Loading tables on pinpad²
771	Forced loading of tables on pinpad (Local)
772	Forced loading of tables on the pinpad (SiTef)
...
775	Obtaining information from the pinpad³
...
899	Credit card recharge
900	Credit card top-up cancellation
...
913	Change of Pre-Authorization
...
928	Debit Cancellation for Payment Carnet Forced Network
...
943	Payment Invoice without linked invoice
944	Payment Invoice without unlinked invoice
...
999	Closing
...
1000	Paper Voucher

---

• ² See item 5.12 - Loading Tables in PinPad for more information.

• ³ See item 5.11 - PinPad Information for more information.

---