Custom Tags

Last updated: August 1, 2026  |  Guide version: 1.0.8

Custom tags are optional key/value pairs sent to the payment app in the customMessage field of a request (see Payment). In Java, add them with setCustomMessage on the App2AppRequest.

Available tags

Tag Key(s) Type
Blik Code blikCode String
Custom Tax IVA_Amount, IAC_Amount String
Auto Receipt includeReceipt, receiptToSms, receiptToMail, receiptTo String
Tip tipAmount String

Examples

Blik Code

Map<String, String> customMessage = new HashMap<>();
customMessage.put("blikCode", "777000");
app2AppRequest.setCustomMessage(customMessage);

Custom Tax

Map<String, String> customMessage = new HashMap<>();
customMessage.put("IVA_Amount", "2000");
customMessage.put("IAC_Amount", "1000");
app2AppRequest.setCustomMessage(customMessage);

Auto Receipt

Map<String, String> customMessage = new HashMap<>();
customMessage.put("includeReceipt", "true");
customMessage.put("receiptToSms", "+905535612303");
customMessage.put("receiptToMail", "test@yazara.com");
customMessage.put("receiptTo", "salesApp");
app2AppRequest.setCustomMessage(customMessage);

Tip

Map<String, String> customMessage = new HashMap<>();
customMessage.put("tipAmount", "3000");
app2AppRequest.setCustomMessage(customMessage);

Full request and response example

Request

{"registerParameters":
  {"terminalId":"S6729071",
  "merchantId":"S211201150001",
  "activationCode":"123456"},
"configParameters":
  {"drawerMenu":"true",
  "salesButton":"true",
  "voidButton":"true",
  "refundButton":"true",
  "historyButton":"true",
  "settingsButton":"true",
  "settlementButton":"false",
  "tipScreen":"false",
  "infoQuery":"true",
  "userPhoto":"true",
  "workingMode":"0",
  "timeOut":-1,
  "orientation":0,
  "receiptButtonsPermission":-1},
"orderId":"179025611186",
"amount":"1400",
"transactionType":"200",
"customMessage":"{\"IAC_Amount\":\"10.00\",
\"tipAmount\":\"3000\",
\"orderId\":\"179025611186\",
\"IVA_Amount\":\"2000\"}"}

Response

{"appVersion":"2.0.59",
"amount":"1400",
"maskedPan":"**** **** **** 2809",
"transactionStatus":"success",
"cardType":"3",
"refusalCode":"00",
"tsi":"0000",
"transactionDate":"24-09-2026 16:22:46",
"transactionId":"626702113215",
"transactionType":"200",
"tvr":"0000000000",
"applicationLabel":"Visa Credit",
"issuerIdentificationNumber":"474835",
"customMessage":"{\"isoStan\":\"002474\"}",
"applicationId":"A0000000031010"}

See also