Processing Indicator Item
Overview
This table expands on the values provided and are applicable to the Greek market only.
The processingIndicator indicates the type of payment within the pay items block and defines how the Viva processes the individual payment in terms of the receipt.
The data type is Int64 and contains a country specific code which is a value following the ISO-3166-1-ALPHA-2 standard, converted from ASCII into hex and used as byte 8 and 7.
Format
The format of the processingIndicator parameter on payment item level, should be the below.
CCCC_vlll_gggg_xxPP
Example
4752_2000_0001_0004
- CCCC = 4752 | The two ASCII letters that specify the ISO country code (https://en.wikipedia.org/wiki/ISO_3166-1) (e.g. GR = 4752)
- vlll = 2000 | This section is for versioning the tagging system (the current is the v2) (e.g. 2000)
- gggg = 0001 | This item is used for flag. Flag can change the basic behavior of a given type, but will live the overall semantical meaning of a type the same. (e.g. voiding of a receipt)
- xx = 00 | The first part of the xxPP section should be ever 00.
- PP = 04 | The first part of the xxPP section, specify the Payment Type.
The 4752200000010004 is hex and should be converted to decimal number (5139205309155311620). So, the value that should be passed through in the body request.
A helpful online tool for your converting tests is this.
Flag (gggg)
| Value | Description |
|---|---|
0001 |
IsVoid Marks PayItem as Void previous position. Amounts and quantities are inverted. Used when the exchange of money has not yet been executed. |
0002 |
IsReturn/IsRefund Marks PayItem as a return of goods or services. Amounts and quantities are inverted. Used when the exchange of money has already been executed. |
0004 |
(reserved) |
0008 |
Downpayment + Amount reduces downpayment, - Amount creates downpayment. |
0010 |
IsForeignCurrency Amount is in EUR at the moment of acceptance. Requires foreignCurrencySymbol and foreignCurrencyAmount. |
0020 |
IsChange Usually contains a negative amount (-). Can be inverted when IsVoid. |
0040 |
IsTip Must be a negative amount (-) to flow out of payment method. ShowInChargeItems flag can visualize the tip separately. |
0080 |
IsDigital/IsElectronic Electronic money, digital money. |
0100 |
IsInterface/AmountVerified Verified by interface, automated amount transfer. |
8000 |
ShowInChargeItems Visualizes the item before the total amount, inverting it to be included in the receipt total. |
Payment Type (PP)
| Value | Description |
|---|---|
00 |
Unknown payment type for GR Handled like a cash payment in national currency. |
01 |
Cash payment Cash |
02 |
NonCash Cash |
03 |
Crossed cheque Cash |
04 |
Debit card payment Cash |
05 |
Credit card payment Cash |
06 |
Voucher payment (coupon) - voucher by money value Cash |
07 |
Online payment Noncash |
08 |
Loyalty program Customer card payment |
09 |
Accounts receivable |
0A |
SEPA transfer |
0B |
Other Bank transfer |
0C |
Transfer to Cashbook / Vault / Owner / Employee + Amount contributes to cashbox/vault, - Amount lowers the amount. |
0D |
Internal / Material consumption |
0E |
Grant |
0F |
Ticket Restaurant / (Sodexo, Edenred, etc.) |
Get Support
If you would like to integrate with Viva, or if you have any queries about our products and solutions, please see our Contact & Support page to see how we can help!