Introduction

Version

To see the current version and details of recent changes, please see the Changelog.

Overview

Audience: This document is for POS device developers who creates the integration between the POS device and ISAAC POS HOST.

A point of sale (POS) is a place where a customer executes the payment for goods or services and where sales taxes may become payable.

This documentation covers ISAAC POS device communication with the ISAAC POS Host application. You can find communication descriptions between the ISAAC POS device and the ISAC POS Host during:

  • Business operations including retail operations (sale, refund, reversal, Preauthorization, Preauthorization increment, Preauthorization completion, installment and cash back procedures) and bank operations (Balance, cash advance, Cash deposit, A2C, C2A and C2C payments, fee calculation, PIN setup, PIN change and statement procedures).
  • Non financial check operations (Authorization check, BIN check and eligibility check).
  • Non financial config operations (Device config, terminal config).

All API request examples provided in this document are for illustrative purposes only and request specification for each method must be followed.

Interaction

API interaction consists of the actions - HTTP(s) request initiated by POS application.

This API provides numerous actions for retrieving and manipulating data entities.

Workflow for actions is:

  1. HTTP(s) request (using Request format) must be made to the endpoint.

  2. Response (in Response format) will be returned, indicating success/failure, and providing details.

In order to perform any action, you must use correct:

  • URL.

  • Request format.

  • Response format.

Endpoint

The endpoint format is the URL address. The URL can be different for each action. It is defined in the description of each action.

Request

Request format can be different for each action. It is defined in the description of each action.

Response

Response can be one of 2 types:

  • Success response.

  • Error response.

Success

Successful response in all actions will be the same. The POS device will receive the response with the encrypted data (the response to auth_check request is not encrypted and will be provided in the ‘Authorization check’ section). Encrypted response format is:

Parameter M Type Max Length Description
status M LIST - Listed status of the response.
code M N 3 The code of the response. Possible response codes.
message M AN - The description of the response code.
transaction_id O ANS 999 Transaction identification number.
terminal_id M ANS 16 The unique identifier of the terminal. Will not be included in the response to ‘auth_check’, requests.
data C ANS 999 Encrypted data using AES (Advanced Encryption Standard). The parameter will not be included in the response to ‘auth_check’ request.
sign C ANS 999 RSA encrypted key used for secure data transmission. The parameter will not be included in the response to ‘auth_check’ request.
{
    "status": {
        "code": "001",
        "message": "Approved, no balances available"
    },
    "transaction_id": "00000011",
    "terminal_id": "TRMNL1",
    "data": "l34SO8ZtbVS4YV4GRJfPNyFrf6Z80HmcOUTRwoTDxTK5yy8bzqEpJljHRt0\/MrNzUxjvrchJLSIVL\/rv8m1BgqC6GCG13e4JsTp2rCZuuQDvqDIl\/+wh5J8vkillzjYOD65sC36h\/Fa9nI9GJ0CR3\/JZf73dSfTOT9Q9Uf1vZwdnVTAQ9wyCaI\/mUB+sDCh3eZ+ad4bqWEPFz0UQztw6Lhu2cfcrdFtSfc6O\/9uQBfM\/2MxwxxChuNTyZQCp1UAgM72K+kXbZqsC\/6II",
    "sign": "xmoyLNUQwgZS9Y8a5QYH+FiH86I5+SijMnSE2CoKtWSYgEjagTY4W6+3Iv\/eVEYlggMy6oLzcFYby174uNjsUKMtC1CqyV+QPRDF+KKoItazNoI6ow4tEVGk\/5BgQnGiGAP3fcJkTKu23TeiGF4xP4WD\/a5SIh5iOINOulqzf0W0p3RMUzdlBnUch1ztQxN3hXIY1qNh8Tu1SZt8odIRiIgvCmXvuAkknUdYr4fOzyQC0O7GbzOJOzdUiWi6ifvk2hrlz\/6yJhZNmpETC6bJ2mYYubKgWqFYRVqG2IMC4+R\/CfWIUFTL7GTl74Z\/RhBMFXUWZxXvCs9QYogEHjek55YGvvnZfeAtBxW7bgnUKVRSH43JZWXjNOteikDHuFYTk1zsME\/njhSmOca6iKNNSyKydsq2HBqzc8l7oW32bQ07p5o17+0iDcQ53UvrY4l2R0Ylunsp5sHSx4VptGPNBoW9HFvdGVf5wjbf82+u0NvDAQVuuQcb0svGb2McExsU"
}

Decrypted ‘data’ information (parameters and examples) will be provided under each action.

Error

Error response is the same for all the actions, and the format is:

Parameter Requirement Type Max Length Description
status M LIST - Listed status of the response.
code M N 3 The code of the response. Possible response codes.
message M AN - The description of the response code.
acquirer_error_code M N 3 The code of the error from the acquirer. The parameter will appear only in the error response.
terminal_id M ANS 16 The unique identifier of the terminal. Will not be included in the response to ‘auth_check’, ‘terminal_config’ and ‘device_config’ requests.
data C ANS 999 Encrypted data using AES (Advanced Encryption Standard). The parameter will not be included in the response to ‘auth_check’ request.
sign C ANS 999 RSA encrypted key used for secure data transmission. The parameter will not be included in the response to ‘auth_check’ request.
{
    "status": {
        "code": "H11",
        "message": "Duplicate transaction received",
        "acquirer_error_code": "078"
    },
    "terminal_id": "TRMNL1",
    "data": "l34SO8ZtbVS4YV4GRJfPNyFrf6Z80HmcOUTRwoTDxTK5yy8bzqEpJljHRt0\/MrNzUxjvrchJLSIVL\/rv8m1BgqC6GCG13e4JsTp2rCZuuQDvqDIl\/+wh5J8vkillzjYOD65sC36h\/Fa9nI9GJ0CR3\/JZf73dSfTOT9Q9Uf1vZwdnVTAQ9wyCaI\/mUB+sDCh3eZ+ad4bqWEPFz0UQztw6Lhu2cfcrdFtSfc6O\/9uQBfM\/2MxwxxChuNTyZQCp1UAgM72K+kXbZqsC\/6II",
    "sign": "xmoyLNUQwgZS9Y8a5QYH+FiH86I5+SijMnSE2CoKtWSYgEjagTY4W6+3Iv\/eVEYlggMy6oLzcFYby174uNjsUKMtC1CqyV+QPRDF+KKoItazNoI6ow4tEVGk\/5BgQnGiGAP3fcJkTKu23TeiGF4xP4WD\/a5SIh5iOINOulqzf0W0p3RMUzdlBnUch1ztQxN3hXIY1qNh8Tu1SZt8odIRiIgvCmXvuAkknUdYr4fOzyQC0O7GbzOJOzdUiWi6ifvk2hrlz\/6yJhZNmpETC6bJ2mYYubKgWqFYRVqG2IMC4+R\/CfWIUFTL7GTl74Z\/RhBMFXUWZxXvCs9QYogEHjek55YGvvnZfeAtBxW7bgnUKVRSH43JZWXjNOteikDHuFYTk1zsME\/njhSmOca6iKNNSyKydsq2HBqzc8l7oW32bQ07p5o17+0iDcQ53UvrY4l2R0Ylunsp5sHSx4VptGPNBoW9HFvdGVf5wjbf82+u0NvDAQVuuQcb0svGb2McExsU"
}

Business Operations

Balance

The operation of the balance inquiry. Returns the information about available balance on the cardholder’s account.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message the value in this parameter will be ‘300000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from original transaction.
18 M N 4 Merchant category code (MCC). For this message the value in this parameter will be ‘6538’, for JCB ‘6010’.
22 M AN 12 Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 100.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
54 M AN 120 Additional amounts.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1100’.
method M AS 19 POS host method. For this message the value in this parameter will be ‘transaction_balance’.
request_type M AS 15 The type of the POS operation. For this message the value in this parameter will be ‘balance_inquiry’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.7-dev",
    "data": "igdojodkjedeekndizqn48Hhp0xFpVRl3T9jqOw5uXxlfM89LYQbFuO96lfZG+rr+OW1o8KCgTBhQPfPssyZg/25WmbgoT0JCKS4Sh289V2AESgLmDZZOH+ZA+2bilCUZzU1pRMR3gggkzmTqnoilUulJy1FV+l9Bfj4KdBCae7q1i85zxPAWHjwEquOhLBzcR/HQROM9vb8hDMsV8UZOnKOiaIR9vr29U7w7D2vvBrj+yJ1AOgk4IGafdxTG//FzBNMkouj2EtxEVu0WYLCMOFkCG2HFqVZet5ePdzD+N6hGe3g3KxhBKsu1BJcOrf45oUr7ZBQe6kPhayS48B5Ucrwup9rDvOYdRkmYpIS3qlH09kwB4C3pnNUxC2WHISh68vda8S17OuawFl8kd5v9yvyp3xMPT1EkGNoBjIUbbTKAINwL0dCvWI++YqOsO58IMh6qY7jqrKsR02Ct1BumCxFtUHm4OVL1nvvWerjT1fnWUmKsgGH8RukZ657h8iTIeBC1NhfRRJUZHAm3/op3AjCbV2gQkeucK0gvQ==",
    "guid": "basewin_0000150410PI0000114",
    "initial_guid": "c4789f77-82a8-44cb-92d8-01658647426d",
    "pure_json": {
        "2": "5400000000000001",
        "3": "300000",
        "4": "000000000000",
        "7": "20210111075337",
        "12": "20210111075337",
        "14": "1225",
        "18": "6010",
        "22": "M12345678901",
        "24": "100",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "52": "11AA11C000CC0000",
        "53": "9701100001000000",
        "54": "0000978D000000000000",
        "127": "826",
        "MTI": "1100"
    },
    "method": "balance_inquiry",
    "request_type": "transaction_balance",
    "serial_number": "0000150410PI0000114",
    "sign": "HJDe1I/jgg4UyyJqrPhlY1dvmoYdNH/8Wqkf7P+d2Ok6e0wI95pZtO+Tvb7Epnb047kqOgXNZ53flssmfEzkMUmRW1wO75A/H1QXr4J8hYYCFR5GTtHbyuuVlJY64sXM6twIMbOXzt1VDp18VweSr4bighpvCOrQqT1KUhNm4Wrg8Bvp4BKfYct8vP6+WHaE/XRXY7GhjiWmNOBrjNHw8KPt2zu6Cer/rgj4DeWUXs5Mc6Cw5HokMnheDHTx3UY5G4+YvVgUeGyB8syoXAwrdhAZKGw7wJDW4qDPR/FrjO0VuQXSW5/eAhKFzZlZqJlbfu6ISmDDeSFheNQ/5qwEtEfMiXZ0OMCIaEt4VzzSSS+OjxV8v9xQsgWOXceh1xUmbVOpTkU3MvtYFBSMrqfZItMBeW2rhKzsyOToR+WUCRurN5Ks8NX5jJWvT/iCkLdsJtejkDS4ev41O7lBCK3xhaQff//a4tQiJ9ulR/EesgeQ44y+2nYJ3CIWwPkuG8HR",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
95 M ANS 32 Parent transaction ID.
127 M A 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "300000",
    "4": "000000000000",
    "7": "20210111075502",
    "11": "000121",
    "37": "101004000025",
    "38": "008817",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "95": "000002700002000121210111075502",
    "127": "826",
    "MTI": "110"
}

Cash

Advance

Financial bank operation. Cash advance operation can be used when the cardholder wants to take some amount of money from the bank, using his/her card.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message the value in this parameter will be ‘170000’ for UPI ‘010000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from original transaction.
18 M N 4 Merchant category code (MCC). For this message the value in this parameter will be ‘6010’.
22 M AN 12 Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 100.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
64 C AN 64 Message authentication code (MAC). The parameter should only be included in the MACing transactions.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1100’.
method M AS 17 POS host method. For this message the value in this parameter will be ‘cash_disbursement’.
request_type M AS 24 The type of the POS operation. For this message the value in this parameter will be ‘transaction_cash_advance’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Datetime variable. The parameter will not be included in the MAC transaction.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.7-dev",
    "data": "fhfmlglboppdojjlZZ8e7Qu+fOCJ0TgnBgmFqYj6vvsNZsEk2KDBTQCityWG9GtzEB4rBg5Gb+77miU0wR2UCraBHv4ZZzLr9p19dWopDADncAIIfLB/nY6a6s5j8SFxIMNxVhcJcDfV/ElhnH0oEPf5tMVoDyQq+VK5omYsiedKBa1h6SzpBzPS4G1iVMbnwhfqA6v1zRs4imwHGAqr8uz+S9Jk13pkkDEvl9jlmLAmy+3eF3jD/Ol9Jl2sx0D7pCCnMIFAimCx0nb71YitpHpcY2GU19BPRP4yjYshw41LxqJbc2uqehM+nbWYzvCP5bW4i7LD0lETfhvbZ8A5HOcH6LNBMPk2Nf4zb3DIdEsND7n+fHfSVMPSJVWPcvH9s9sJx8x4kSm194tIyxfDdq5P4somYaYVWeCifeHdCbMoQlIItjpR3eBlYgQCAEO/mgz7ODKdGFCb5+qBUdXesvOdxiprBK79hDTy0IHvFABEhC2aIbcRb30PgAk=",
    "guid": "basewin_0000150410PI0000114",
    "initial_guid": "c4789f77-82a8-44cb-92d8-01658647426d",
    "pure_json": {
        "2": "5400000000000001",
        "3": "170000",
        "4": "000000000002",
        "7": "20210111082447",
        "12": "20210111075337",
        "14": "1225",
        "18": "6010",
        "22": "M12345678901",
        "24": "100",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "52": "11AA11C000CC0000",
        "53": "9701100001000000",
        "127": "826",
        "MTI": "1100"
    },
    "method": "cash_disbursement",
    "request_type": "transaction_cash_advance",
    "serial_number": "0000150410PI0000114",
    "sign": "lF8rheE4Pf6UA+c3aIH4dnzQDuO8Fo56A2ODMJqj8HdfFSgS5p4CXWAqaALMm0ogYJTvNWEmHDAIHLg7CuLGcS3eSVX5i6XbYnQPxeWNbssHDzzqpbrrSi2JIWlgM14hGtBad0uTtzuy/C10bAS/ZHM7sY8NEQCxh6e3Zd6FPFqBhl4Ht5YuRdt/4chK/4KEtALKth1/JqXI7vrRpY0GL6JFAsdiEYXQraxzSocQxDUzoyi8Px+fyxcG4kHZiVGtQ8fzWTLvcxYRuh2VlP3T8bYP8QdLyK+9No2mifpQ+H7wCCHDjqGBnKoy47JodV6JnfSmZfPIJU73NBEyrUH4q4Dx8qeIvUMkt4P5Q/Kt2UcYJgHMN7VB3U91t1bwRx4xSZ+VqHslMP6H6ndsyx5RrEqMMMwQ6esgW/lNPnGu7U3sKGg5w0SVp/zhBSbbcSk6tZtSWRZFx0rQFIVP5xWZ7QmvUcy4L3oz4KpS2gEdtEv5sngRC/laLugD106sauBg",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5460550223332202",
    "3": "170000",
    "4": "000000000002",
    "7": "20210111082504",
    "11": "000132",
    "37": "101004000047",
    "38": "008821",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "95": "000002700002000132210111082504",
    "127": "826",
    "MTI": "110"
}

Back

Retail operation. It is a part of the purchase procedure which allows the cardholder to cash out money during the purchase procedure.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type MAx Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message the value in this parameter will be ‘090000’ for mastercard and for UPI, ‘000000’ for VISA and for JCB.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from original transaction.
18 M N 4 Merchant category code (MCC). For this message the value in this parameter will be ‘5311’.
22 M AN 12 Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 100.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
54 M AN 120 Additional amounts.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘’1100’.
method M A 9 POS host method. For this message the value in this parameter will be ‘authorize’.
request_type M AS 20 The type of the POS operation. For this message the value in this parameter will be ‘transaction_cash_back’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.7-dev",
    "data": "inmcfbgjagclkclbfVqikxvNTV591u25LKq4Jftk0zNAAJ07ypKbZIJnKvJdYl9XGrjPvW8t2jSbVLquqITwlKP/Y/JfXGdz8wy9tEYyDKnEhJ3nqTTiqhfZO7uD6SVe3liyqk5/xgaGM1b+hEcv+fwD4RvwEptwOU70KIVYFUVLfpgfGFXCCnzy0V0HoJxw3EWWXHgoXLLqPloSQVIroZq2bSJFy6xq3eFL/+mc3OvsAtBg+4nP+sGN71m7yQTEfbph1rKm8Qe6WqgfnnxCVePciXZwn9bfapA+fw9ePYRtUpCi8xWZsnWuiGMyxmwLbIJfzcyatw+G6kztbF/Tfp737Pry27GT/yU433oDpT4rKeYBGGHB6AouIDb3garj0e/Ig8I6hKmCig4Wf+fO6iXIo3g4Zpv2DBoYHVhtdKfbLg6iMfFQI7xlp3+ou2G+Qt3X1RAoxFbAkoiu8fFwemdQs0PsaTzDGhPsW5EdhuXiZod3dueEryp8gPsQvRkTJ7vp3aj5RS3YF5X0Q3twjfGetKoTjpmgSBBZzg==",
    "guid": "basewin_0000150410PI0000114",
    "initial_guid": "c4789f77-82a8-44cb-92d8-01658647426d",
    "pure_json": {
        "2": "5400000000000001",
        "3": "090000",
        "4": "000000000006",
        "7": "20210111082702",
        "12": "20210111082702",
        "14": "1225",
        "18": "5311",
        "22": "M12345678901",
        "24": "100",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "52": "11AA11C000CC0000",
        "53": "9701100001000000",
        "54": "0040978D000000000003",
        "127": "826",
        "MTI": "1100"
    },
    "method": "authorize",
    "request_type": "transaction_cash_back",
    "serial_number": "0000150410PI0000114",
    "sign": "SVFiKZkfcykzNbWNHW5odovwx0A6ke6bp42S/ZjvmLtqvObAwYMHd3TE/cUJqIzzklDXUTvribFjnFykaebZDXiIdiIVUvm33kLaDTg8dtov/djFkIl6Qjatn5qRjUlIzm5WcrS7ZKTOxIl2xLd/nzbmiUOrNWDZ5NM7+2QVUefAyItn1oWB9V+sYSHYW7eW5HtF+bs5zeCKNT1QX14RZ5YokiGIArBytnex8ymOgtkirW+V+OF7/rInojd/cUFjUrAn3VraWxDRIgfu/QR5GGf9nyIsX413bhnZyBxN5LIJ92x/i1FesjN4llPnYyDA9dQ8fwjHmcWbbA6p+gowL7V9VgD6iFfopK+C1nkedxtvs0QCEIAYVtGG1377gTiZKKNVTNJu7UsY5snXTPjSTqa+6SUZ53cCrmb8N0izCmd7l+1ANMs+BFAGr6o1Yul7oXDlQoeU6Q7BaqMGk7lffZFjG7bgoGyd653i813FQNaZra5HKY7X0YE1Wv2Y2uRU",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 STAN data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "090000",
    "4": "000000000006",
    "7": "20210111082732",
    "11": "000135",
    "37": "101004000053",
    "38": "00882C",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "95": "000002700002000135210111082732",
    "127": "826",
    "MTI": "110"
}

Deposit

Bank operation. The operation allows the cardholder to fill his/her banking account by cash. Note, that POS terminal and card should be from the same bank.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message the value in this parameter will be ‘210000’ for UPI and Mastercard, and ‘200000’ for VISA, and ‘000000’ for JCB.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from original transaction.
18 M N 4 Merchant category code (MCC). For this message the value in this parameter will be ‘6010’.
22 M AN 12 Point of service (POS) entry mode. You can find the description of the parameter here.
24 M N 3 Function code. For this message the value in this parameter will be 200.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 2000.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
64 C AN 64 Message authentication code (MAC). The parameter should only be included in the MACing transactions.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘2000’.
method M A 7 POS host method. For this message the value in this parameter will be ‘deposit’.
request_type M AS 24 The type of the POS operation. For this message the value in this parameter will be ‘transaction_cash_deposit’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Datetime variable. The parameter will not be included in the MAC transaction.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "SMB0000",
    "app_version": "1.1.1-dev",
    "data": "jjfhkglankponhggqEm9LdE+kfz7pCpMO9ripo0bKWvg3NX9rFfv17zvOfA4g9lqtClk\/F8aAiyQbkxsG\/sSP5day3CejX4MQVMKFfZisz3QLo+F4Bl5Wbroh+Kr6vr91z5Tc\/11\/4Ja6yzfp0FdIVLGh1o9L5qg\/o6C4bxXz2\/nYhe++2l7RiCLwH83vA8B3Pwh7xUgUJTBA0EoQG1To0o7ALebnu4K4XUYwe5YhbBraCp8rvEnrp8OlQHRoYmu61T06nMhKjJaXp3\/ZSz9ftOJmtbX7bS\/53Gi1J1rPpMAn91vNzxVzN0BPSoeU4SUxRSrt3rObHMt41xnzTp\/hQpys8XedwNzs3ywmEh83uWAADp\/ayc+uhYew8f5lR8kmeUCHAGjpmaWa\/l3TjwodFTKRtXFLdLdnweNv4O3Gc449Q0WU8wZOtIOPNN\/7NAINcCdf8e9iKQXYJG0",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "2": "5400000000000001",
        "3": "210000",
        "4": "000000004170",
        "7": "20201124235057",
        "12": "20201124235057",
        "14": "1220",
        "18": "6010",
        "22": "M12345678901",
        "24": "200",
        "25": "2000",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "980",
        "127": "804",
        "MTI": "2000"
    },
    "method": "deposit",
    "request_type": "transaction_cash_deposit",
    "serial_number": "00001504100A0042258",
    "sign": "VsUOst\/V7ebDm7BWGxfD3ZGTKXM+BhBm8Al7Krvg9iUmEuVkmjlvJcJdPMSzfYYbnU5ZrykexRcGW9HMoTMtK9MFShQe1sOcvrTMeL9mO\/uKYL+fZMVUBstgTp+PgyhegsfwhpEzFBRsMGq0gLXxLbwjR4olFgMAvLbWUcy0ogLpY2PC+hU9cMnDH0ueJzDwRzfjs\/2hc3YvbOahuSQjO5N437bhQ6ekgfntnDJlb64sBSMy3a+E5V18GaMmTwwqDoMr1RQYMdTiGy1xURgwt7fMvSAL9dUWmJGnFxhC6PT28nh4e3kNm5TSs13h3\/ZS8h3ISJNzQtyqp1u0yjRIFTRG7NeLVhiEZPcfcdjhrTZYW5Vk+LJcXq+iiUYXP2M5PltzLO2Jya8FE2cV6QNmRf173hDsVbSokKbrC6OfjkEosBb+z75IYzqHF76oAFFwI878AErVkKPkdNOY4tcaeuIPCQJz523FqZWk7q3hbb4s8PvqAyadRegKBEskU7co",
    "terminal_id": "TRMNL1",
    "token": "UH6Zy4MjPl0h9g2TvAXGCGSS31RNTu8AtqNe3ueb97y+n\/LyBJjQKbvXr8LCw8vV"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Currency code, transaction.
64 M AN 64 Message authentication code (MAC).
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "010000",
    "4": "000000004100",
    "7": "20201124233557",
    "11": "000242",
    "12": "20201124231155",
    "37": "032804000242",
    "38": "623316",
    "39": "000",
    "41": "AAAAA",
    "49": "980",
    "64": "EE123456A123456",
    "MTI": "0210"
}

Fee calculation

Operation is applicable only as of the part of C2C payment operation. This operation can be used for the calculation of the fee for the money order. Operation is available not for all processing. Available for Compass + (TranzAxis/ TranzWare POS Terminal Protocol (TPTP)).

⚠ Important! If the Fee calculation operation is turned on for the device and the ‘transaction_payment_c2c’.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from original transaction.
18 M N 4 Merchant category code (MCC). For this message the value in this parameter will be ‘6538’, for JCB ‘5399’.
22 M AN 12 Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 200.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
64 C AN 64 Message authentication code (MAC). The parameter should only be included in the MACing transactions.
103 M OBJ - The information about the card to which the transactions will be directed.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘2000’.
pan M N 19 Primary account number.
exp_date M N 4 The expiration date of the card.
method M A 9 POS host method. For this message the value in this parameter will be ‘p2p’.
request_type M AS 16 The type of the POS operation. For this message the value in this parameter will be ‘transaction_payment_c2c’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "9100020015",
    "app_version": "1.2.0-kb",
    "data": "cldiikfdebbhceca81z1ZEXQmvT7ylTU3I2KQ2KGDDEg44MnLW2GRLOhU\/NYLqMPAj4mO8WsLjaixHBnsHM2YJHOih0axaE70YnHWsFSkD9XjQMT8K6FrEKOmo53FuEzan3lhMOEMXq7zLlEhL0dzNXh79zmuXHQqb2va1dtd9UtmIeonvTSozimhk\/wPbAI6Sq72ajKvGDg0uTzf4QjI35gCr1Fj6EkQZh+x86A4BdKqcG9EBI\/9IZ9pK9UHYjF7PhUCCzeTwYyIgMsPAOMyk9lpBYf6A6XssHZzNGTpYBDboNqlSYlVPMuUte9iL9XRDhDOE9Y80PgcjCDy7Vgq\/yWBAuzpubB0DXCyL20DIT3u6QMY7l5q+hwyZw7GK+ehjJUEoPCYcJ6sY18qrCSru+bkKGWvlhGGaUhh\/n4vLqZ4UmQiFPz6vIZ8FuApI+f5w7al+jypibwOBOEy8rjlI+Ox+U8vvNbSm3\/kd\/pmG+w7Mg3RZfZTxsLcn3XzhADrYMvTMxKcbSQX1R7JlBDabCGOaNWkODsj3VNXrGtagm8IWUIKi49YJ+EmvHbxXtp3LoKsAzU7tRI8g+1Zft4GcaePfNKxukLFuwBHg==",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "2": "5400000000000001",
        "3": "000000",
        "4": "000000001000",
        "7": "20210127115024",
        "12": "20210127115024",
        "14": "1223",
        "18": "6538",
        "22": "M12345678901",
        "24": "200",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "37": "102604000072",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "810",
        "52": "11AA11C000CC0000",
        "53": "2001010100000000",
        "64": "EE123456A123456",
        "103": {
            "exp_date": "1223",
            "pan": "5555550000000000"
        },
        "127": "031",
        "MTI": "2000"
    },
    "method": "p2p",
    "request_type": "transaction_payment_c2c",
    "serial_number": "00001504100A0042258",
    "sign": "cZPzZCU1kVnMoWWJ+qlkJsflrXsG3bLN52LibQX\/wbeAgniwFwiTQfXUdoMvXIP+VyplQgGlm7FE6fzERS1JBGBk\/0F7PZ5YbmpZQOn60LWsvim11r9DkGXv+XzQmF\/qxxwj7nWY1cGlAhsQR3zjy0T6DCDXupgqaujKDWa8pH+3mpS1wHe03\/8CCCPSSH3cQBtPry5oy6tmf3yWSSdBmStOM4V9I1+vytQy4T68XuECQESJKlGpcZhmIJijNKvn5YEQupS+Lhrt7TAPXj2QXBhaL4fEzBaLWYJdlKXcInOj7gQWc6\/NIZiTVravb1NdDP8ml7G\/u6rCvqfUmZrZgS2cbknnsOD6iKfjwBY+If85Nx6NNBhTagmzypOT6aFujALnl8JHj2lOEErXIv+Erp59XTsX5Da4Nh9xnvHRhEbupgH0FAgPHh0JDBYrEia2ZYyuYuMpp2FdqT5mH1JXOmfzoQSauTVZwhvbfYB28c+szzfggMJfUxWiLhvek+n1",
    "terminal_id": "TRMNL1",
    "token": "0SS6j4P0NSKY2u4MoFU+Eqv+TIKohcfQu1abgMDWsHXbpU7VH8V9qq4KwzHdf8St"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
status M LIST - Listed status of the response.
code M N 3 The code of the response. Possible response codes.
message M AN - The description of the response code.
terminal_id M ANS 16 The unique identifier of the terminal.
{
    "status": {
        "code": "CALC_FEE",
        "message": "000000000100"
    },
    "terminal_id": "TRMNL1",
    "data": "l34SO8ZtbVS4YV4GRJfPNyFrf6Z80HmcOUTRwoTDxTK5yy8bzqEpJljHRt0\/MrNzUxjvrchJLSIVL\/rv8m1BgqC6GCG13e4JsTp2rCZuuQDvqDIl\/+wh5J8vkillzjYOD65sC36h\/Fa9nI9GJ0CR3\/JZf73dSfTOT9Q9Uf1vZwdnVTAQ9wyCaI\/mUB+sDCh3eZ+ad4bqWEPFz0UQztw6Lhu2cfcrdFtSfc6O\/9uQBfM\/2MxwxxChuNTyZQCp1UAgM72K+kXbZqsC\/6II",
    "sign": "xmoyLNUQwgZS9Y8a5QYH+FiH86I5+SijMnSE2CoKtWSYgEjagTY4W6+3Iv\/eVEYlggMy6oLzcFYby174uNjsUKMtC1CqyV+QPRDF+KKoItazNoI6ow4tEVGk\/5BgQnGiGAP3fcJkTKu23TeiGF4xP4WD\/a5SIh5iOINOulqzf0W0p3RMUzdlBnUch1ztQxN3hXIY1qNh8Tu1SZt8odIRiIgvCmXvuAkknUdYr4fOzyQC0O7GbzOJOzdUiWi6ifvk2hrlz\/6yJhZNmpETC6bJ2mYYubKgWqFYRVqG2IMC4+R\/CfWIUFTL7GTl74Z\/RhBMFXUWZxXvCs9QYogEHjek55YGvvnZfeAtBxW7bgnUKVRSH43JZWXjNOteikDHuFYTk1zsME\/njhSmOca6iKNNSyKydsq2HBqzc8l7oW32bQ07p5o17+0iDcQ53UvrY4l2R0Ylunsp5sHSx4VptGPNBoW9HFvdGVf5wjbf82+u0NvDAQVuuQcb0svGb2McExsU"
}

Instalment

The operation of sale with the conclusion of the instalment agreement. This transaction creates the instalment cycle on Issuer or Acquirer side what will be provided and calculated on the payment account level, without card parameters participation.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from original transaction.
18 M N 4 Merchant category code (MCC). Received from terminal config.
22 M AN 12 Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 400 if the reversals full and '100` if partial.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1820.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
64 C AN 64 Message authentication code (MAC). The parameter should only be included in the MACing transactions.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1100’.
method M A 9 POS host method.For this message the value in this parameter will be ‘authorize’.
request_type M AS 23 The type of the POS operation. For this message the value in this parameter will be ‘transaction_installment’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version M N 20 Terminal Config Version in Datetime variable. The parameter will not be included in the MAC transaction.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.7-dev",
    "data": "ghejhedjebokoajjRzOMWoTyK63afFZgbnmUmUgvhbrZKz/4FZbGgTZXwVPPD4fCNSh9DQugQziEQsTeEaXQPmzCe0nelwriJ6+NJmgbeOQw3YE8Z5YXa+ALkXNbyObf7LP0MjKSyhWB1xzwmkqogYecKKW6BqpW35uDwUCeNxQOXW8H0auGhBUF+0pDyCzQFwvq4Z9J8ren9GYnQ1ztdfUh5s+sg3UV1fDX8n3LXtvjFgmKjea3P++5513AcIyNJg5bRSRxqyxxeqbIsjJsFKemXc/gKvO8FJ8rwerFJWpbF1ML9jqVJCCw7EofWqk9zICGSWWT7J04s2eq+9oAy4HIoegScXGmClHUIFPUY4Tj5SvyVIuXF76qNb3IPo8N1tSQbajsMu/H5gO7kkrlxO5YLPj9u544W99UhUahEoj+gmHDL3C+HaYJZhDQkihbw1sPj1yaeHKPGN3DyNoPDdrkDe2N/+C4vjsxkaViyu0iO4GUS7JXhUBhVJM=",
    "guid": "basewin_0000150410PI0000114",
    "initial_guid": "c4789f77-82a8-44cb-92d8-01658647426d",
    "pure_json": {
        "2": "5400000000000001",
        "3": "000000",
        "4": "000000000003",
        "7": "20210111082955",
        "12": "20210111082955",
        "14": "1225",
        "18": "3412",
        "22": "M12345678901",
        "24": "100",
        "25": "1820",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "52": "11AA11C000CC0000",
        "53": "9701100001000000",
        "127": "826",
        "MTI": "1100"
    },
    "method": "authorize",
    "request_type": "transaction_installment",
    "serial_number": "0000150410PI0000114",
    "sign": "pfOMxVWtj+CO0EuZAIGVtRFt3Q2jmtu2/mx7U4O9CNbYvM67AItq+DeVZL38NsodHlXJjDWhOfX5sI+k2E8PnHHzKAZG8pR7jKgsVZ+WHxHoBAiUMU1jJIxDQo6y/nC4M1CIvc9Lt2Q+2rDNEDLNzn669MEQSafhkFzV3XOz80pw71/rvkUmpYO4ODmLraraWmnHQZretbSq5t8x3h1bkzNg6wQjxkyLRK9ksO3sZ6m6LG9CCMiiRSews1+CCTFZmc4gcc1y0bUPcy5FFHrHO2k7Bsu0IRVrp0DPgzTBcd7qTfpHpxStC8fsW2FqwMWpCquliZ6ftjLIErrSJDEzwpCG1UTUkHggPIdV47pvHijq/fEcshBN3Ztd/UWBosPBvI1DQy1AdpQgveUGWoI89q4GCkeZG+GqZHkgzBPQSw3CMgiKh7vkhO1b967rfcSr1j+enta/1phJY7sL4IuLCaRfa7PPTBU06kbvHFkP4I6O9aR42u3qkvN+eYIo+3h+",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "000000",
    "4": "000000000003",
    "7": "20210111083018",
    "11": "000139",
    "37": "101004000058",
    "38": "00882C",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "95": "000002700002000139210111083018",
    "127": "826",
    "MTI": "110"
}

Payment

A2C

Account to card transaction. The operation allows the cardholder to fill his/her account using the POS with different bank. Also can be used for the cases when the bank transmits money from some additional payment system to the card of the client. The possible usage of A2C operation is not limited by the mentioned cases.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from original transaction.
18 M N 4 Merchant category code (MCC).. For this request the value in this parameter will be’6535’ and ‘5399’ for JCB.
22 M AN 12 Point of service (POS) entry mode. Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this request the value in this parameter will be 200.
25 M N 4 Point of service condition code. For this request the value in this parameter will be 1503.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
104 M ANS 999 Transaction description.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this request the value in this parameter will be ‘1100’.
method M A 6 POS host method. For this message the value in this parameter will be ‘credit’.
request_type M AS 23 The type of the POS operation. For this message the value in this parameter will be ‘transaction_payment_a2c’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version M N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.9-mb",
    "data": "jnggnmhcfcoafpehLhi8q5FSDgqcUlk3+H5nbC\/z0S+RpUpT0v\/\/8bZDLTkUP+nuGxRZmBnZ1lTXKwZH9MrxARctnqmNShQhtQzWWbb2KXqhDA\/cqtL3jr9rAPS3dpZxD6LgtaGK2NEDDAcf9wzjtbr3xYfZWwTYGtH8SdX6NJ2FrlNnkEzcOWSe8uidaMXmz5W3GD9m4q4aw19p+z13KDWyT6s8hbaLrV2t05AqM4LPb0ywwguwSfpad1\/ckkkmz2fNrmf65MSdv2LlX25w6NVInDMaVJV0+vzrdV5FTIxKO1P7R7mSysQBM791UknLtFOOLZgBghDROx4a9W\/Rvbunrfy3FvcUcTk4LeZuDG+3KOQU7LRySs\/ISv1NNxL3D8\/d+IxznS3fP9Rmz9+Aukx9L5LcKKLHfo1gueo9So8OvNY+uSebnd5SVKc=",
    "guid": "basewin_0000150410PI0000118",
    "initial_guid": "29b86cf4-1cac-4730-b579-53c6b2297f13",
    "pure_json": {
        "2": "5400000000000001",
        "3": "000000",
        "4": "000000000323",
        "7": "20201231071050",
        "12": "20201231071050",
        "14": "0321",
        "18": "6536",
        "22": "M12345678901",
        "24": "200",
        "25": "1503",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "104": "C070000000000000000000000000000000000",
        "127": "826",
        "MTI": "1100"
    },
    "method": "credit",
    "request_type": "transaction_payment_a2c",
    "serial_number": "0000150410PI0000118",
    "sign": "ZFBnYHtYsH28V1M2c7roH0BFgOpjNueYd0itAxUF9AOChWhrWnkFpmfTliGdugAV2DfDCBdS\/RdW5p91MwO60k+LB63ZFrEMI8eK258UdSuIWWwnuh2g3dodOk2uRm8PHCJfNySGNfM7O1h2W0mL\/v8RsMKaEDH0j4NXASKx9IfU1xNUSsSTDITj4eQYgANT+xgqdTHmoyIvR6ObwyRGv3b7USIvuYF\/KQSnUlCVyc7aiGU24tTk+zqubd8cQUrRIJOgUj0UtjxRNbLHSWZZ2dO7dtOaM8UCv\/MgexWvJl0LeTfZeNajK24qo6vQLTNLamh4nwQsoLmUXLJ+ZQa8dCRq0nHJMGwVzLK0JpNy09SkAlQ4H7PuKYScjKVu9onaa\/\/LKKAuChUmNQDC3oMIszvW5jepoa0Dc\/YxLXc2X5WpfzoIPYYNjQVmncqrOFPe\/eyr\/qe6yiKKhp7Ci6FDrX03bHMaIK8OjgezwUBEZJ+CG+sABpwqnjik5WwOPDL\/",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
54 M AN 120 Additional amounts.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "100000",
    "4": "000000000600",
    "7": "20210114094037",
    "11": "0010010720",
    "37": "101303000010",
    "39": "001",
    "41": "AAAAA",
    "49": "810",
    "54": "",
    "MTI": ""
}

C2A

Card to account transaction. The operation which can be used, for example, for utilities payments through the special gateway, or for money orders from cards through other payment systems.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from original transaction.
18 M N 4 Merchant category code (MCC). For this message the value in this parameter will be ‘6538’, for JCB ‘5399’.
22 M AN 12 Point of service (POS) entry mode. Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 200.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
104 M ANS 999 Transaction description.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1100’.
method M A 9 POS host method. For this message the value in this parameter will be ‘authorize’ and ‘sale’ for JCB.
request_type M AS 23 The type of the POS operation. For this message the value in this parameter will be ‘transaction_payment_c2a’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version M N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.7-dev",
    "data": "cgeiihenmkliggoefAgX+tNas7Ha9Kh82niS8lVCMIZwHpDu+kScL9IGz7rUqCW2QdawkbMgmI7AP/W3eE3ujiVkx1EdPe9JquJ4/elghXIOwCU+uYaT3nCpuUGj112kcpFV6OAbUb5adVvrDUoqFLkQPBBnw3rbhBhfZr/3EV8aDwFuvJjfyr8bodIKHcz6FVhWGlPBWW44bJcTopVbZkW93YWOOE6Y/dZVdCwo58uMz8P5HFgO9M2bFrAAfzKJYnGu/WoPWhM9eJlQDJ82BMv+BbFmt1rGY2y0p/O2DNTt0Es3PXRrngH2xhP23zPHgioWvhLm0TKR1YWiEpQGOGdui9LyDGy0X+CJCsCjWdWrTwOMe+NOHxYoRlqFRI+cqU/2IRSAE0FERiyD30uhGu5j52SQJ8oiKjz7PqbJo89NaAwrfXjUskcWlLVD/XjXcSwY/q7CvsQMuKaRIyk1UELZ8ptA3c81IllLBi1snNy3lp+jMjy9txCOXIqS4557FrU6AYFyjTeFSzE1/Cki1C7ZkouEIT7ja+D5EeH5XbBUq4K5hi2smkD5ykI=",
    "guid": "basewin_0000150410PI0000114",
    "initial_guid": "c4789f77-82a8-44cb-92d8-01658647426d",
    "pure_json": {
        "2": "5460550223332202",
        "3": "000000",
        "4": "000000000002",
        "7": "20210111080326",
        "12": "20210111080326",
        "14": "1225",
        "18": "6538",
        "22": "M12345678901",
        "24": "200",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "52": "11AA11C000CC0000",
        "53": "9701100001000000",
        "104": "C070000000000000000000000000000000000",
        "127": "826",
        "MTI": "1100"
    },
    "method": "authorize",
    "request_type": "transaction_payment_c2a",
    "serial_number": "0000150410PI0000114",
    "sign": "MhhjbzRgrjFusLzspO56rAqABqR7IAmoCvna+Ur3czIN9guaJRLs+VmTRqRDkqynq+QlCFCw7vWcO4nqcH/NkMKx7BUQnqg2MUNuLZ4WuaBro+fU739d1GssHKY4iJYopHHKtfEFWdEIyGH5jhspokKt5OPjzE59oi3b47Q+ywgqEDuzvBJM+5c+Out2Ofdh2bTnyoL8gdP0mndm810hldAuE6K2p5c5f3EUZ8chC7wbv21A0fp3voarQ2TPS6VQ0IEbJ0DTuiCEsKkWY3XtpfBzYBifIFoa4BPpyRI29C+BprP5smmHBetdX850f55mWG45WzvKOBmw3sGhyZZ4GAVa2exBv9qwe9Mq5yPM7h1IzGf+m9FR30eHhnv7k+yeV71VBfr24JdsNtiIj1juknXsA+9waHBFTQVcJuUqVI6TGc3XLDvDK1Y/C76dy38+xk17CMOnVIunDRqmhtNEk63DeFMLr6DndedLUs8Aa9KFJO4KuZnFE/raoRtvM3FX",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "000000",
    "4": "000000000323",
    "7": "20201231071045",
    "11": "000101",
    "37": "036505000009",
    "38": "008717",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "95": "000002700002000101201231071045",
    "127": "826",
    "MTI": "110"
}

C2C

Card to card transaction. Operation of money transfer from one card to another.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from the original transaction.
18 M N 4 Merchant category code (MCC). For this message, the value in this parameter will be ‘6538’, for JCB ‘5399’.
22 M AN 12 Point of service (POS) entry mode. Point of Service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 200.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
46 C AN 999 Additional data. If the Calculation fee operation is turned on the parameter must be included to c2c requests.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
64 C AN 64 Message authentication code (MAC). The parameter should only be included in the MACing transactions.
103 M OBJ - The information about the card to which the transactions will be directed.
pan M N 19 Primary account number.
exp_date M N 4 The expiration date of the card.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘2000’.
method M A 9 POS host method. For this message the value in this parameter will be ‘p2p’.
request_type M AS 16 The type of the POS operation. For this message the value in this parameter will be ‘transaction_payment_c2c’.
serial_number M AN 50 Device Unique Serial Number from POS.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
sign M ANS 999 RSA encrypted key used for secure data transmission.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
{
    "api_id": "9100020015",
    "app_version": "1.2.0-kb",
    "data": "lpoffabbcbgcmpbbXgI5Ri11uwYTKHQAIaHK1XO2pgM\/vEnkqOZG5LVfwej5miCkFb5D9vJV5a\/jVt8WSyM+LjcFyyf65iCo3OWh0DP76zyWevhIkBsCawZ+cG2Rrdz4agPhhX9ZJEUZsar0V9JyrxdLBVzlE8f05rwoBpVv3VSMM9izA6OEpLUdwWMZJj\/0+OsQu3oKqpxtOut9Mq2ljz7qJsbFxI3b5H6ZCz5nzkuCYglmriHPrpgSjqNtIvT4xBZlHEfUo18kCkqo9ZUeh8emhNe9Z++rhnCc9ak7YOh1\/bEr4eQvY19zTBSe7BttsSvSJL1mDp5Z24NrPbEUjh46wp1RhOiA26bOS8v330cRjhh6o+GJ6r9NR17CASnzma6zrgfCxFHTgCrGd6pUodDz1Y8fOtqTT1hoypjyZzsOuJACq\/1g3Gm04OK563BJEpHA1\/O2FuNJvFnadWxig0clET3XBJordkze7xWOCJpt+kefTUI2xN1\/CQ7DpRhKTJLR2MaYCn8BVep1iBhP8ST4M3J2ZrPZXwxswPzpYIa8YvSCx1t1+jypwWV48faitsgavd9CHdPBGqnjAgMtac7Bic\/rPPi0ej0pjQ==",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "4": "000000001000",
        "43": "Receipt Address          Receipt City GB",
        "46": "000000000100",
        "127": "031",
        "49": "810",
        "7": "20210127115029",
        "14": "1223",
        "24": "200",
        "18": "6538",
        "25": "1503",
        "MTI": "2000",
        "2": "5400000000000001",
        "52": "11AA11C000CC0000",
        "22": "M12345678901",
        "3": "000000",
        "53": "2001010100000000",
        "41": "AAAAA",
        "12": "20210127115029",
        "35": "2222111100002222=00001111111199911111",
        "103": {
            "exp_date": "1223",
            "pan": "5555550000000000"
        }
    },
    "method": "p2p",
    "request_type": "transaction_payment_c2c",
    "serial_number": "00001504100A0042258",
    "sign": "M0vHg\/zx2IiM0aje7qcad6ufErEdP7ouHghZhkXkesMncGlYteB7BKtfJhWfA\/Q3ZY3RGhgNy3TJYn4\/iCLOOO6j27FcMSZqh9eoByOoW\/K4kbXhzMghtiq4Be1rxGk4Z4O9wJrYGrPFm\/\/T\/bMknzh1CrLD2A8+L1N+DcNN1HznZV2rDy6jR7y69jRlsG7rsYFmaT77eFmzl3eFuMVf2eN6kJdGGfmcNvS41Iha19tHj2btNqDibf\/PkxcQTJBFh2sBdnVYOH8LPGJ6hiM+IIjT\/9hJ4yT7S4vlpsxZ+9rVpM3W+F56uB5nNS6oZbSNUnCzVuc67QmUZLtI0F0gChy0893bkm0erjYIno0XiAjtjtcjImwVTD4CMquLZ+YjDIGEgmPL5kdN5gj9zbbx1u7qrGpJxLYfSh\/S0bnnYSXDgLhgVJrU9kuWRl0t8Q9snyLFHvuogvUKn1OgkJarYmMSKm1vczH8IHhSwBK2PnzmhKSVpvcNELh7RS2Wana\/",
    "terminal_id": "TRMNL1",
    "token": "0SS6j4P0NSKY2u4MoFU+Eqv+TIKohcfQu1abgMDWsHXbpU7VH8V9qq4KwzHdf8St"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
54 M AN 120 Additional amounts.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "000000",
    "4": "000000001000",
    "7": "20210108173914",
    "11": "0010010050",
    "37": "100704000057",
    "39": "001",
    "41": "AAAAA",
    "49": "810",
    "54": "",
    "MTI": ""
}

PIN

Setup

Operation of assigning new PIN for card, without current PIN participation.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request, the value in this parameter will be ‘910000’ for MasterCard, ‘720000’ for VISA and JCB.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from the original transaction.
18 M N 4 Merchant category code (MCC). For this request, the value in this parameter will be ’6010’.
22 M AN 12 Point of service (POS) entry mode. Point of service (POS) entry mode. You can find the description of the parameter structure here.
23 C N 3 Sequence number. The parameter is only provided when the transaction is made using contact (insert card) or contactless (NFC) methods.
24 M N 3 Function code. For this request the value in this parameter will be 100.
25 M N 4 Point of service condition code. For this request the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
55 C ANS 999 ICC data – EMV having multiple tags. The parameter is only provided when the transaction is made using contact (insert card) or contactless (NFC) methods.
64 C AN 64 Message authentication code (MAC).
127 M A 3 Numeric country code ISO-3166.
156 C AN 64 Encrypted new PIN data (used for PIN setup/change). The parameter is only provided when the transaction was made using magnetic stripe, contact or contactless.
MTI M N 4 Message type identifier. For this request the value in this parameter will be ‘1100’.
method M A 9 POS host method. For this request the value in this parameter will be ‘authorize’.
request_type M AS 20 The type of the POS operation. For this request the value in this parameter will be ‘transaction_pin_setup’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "SMB0000",
    "app_version": "1.1.1-dev",
    "data": "gaamnlbifidnefpfYeb00Sw7R9GeFUXnht\/2iEsNcYbdMbm6kis+s5uy1Uon0HH7DScfzsNisxI28thuttmi4B+3vOMXOYLA0NjDpFGAFBB5MSv42BTj0CDPcSL4bnauv1enVaby0XWi8gBKtZbuqtGBZ13LYUwRDLVL3t8xGQ+jRyjSqJiwwuDgxVR9zfDiW4jNwRtkC+TIVZqSFj0LNfMF+fBb+VxPTJxNPPvG3VgyCPjIjoQIIpw8oSLYWLLnsz2DlcPcnkNPwTCDs\/d+IFbqr811Ps8SFExViGm5q+IlSHzjEt71kG6oPAhjJip56+tBlx2GJEH3zWQgnqdC7G2bpssfWICXWErSR72wScbYdyr5mosaZKeYpcS9AWnGGcGU1WsAt15cmPX1XcUh7QaQi8GWFUFuYM26Y9pDdK+prO3K0FwWq6OjLlaaDnsAkmJ7GUJ49OxfdB9q5XRq6uKFr4\/Q4qXC1IFkyeOmkxrW2cm40QNdvEtCFbAavwfDhxaD2XzoiwZbV6g5sE\/JIkANC0lY8PXk4gOXFmUCTRFI0ZA+3LIgUvjGaB1eCvjD4PRPu4iSvpseKsvdgWfJEuzbg\/cQ5CYpyeNbv4NOUFoIot7F\/l54fiVRpwQM8guClI3La0+IjKSTB32chY+87dFl2W\/N6Y6O\/gr1RGf7oaVJaW2toy6rt05BTpEeeGos2Mn9QrSXDQelCzCjftxx\/T6X6O+wA6zkskOusogjquoTk9RVMbc81rg+gXIzRSapKcfSak54l7siwLZk7xbIuFTvfNdN1qkOg1WzXm6QxgVYGXyKslvJthXN5N4F9EZ+U1mIQ+eD+bbTZQlmkqv2RXi9ntQIs6pKOhxPk\/9z0oBe7lZqRR+kjczTsiyZ9Y8wc+\/QdrF2+log3ySn9NxZTpcZMX95XdXXjCE1qQ==",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "2": "5400000000000001",
        "3": "710000",
        "4": "000000000000",
        "7": "20201124235711",
        "12": "20201124235711",
        "14": "1024",
        "18": "6010",
        "22": "M12345678901",
        "23": "00",
        "24": "100",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "37": "032804000269",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "980",
        "52": "11AA11C000CC0000",
        "53": "2001010100000000",
        "55": "9F2608F966A14437CCC1905F3401009F100706010A03A020129F2701809F3704DED4D25A9F36020199950500800080009A032011249C01009F02060000000000005F2A02098082023D009F1A0208049F03060000000000009F3303E0F8C89F34034403029F3501229F1E0830303030303132338407A00000000310109F0902008C9F4104000000015F340100",
        "64": "EE123456A123456",
        "127": "804",
        "MTI": "1100"
    },
    "method": "authorize",
    "request_type": "transaction_pin_setup",
    "serial_number": "00001504100A0042258",
    "sign": "ajjlJ4Jq8PEO2qdIGzryJ3+Nyyj0lRLF3glrlAFOum14bY3XxwzcahwC+xKdZwocvHAmAsvn3\/A9c3v3gRKCZROyUqWo6VP7+xAu7JLVwJl52UD08gl\/WnOt2TS7e7tdQf5gwH8rphZeUMvH5JPGhJ7+zkiW+4TtS7Lm8TfenmlDW6cVCV1lpx\/h\/Qwz23BaoaFr096BTglgLR7T+pXPxMM8VOb6oyb1+VoPP2ignhbHJDztheR\/qfVEAoNfcjlXJRhRdTjdJLJARuik9Ym85tcfvUdFVWkCyLUdnp0Act3LLnYmD2vrwQLgiAFbvGB6QUXrP6g3JPe8FiA6tw258Vfy05nQS+4pHUBFEnr99x0BpR4fg5z9L7aJsoMwxFw\/KEMnIJY43KXUgWXbCOnmBcyeWZI5qmS2d2SrKk\/tH\/XvvBBQ4XUN8ETUmFVfI3pksbYAViQp6zgmiBNrzfZYhSyQJRXk9ZnJxncmvFWlx0oRGGQ+Ea+UluNikloaUQbB",
    "terminal_id": "TRMNL1",
    "token": "UH6Zy4MjPl0h9g2TvAXGCGSS31RNTu8AtqNe3ueb97y+n\/LyBJjQKbvXr8LCw8vV"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Currency code, transaction.
55 M ANS 999 ICC data -EMV having multiple tags.
64 M AN 64 Message authentication code (MAC).
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "710000",
    "4": "000000000000",
    "7": "20201124231111",
    "11": "000269",
    "12": "20201124231111",
    "37": "032804000269",
    "38": "623610",
    "39": "000",
    "41": "AAAAA",
    "49": "980",
    "55": "72269F180415623610861D84240002182685C87A54FC61E5F4188DF5094D7F3334316E7870BBB19B910AB33FD86F0547F78E30309F36020199",
    "64": "EE123456A123456",
    "MTI": "0110"
}

Change

Operation of changing PIN from current to new value, with current PIN verification.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘910000’ for MasterCard, ‘720000’ for VISA and JCB.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from the original transaction.
18 M N 4 Merchant category code (MCC). For this request, the value in this parameter will be ’6010’.
22 M AN 12 Point of service (POS) entry mode. Point of Service (POS) entry mode. You can find the description of the parameter structure here.
23 C N 3 Sequence number. The parameter is only provided when the transaction was made using the contact or contactless method.
24 M N 3 Function code. For this request the value in this parameter will be 100.
25 M N 4 Point of service condition code. For this request the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
55 C ANS 999 ICC data – EMV having multiple tags. The parameter is only provided when the transaction is made using contact (insert card) or contactless (NFC) methods.
64 C AN 64 Message authentication code (MAC).
127 M A 3 Numeric country code ISO-3166.
156 C AN 64 Encrypted new PIN data (used for PIN setup/change). The parameter is only provided when the transaction was made using magnetic stripe, contact or contactless.
MTI M N 4 Message type identifier. For this request the value in this parameter will be ‘1100’.
method M A 4 POS host method. For this request the value in this parameter will be ‘sale’.
request_type M AS 22 The type of the POS operation. For this request the value in this parameter will be ‘transaction_pin_change’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "SMB0000",
    "app_version": "1.1.1-dev",
    "data": "kjmhlllcpkedkcekRhA5Ni6SkhgZ7LJ3DuRYQqrGgdPybj1o7XutoEvqMRMWkaPDRjG7C\/gaWRmsegMpuftESA9XmtiCsxxXbF6E1qnwgu5hCpPUav4m+bjT7ije9CoxkUYxFsWZ\/srTfS\/Gk5CxQ+uhymtGsHmf0pemEkbXsoYaDQbh2cWN5BiHTJ2BmUZYdNSZOlG2PWPJ75FwrTRRTMtD9CRFX+aWvc6GqeRe9\/Rxt7sOVF8Z0\/Kx9YBZ8Tttbv\/z2THG7lIxk+jCv0fmISWQCAKngDXNnx1s+I3JUzh3\/4HDraxUG1B5Y4J7PzE\/U9VSFCUN1alQBXrYt4q\/YC1+vOUoUv1TTvRGSk6BzfCLGi7\/uKdbBZOI93qjeSRh2Cp\/FMe2SXTahVxB\/Q4zYKWiV7jZnpF\/6M6BgFwn0SniGVGsMRpSx86cumATzv3dqrKmkbFKnzmMN3aC+NjPanpR3oFXiTpLHlKcxZupZGK1Ll1goiSQE8WXBG+esq8kkPb+t1NlQ8RhBvSL8I8WVZ5DyK3kScwZL403Kip6q0X8SuJ4X71MQk\/EiCFRQwV7UQF4kMnJplu+qgQ0fjRvPLe5rBUHOFV2qaWxeOcgmkpIH6pX\/ptDWMYC7al8VqrJocEQDKwJwIvlawRl7nzgwVusBc94ek5U1aOf+5liBmiE2KZEbTwlHwwJ3TVd+JjrU8\/K9wEnopppAJda6TyMnnTr8q\/mJWIslwA42iruwTxrYJ\/t02kfgJEKFYXj0M\/AnxawS0EsJWAjlkfGCUsQsmxOCytE+RT++8ME0gi+xepy+LTtc9Oy4tAo7J4Qmis6wd+H0QzWUxSt+HAhxe14RAV172yuBEwxtc+7ZKb8zp8xEnuM0mfaUpAbjnkjdlNvw1J6rePelyVsFHh6V3NsLYg+3wLsVgxNfhz+BgXTTJW+YeD03IyivTjtc\/2LkAMawjrjBq97zfNO74AW",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "2": "5400000000000001",
        "3": "700000",
        "4": "000000000000",
        "7": "20201125000136",
        "12": "20201125000136",
        "14": "1024",
        "18": "6010",
        "22": "M12345678901",
        "23": "00",
        "24": "100",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "37": "032804000274",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "980",
        "52": "11AA11C000CC0000",
        "53": "2001010100000000",
        "55": "9F2608942D06DB414E27295F3401009F100706010A03A020129F2701809F370467AB08FE9F3602019A950500800080009A032011259C01009F02060000000000005F2A02098082023D009F1A0208049F03060000000000009F3303E0F8C89F34034403029F3501229F1E0830303030303132338407A00000000310109F0902008C9F4104000000015F340100",
        "64": "EE123456A123456",
        "127": "804",
        "156": "F22DA0CCE578FB29",
        "MTI": "1200"
    },
    "method": "sale",
    "request_type": "transaction_pin_change",
    "serial_number": "00001504100A0042258",
    "sign": "PhshDSOAyWwalp78KioiYI8xGzN1lyyBf36sGN0\/zFkwDNPTveCrDGoPt+bDTgnyRd8WhTj0xKpad1mhwM7UkxJYga\/ppmLL4Qccnm7o0XcLtgQ0KjTAwB27yjPSmAHnwfQ07a4CdJvDG16LeEmbkNRxOjv60zuII\/O98NCuxX0\/muVYmUmp5L\/2th1nRSXR5d0Bu2rQX6HwIxGgYnHQLjCLR90i22QYSjM2wnpq0zZMrmThbf0TVJSsnMiZjALKzXwhKT6szj6X+jWNJDVTTwaMEBns07JA7opGxpCekIn+sUKOsXh\/EtEY+EFxKrdsSqPtVVEQKwUxBDhhuS9U7L+QzNMd21Du4Mshkr287bDZe57PuLVSrm5DP7rexAT3\/JWQmUoeAUN91gklognw4wcFeISCoaXUD5L+QsAjpxGRrqKoAdQ8Zrcx2pf13k2WArvFfHQdb8VHmsj+ykgYx09xn40t+YpJnAbZkW2CdRfwjFBVyHfi0usPgSEiWIee",
    "terminal_id": "TRMNL1",
    "token": "UH6Zy4MjPl0h9g2TvAXGCGSS31RNTu8AtqNe3ueb97y+n\/LyBJjQKbvXr8LCw8vV"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Currency code, transaction.
55 M ANS 999 ICC data -EMV having multiple tags.
64 M AN 64 Message authentication code (MAC).
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "700000",
    "4": "000000000000",
    "7": "20201125001136",
    "11": "000274",
    "12": "20201125001136",
    "37": "032804000274",
    "38": "623677",
    "39": "000",
    "41": "AAAAA",
    "49": "980",
    "55": "72269F180415623677861D84240002186F12CC473B8839AF169EC7D04103BB0A5F20251E9C7F836A910A1873C02FD687F97630309F3602019A",
    "64": "EE123456A123456",
    "MTI": "0210"
}

Preauthorization

Post

The first transaction in the “Pre-Authorization-Incremental Authorization-Completion” cycle. Frequently used by hotels, car rentals and other travelling services. For transactions with this type, the settlement is not applied at least during the next 7 days.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from the original transaction.
18 M N 4 Merchant category code (MCC). For this message, the value in this parameter will be ‘3501’, for Moorwand ‘4816’.
22 M AN 12 Point of service (POS) entry mode. Point of Service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 101.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1806.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
64 C AN 64 Message authentication code (MAC). The parameter should only be included in the MACing transactions.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1100’.
method M A 9 POS host method. For this message the value in this parameter will be ‘authorize’.
request_type M AS 20 The type of the POS operation. For this message the value in this parameter will be ‘transaction_pre_auth’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version M N 20 Terminal Config Version in Datetime variable. The parameter will not be included in the MAC transaction.
terminal_id M ANS 16 Terminal ID for API.
token AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.9-mb",
    "data": "decppalbneblhfeeOGH4SOcnvK6pPG45iHFM8PUcR2WTyPr+AXk5paEg73jSDzno5IcTO+1h4EIv1fG\/mmRp52BirpdExz6STJNwZoDyyJt5XOXjCGSHhiKR5hGWXGHWe\/yu4UuUuYQCXHHj2wI505iu9jP6h4yQPq9RIkDhLrPJCOntR8MSAnYH7XUHqMp94f2umLggc3Qm0frtLxMAQiCLv6TZrfkSy+cbxapYiZSxAVJWcV+HqP4Vrfm+ef2wDgwY+9di5FQiCk1AeNebSgltyoRBI2yeOBJktqseLeVzjDyo2M5\/25eUd5AF2Xz61F69Fcs3ONlL1bpmKju4LZl8+gTEwK2r1yQP+84EMAjKLzCTp9lnuo4l7+dJI6uxqjr5laMNXIxWsozcoh7ki2qHHE1B\/plFjaSHTNnztDt9EDeK38kCY1KJync=",
    "guid": "basewin_0000150410PI0000118",
    "initial_guid": "29b86cf4-1cac-4730-b579-53c6b2297f13",
    "pure_json": {
        "2": "5400000000000001",
        "3": "000000",
        "4": "000000000222",
        "7": "20201231121743",
        "12": "20201231121743",
        "14": "1225",
        "18": "4816",
        "22": "M12345678901",
        "24": "101",
        "25": "1806",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "127": "826",
        "MTI": "1100"
    },
    "method": "authorize",
    "request_type": "transaction_pre_auth",
    "serial_number": "0000150410PI0000118",
    "sign": "sHb3fj\/dxm5ov467g7YaEarcX9cjZtVUbdjZC7ovn\/LaJRoq6GqrcT6jqyEgYEGuIS1+VKmGePrrFf22rwOWlHfCkCqjFUnNnjBD1ETzixoYpnyrvsgyO8JCqEEEX5gf2IZ++R1Bv59pSVXHr0dbf0RwDu2WZ1rDqbj2\/KCnserQ\/X4rX3e92dM57tQGRUK3w3K3NC6JNbdYHRWCDD8SHSWgzSQZnqNgOJCkm3ZQxpo35LBJp5qja+qkGmFZLSi+OOMjrpyiVd4edcusTsgxeay2NaOZ3OwFc9B1XNZAy627dfmZC\/25FlHHQB37Rd1P6sOUSvCxGGUXaXH2CR4PL+B3CAPRhJEW5+4ZV9cg4vGjBXLSL0eHhcO2HAEtw9UFqG9NgJe2zHHvCb2C99CloHun5VnsPVK2yN\/N1zutm\/W+D7lPBgkMR9U+r5uwDGVPd2ZcPxRsxdBRAZC\/KLvd8haayv4+CH4k6K1XHrpk6PYPFlK04PdCucGXo9e0Wqg1",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Currency code, transaction.
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "000000",
    "4": "000000000222",
    "7": "20201231121744",
    "11": "000196",
    "37": "036505000090",
    "38": "008729",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "95": "000002700002000196201231121744",
    "127": "826",
    "MTI": "110"
}

Increment

Second transaction in the “Pre-Authorization-Incremental Authorization-Completion” cycle. Is used to increase the pre-authorized amount. Has the same properties as Pre-Authorization (the settlement is not applied during the next 7).

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from the original transaction.
18 M N 4 Merchant category code (MCC). For this message, the value in this parameter will be ‘3501’, for Moorwand ‘4816’.
22 M AN 12 Point of service (POS) entry mode. Point of Service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 107.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1777.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
57 M AN 12 Original retrieval reference number (RRN).
95 M ANS 32 Parent transaction ID.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1100’.
method M A 9 POS host method. For this message the value in this parameter will be ‘authorize’.
request_type M AS 30 The type of the POS operation. For this message the value in this parameter will be ‘transaction_pre_auth_increment’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version M N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.9-mb",
    "data": "ccjlpifobdfggggp1G8m7TPp0IHnTw\/EBqhQ44Oc03JPAFNcZcnqH7mEWobrgpp13oePATHbkFE4xzdRaNU4joSW8R3FNhlIjd6dn+5VXgRkuQfY52TcNTQeN40vXEwkiGawBNVlnnWip8i4CkRHAoRTD3yA4XuERIVp5g6llgS7yrXaGdStutiwZupuQt99gXdK6VoEw7qoRo6MSY9+5cPR3165nb+nJ6ONGK9plXC7f\/ZUs+sEe1KZA8R\/bmmAOH3HRfH6+HfAP7LNnE\/cpWZfROn8hB9jFI8lpJ3w+05uIJE4VJatR+mgKXDVb4ILL5dM0Qouw\/gpdo1zIaOQCQgaa3aeGkRDsuZcyr4lCy8V9K5YfdzKhxavPjmFQqQfmvfifMfbRbReWvoyCD3zEQZombwd+qjZoiB3LQ38N60i4j6eQjOaC748db8FTChJaDw8JEUrufPqputy2GOphIwNX89AhH\/w9jd\/J+LYy0Wdwt8\/Y5EmmFSaXWfHbVKmwwoQO1mcD3hGSyZR",
    "guid": "basewin_0000150410PI0000118",
    "initial_guid": "29b86cf4-1cac-4730-b579-53c6b2297f13",
    "pure_json": {
        "2": "5400000000000001",
        "3": "000000",
        "4": "000000000222",
        "7": "20201231121801",
        "12": "20201231121801",
        "14": "1225",
        "18": "4816",
        "22": "M12345678901",
        "24": "107",
        "25": "1777",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "57": "036505000090",
        "95": "000002700002000196201231121744",
        "127": "826",
        "MTI": "1100"
    },
    "method": "authorize",
    "request_type": "transaction_pre_auth_increment",
    "serial_number": "0000150410PI0000118",
    "sign": "hiCoXk3vsZPOPi+7HadTrH3GvjsiCdnGASTj3hTuKS6n66uW8gGFOC5MgJgtqhu5f+igAV2tSVDKCYflVI0oKFNgzYjlZWW1uhzbz51gctfVXEoNNSPCrRDTQR\/M8Av42piBIPTQwjuefQB4HOPRw\/sUwzAqBukDaBJ7CkfLZyZPzf0W5iYRGiJQUI\/thia8uLwkkeoDTnU+l0w5FbGM+LK6rCM7jf1OhMnSksh6+OoUmAg45Rs5uW9B6JxbTCM07t2z\/c2pMPJwgcZDhKkC57gFmRaXU6E98WUoLNw2k\/KwL5jkDEQSco9lRQV81nzCWuvRXYpvSXmImB1kbu+Tf5SqW802Ze7V+CpHqI9UmUqHmESCYKx\/XgpTFoVmEXbfH7xqMLgGePUGkJ585bl03i\/5CjTnOL1IwRIhO+sAUbfmiW21ZzxQZAqI5bhOQWEt2i1hHnPvu63GwhGDFCw8U4wjETG8SW8V5\/uWJi3bxQK\/AR5HjxcVZGR43+Ssg5Vn",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
15 M ANS 32 Transaction ID.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
57 M AN 12 Original retrieval reference number (RNN).
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "000000",
    "4": "000000000222",
    "7": "20201231121802",
    "11": "000197",
    "15": "000002700002000196201231121744",
    "37": "036505000093",
    "38": "008730",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "57": "036505000090",
    "95": "000002700002000197201231121802",
    "127": "826",
    "MTI": "110"
}

Completion

Third transaction in the “Pre-Authorization-Incremental Authorization-Completion” cycle. This transaction closes the cycle and will be settled after End of Business Day.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST
Request
Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from the original transaction.
18 M N 4 Merchant category code (MCC). For this message, the value in this parameter will be ‘3501’, for Moorwand ‘4816’.
22 M AN 12 Point of service (POS) entry mode. Point of Service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message, the value in this parameter will be ‘202’.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1806.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
57 M AN 12 Original retrieval reference number (RRN).
64 C AN 64 Message authentication code (MAC).
95 M ANS 32 Parent transaction ID.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1220’.
method M A 9 POS host method. For this message the value in this parameter will be ‘authorize’.
request_type M AS 31 The type of the POS operation. For this message the value in this parameter will be ‘transaction_pre_auth_completion’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version C N 20 Terminal Config Version in Datetime variable. The parameter will not be included in the MAC transaction.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.9-mb",
    "data": "cnlnjoocbaeiefmpDcIlZro6vJeVqLYHJVqsSJIDK\/7izEzne9xgZCOEA8RK24zYT0SJZRnymK+JFcaFQHXvYYUl31mnXVQvr1HbyaEqwnf37HrQJJvF7jEBxEuQTzb3y9WIP5OVhHTOcqgtmvUlKG9rkaNClQoQz0ofovkPqJ6UgPXNOfnFq2ru\/9NMY9T7xDSa3TpWP6kK+cCQu\/y13ab+LNcYxPwHYS5KQJAoVoscKy1mFj5Xgv+9JTtQOGpfpUgCjeY2IYRhh1oTWk4NWHHTppAid5ZQcWWISUp26UoGwll5eyg56L6WS\/4MTW0OD7xe\/9dEOVPSVDJv\/yeDwonbi6mHCOtOPmfluVYvihmYHje+uYs0g6ZyWcnpSXS+aeyZZcggotq64wWvH8w4IIKr3w2YggLqqmraANswJ4USA6h1W3v6qSjhr9WdTrYaw6XXQVYfY3seOBYvzNAGRYDt6r8cQk5114OH83P57dUkwr0V8AhiN4qt1QEdVEU8obLRoMDqJmmmKFss",
    "guid": "basewin_0000150410PI0000118",
    "initial_guid": "29b86cf4-1cac-4730-b579-53c6b2297f13",
    "pure_json": {
        "2": "5400000000000001",
        "3": "000000",
        "4": "000000000444",
        "7": "20201231121824",
        "12": "20201231121824",
        "14": "1225",
        "18": "4816",
        "22": "M12345678901",
        "24": "202",
        "25": "1806",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "57": "036505000090",
        "95": "000002700002000196201231121744",
        "127": "826",
        "MTI": "1220"
    },
    "method": "authorize",
    "request_type": "transaction_pre_auth_completion",
    "serial_number": "0000150410PI0000118",
    "sign": "uFQDIzfUdF5GtouWtuZAmu0p0bKVJ2LyukfVnYvzP70rNCuulng2wHKNG9bMRC9j5Sc+DOUTrcAiJ1IaCwWa2l433Mqd8SKVn4aFMQiF5QZl5oqB8GYkZs1MV8of1oybID\/jA\/Scj+ennf0lelbYd42ySkfgE0WdHDVwdnFnrdKcGUKICNifvd0227BOM2pguF2np5tLZlV35zV0EUBX0CvTZ0ox\/mS26iMCsBSKnWJIVTrmvU8clL7nIHd0JOKy2wNr\/kcaiMQova1zVufzFWOtY7kMm5W41vn5WlBaU+j1arYRhv4OHFDM\/zTbYQIyOHY9P4YEeeGXxXYdqR1soIVVnClmzVLQAmPFz1YlKf4ZC2LWb6sZEFtraML5Gpk7aIO1vGwGW\/AIpZgPTl7oTb5zMe1Wj8h3qL0Wzf\/VDzW3M1oNO5EhdRovFGA7KzBvea2\/gOEda6n8+Qpu1vcWwuI7tumvl5rf1FxKlZ0wQGvP6bZYi3CEh9Cz7uTaJTmf",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}
Decrypted ‘Data’ in the response
Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
15 M ANS 32 Transaction ID.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
57 M AN 12 Original retrieval reference number (RNN).
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "000000",
    "4": "000000000444",
    "7": "20201231121825",
    "11": "000198",
    "15": "000002700002000196201231121744",
    "37": "036505000096",
    "38": "008731",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "57": "036505000090",
    "95": "000002700002000198201231121825",
    "127": "826",
    "MTI": "110"
}

Quasi cash

According to the VIOR: Quasi-Cash Transaction — A Transaction representing a Merchant’s sale of items (such as gaming chips, opening deposits, or money orders) that are directly convertible to cash.

Was frequently used in 2000-on the beginning of 2010 years for the work with electronic money, monetized bonuses, virtual gambling chips, etc.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from the original transaction.
18 M N 4 Merchant category code (MCC). For this message the value in this parameter will be ‘6050’.
22 M AN 12 Point of service (POS) entry mode. Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 400 if the reversal is full and 100 if partial.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1100’.
method M A 9 POS host method. For this request the value in this parameter will be ‘sale’, or ‘authorize’ for JCB.
request_type M AS 22 The type of the POS operation. For this request the value in this parameter will be ‘transaction_quasi_cash’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version M N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "M488611218",
    "app_version": "1.2.9-mb",
    "data": "omdgghifpgkjfglga69qLooV7QKT3zLPrkPuaTvT/yqiKYwTzAIlcz3VZ35iO64jD5uB1QTknOhJY3QCwHKwYmy6wIaePX8+B3vM3vKLDzA/WVddInlUNkpLP49qBoxGcjpN/x/0ep+2Rcm+gyh4JrQr+OwcshGEFmX8rdLqGEhMvaY0LMFYK1DXmQfF1nzYyFEL6wOdfiFDHNfKlC4/t+VFa5UKUGWMgGT6MNBDQhrW9r6miEiNQvI1mlDaF0yfY10EYefGNxEwEY0Z0nx43RLBaYIYugVJ/tomCDLDT5EDHPlojelrDrVyVEy0fT/BD3tnLfn1R65vCOuVFO9LD9jRyJ6Qw0YJR9Fp+qyAjkipeG+15NDhkYJmLsEvk9OLgT1Ao6celYAnarWaM88YpXPtSXNPJ75MuuUb7km7HFLGyuHevVtTtkbadpo=",
    "guid": "basewin_00001504100A0042302",
    "initial_guid": "f59fff15-bc51-4c6b-893b-741dff93e3e5",
    "pure_json": {
        "2": "5400000000000001",
        "3": "000000",
        "4": "000000001000",
        "7": "20201231130943",
        "12": "20201231130943",
        "14": "1225",
        "18": "5311",
        "22": "M12345678901",
        "24": "100",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "840",
        "127": "804",
        "MTI": "1100"
    },
    "method": "sale",
    "request_type": "transaction_quasi_cash",
    "serial_number": "00001504100A0042302",
    "sign": "aAinBOaimx0HzJHp13DjoGmMb/YaXL0G2GRoIycCIw/f6gMVEBSSDjXl0vxSJJ/mPDgc1jKa6+zgNRAqFxaBc3igzegqiwBPyj62Len3Dy3htw7mlXM5kOvioMX4+4cCznrDTCkKYYJrP+xsrK6P42hkusVium6ToRbrxp5EtfsIEuN2x/FWQeDQ0v9607n13T/3e6WbNzKBJmeskINy7b+vPllpoeBloLHLwhmykcLfeDQ9K+ZghkHGFfbbKkChp78BekxYo3MArkdEvPu1dYZQHk9dTmnJ8yXF8V009+s4rHJNpW4DGo5HrmGG/HQJMV+PQNabvXAEN+8XMlOgkhDTnY7lkZeXVlg6tI83dMNncIPgipH57s62jAYgqexz6dhcdR8rnDqFYG4FS2Tm1p0przk4xFeCcVbULhq8577Jxpu8af5B72KLSOwIvXxRYGensJ75hBEYSqt/hPxGzvw91YP1bQPG/aG/ebiDwGFqMojrge4mQilDRg2YHAAa",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "Token": "fr0l5orb50gehlhnhqb9"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "000000",
    "4": "000000001000",
    "7": "20201231100945",
    "11": "000150",
    "37": "036505000066",
    "38": "008725",
    "39": "00",
    "41": "AAAAA",
    "49": "840",
    "95": "000004100016000150201231100945",
    "127": "804",
    "MTI": "110"
}

Refund

The operation is relevant to return goods or money for the unprovided service. This operation can be performed as a separate operation or operation grounded on sale operation.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message, the value in this parameter will be ‘200000’ , for JCB ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from the original transaction.
18 M N 4 Merchant category code (MCC). For this message the value in this parameter will be ‘3412’.
22 M AN 12 Point of service (POS) entry mode. Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be 201 if the refund is full and 202if the refund is partial.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 2000.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
38 M AN 6 Authorization code
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
57 M AN 12 Retrieval reference number (RRN) of original transaction.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1100’.
method M A 6 POS host method. For this message the value in this parameter will be ‘refund’
request_type M AS 18 The type of the POS operation. For this message the value in this parameter will be ‘transaction_refund’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "m_poshost1",
    "app_version": "1.2.9-mb",
    "data": "oghenfhcjipmgfjppiqvsmziDMGm8YwSPg4SLCUiv2KcsihEol7nmV33uDhvxdN\/dqjDiCdkymLKDn9U79Fle2w\/6fbp0kRhohkQPz980fV1Sct\/tYzQniOBnLCZBDOglbDjz6mYAMrWmdIFquxebDzSRqoHkE5VpwG8NAcKKOHApp0ZJwQz\/sQEsgYAuyNW8pkRHXfGJXIEPKhyJdi5VJ9zyqax\/N4O7a4uP5wdOY8lqrP\/aS2oEdGeKS62LOZcGn0ZlOKiw83T7E81twOZG0TUGiEC1YogZ6zip9Ii92oGhqE+W1DOfoGvsBifOPCjJ7dHIk6XJe07zq5pZdfv8HV3hAj2gwk1Ab2VJ6JVoufTIyjrE0EaiIWkeO7bS0Otkjr14USKfHryHKX2A7CLXib7wQCKC50R3sj2lTXI3TtIR95g+YGvN9zzc8sqp\/MSJEXLb4+4r0DmZJQGZ3PrVEnzLkMTGFPvRxgih6GmthV+b2yC0UoAPZAjsqk=",
    "guid": "basewin_0000150410PI0000118",
    "initial_guid": "29b86cf4-1cac-4730-b579-53c6b2297f13",
    "pure_json": {
        "2": "5400000000000001",
        "3": "200000",
        "4": "000000000123",
        "7": "20201231072206",
        "12": "20201231072206",
        "14": "1225",
        "18": "3412",
        "22": "M12345678901",
        "24": "201",
        "25": "2000",
        "35": "2222111100002222=00001111111199911111",
        "38": "008716",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "57": "036505000004",
        "127": "826",
        "MTI": "1100"
    },
    "method": "refund",
    "request_type": "transaction_refund",
    "serial_number": "0000150410PI0000118",
    "sign": "ErPhYmc6DaEeTclmkoEhXqlnAtTanC4RrcPC+bz+4Yh4Sqw2CpONvjB8LtccEaziv4oRw2OFilAfN6Aq94ufWEOMTkwdGW6ndPnTQv0HzfI6dBZEo1OJiwLJVHM6b3v2vUBCVG87+jhC+xPvo735IT6S0uJGBxBkN2GxRFD99kio6hI67Cw8mizmdUAbbSeWWprCv4ZD6guHH6ReHDrOGkTX+4tRyL1ogSygBfsj0I13NwaftAUPJf+03WGX\/3GH08lVrSg3874DWQLrdR6IaehHzSFl6Z4CwcaVb0pO2U5jRB8ExuU2Wn1h9\/ifeg4aEtM5K8bhMiR7TTKbjbIj6XZR7LfEOuOWxCOXu03C0jVC2LZYlHT6x18wV4pg4dxYQkd6HK3uue2hH\/1JDNgzleQzt0rESgo1KJ4RKaHh3yD3hopjDFTIClW6FltUMlKF1fAzu9uWweCk7HEZAsyJF7jiJ+XwwV\/e6gaSUDXoMyjwdnxPOIsGnKdYKtr3IIrI",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
15 M ANS 32 Transaction ID.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
57 M AN 12 Original retrieval reference number (RRN).
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "200000",
    "4": "000000000123",
    "7": "20201203120909",
    "11": "000176",
    "15": "000002700002000175201203120837",
    "37": "033704000024",
    "38": "008428",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "57": "033704000021",
    "95": "000002700002000176201203120909",
    "127": "826",
    "MTI": "110"
}

Reversal

The operation which cancels other operations. If some amount was held on the customer’s account, it will be available once after successful operation of Reversal. Reversal can be done automatically by the POS Host or manually from the POS Application.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this message the value in this parameter will be ‘300000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
18 M N 4 Merchant category code (MCC). For this message the value in this parameter will be ‘3412’.
22 M AN 12 Point of service (POS) entry mode. Point of service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this message the value in this parameter will be '400' if the reversalis full and '401' if partial.
25 M N 4 Point of service condition code. For this message the value in this parameter will be 4000.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
38 M AN 6 Authorization code.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
57 M AN 12 Retrieval reference number (RRN) of original transaction.
64 C AN 64 Message authentication code (MAC).
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘’1400’.
method M A 7 POS host method.For this message the value in this parameter will be ‘reverse’.
request_type M AS 20 The type of the POS operation. For this message the value in this parameter will be ‘transaction_reversal’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version C N 20 Terminal Config Version in Datetime variable. The parameter will not be included in the MAC transaction.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "M488611218",
    "app_version": "1.2.9-mb",
    "data": "kjelldlibkmdmbla9rfdjP1qvTkZ//zmhmJeKitXzK7OH37pWBpZe8dRiMXjYtp+cCxXFK+IwzPyzsHEddbNY4WA5P6BICIB/YMwm5jmc6i1pObntNbpPulPiGOkEISxmq2/mHogOgoSRSbEo51u63YY1wCyDAFLamLcxXdyQa/97JcWtgar7V9y/VEvhPhSrlZqFCiLIEvyQgJtI+LODA01qmVPaMzt9eZB7f0Q05/ytKAkgXaRgpaitMb8ylQmkkw1Oz2L7jU3/9pfQ4HVXmQtF6qUX4RrM7Xhak6v1X00tmQ5MIOuYGA+HTap4nBJVVa2KZPzaaABwsgORo/8CCZbitnKeK32wv4W8zlrihy3ZMrE6/Rv8JDsfnHxhgTCC4ENBgBgWXmi3dgROZFKvi3JdULHTVrlqfLPoQ==",
    "guid": "basewin_00001504100A0042302",
    "initial_guid": "f59fff15-bc51-4c6b-893b-741dff93e3e5",
    "pure_json": {
        "2": "5400000000000001",
        "3": "300000",
        "4": "000000001000",
        "7": "20201231131135",
        "12": "20201231131135",
        "18": "3412",
        "22": "M12345678901",
        "24": "400",
        "25": "4000",
        "38": "008725",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "840",
        "57": "036505000066",
        "127": "804",
        "MTI": "1400"
    },
    "method": "reverse",
    "request_type": "transaction_reversal",
    "serial_number": "00001504100A0042302",
    "sign": "XfJWjThQCNeON3/VBz1TGpnebUnC8nkNNDvrLus2Mdf+3kjtH8/G87jJJjDBagRZJ4xUtHyxQHcP980axyhjLiA7N3sqstZ4taeHVMQ7l5wYK24HlYSIpw8Kbdtl/fYd/8Yp8HfElHqb+xqDrCldyTBQFEzWeyUE3KRVv0y5fkK5zH/4fvHAeaaZ3zlAvD+gMSw6myuW28rj7fINdV47OKscAsVEltFwcBzicIqpkHsXoYztppIi1fpZJQBOkBYISRnqSEB9qs/AZEbZfIBLc6AqrUgrxRnRdrbKxSAy6HJCfzsnZgTEMxJUW5gDuqNHRI0FnvmaXTRlg5xntFvg2wQkvXn/N+VJc4Dw3XEBvAtATK9I0YSTuyWOia/WaAkHRluzNNOhyxOIO4ZzJA2GXRx/dneY4vy5zzsCPMpkp2Tv+E9PyVSa/8HVZOVvyUOM4PIL3hoGiI7cxKLSKvwo+fhwpm1SSOYFKMVzQPLpDhue+qBisxCYflubY9oz9q2y",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "fr0l5orb50gehlhnhqb9"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
15 M ANS 32 Transaction ID.
37 M AN 12 Retrieval reference number (RRN).
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
57 M AN 12 Original retrieval reference number (RRN).
95 M ANS 32 Parent transaction ID.
127 M ANS 3 ISO3166 Country code.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "200000",
    "4": "000000000123",
    "7": "20201203120929",
    "11": "000177",
    "15": "000002700002000176201203120909",
    "37": "033704000024",
    "39": "00",
    "41": "AAAAA",
    "49": "978",
    "57": "033704000024",
    "95": "020002700002000177201203120929",
    "127": "826",
    "MTI": "410"
}

Sale

Sale or purchase operation.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from original transaction.
18 M N 4 Merchant category code (MCC). Received from terminal config.
22 M AN 12 Point of service (POS) entry mode. Point of service (POS) entry mode. You can find the description of the parameter structure here.
23 C N 3 Sequence number. The parameter is only provided when the transaction is made using contact (insert card) or contactless (NFC) methods.
24 M N 3 Function code. For this request the value in this parameter will be 100.
25 M N 4 Point of service condition code. For this request the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
52 C AN 64 Personal identification number (PIN) data. The parameter is provided only when the transaction is made using a magnetic stripe, insert card or contactless (NFC) method.
53 C N 16 Security related control information. The parameter is only provided when the transaction is made using Magnetic stripe, contact (insert card) or contactless (NFC) methods.
55 C ANS 999 ICC data – EMV having multiple tags. The parameter is only provided when the transaction is made using contact (insert card) or contactless (NFC) methods.
64 C AN 64 Message authentication code (MAC). The parameter will be included only in the second sale request and only if the response from the processor had a ‘MAC’ code.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this request the value in this parameter will be ‘1100’.
method M A 9 POS host method. For this request the value in this parameter will be ‘sale’, or ‘authorize’ for JCB.
request_type M AS 16 The type of the POS operation.For this request the value in this parameter will be ‘transaction_sale’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Date time variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "9100020015",
    "app_version": "1.2.0-dev",
    "data": "locnamlfiocnnepebs3L7ALKE0lkjzwQqcS\/9XTC\/hRkDmpQJjfMHr4n1hQ2qQA9nqsL4Bx3QNQMcZ4ghJwKLQVrLfqbKaA0fjhr5M7WMy4OVV+jXbqeyP2Jytyc2kaXx\/QqZp2iF9O+00iagK+V1d6aaT710M61DW0jI4P0dFCYLfT44Yzme8LbJlOeLJWZWgsRXMH0ximbmXT8gNtQEMuIM5jm1czxuhybBsLT2tcdbXkO6ieW2dLwZRi2i\/66XJAjvWISfNAyOe8GxkqLy3h+UHoIgyJdrIU+ZDP6uupeBbIWESRIBhafonunFf1gCIs4DKnsrdUPqUOWb9P0umUpdMiP487HWAEcUNHTew7c8XmDddScgqO40M5\/6sR+wnpQDGA1gQNTUI\/Y+XjGSuWk5LfupZ\/TEu9OATweJZtRu5uYv+LwPaIWbCFUSBSd5EI5xCw5wLHOJs\/bl9d5aqSNBd9wTlm\/L\/G1aAb+q0GE9PX81hdxcY2MnYJUB6RW\/W92J9apUvAGfxPFP52MrlCw1msYjeXhTrRogcX9DV96fP+g+ChgcWOhv+ysKwDeD2mZqrRgYSviq\/P9Mv\/ELbsNFvgD6VxwLz37+JPZRztyWCB4HABQ1iBh+Vz7dx\/3zzg3BuoP2+pr3GbcZ2OexcOLunBCPB8WGkOMvazVhxgxdF9pO9C3F7FNQTRh2wN2S4qqq1N\/3tcupKuWbZkkRhKD3ELMCGsHDD4dcvD8lMMcSVMqW4BXVW0DjlCPZ34b+6NDY83Zr5Ex3gdWJQA1CG+hdOuxbdj7u88\/M4H7qj89O\/ymo7xzYmzLibfo8LZroMZZ1AWQNmwiqPFYYheVN\/D+deYyTVlRY\/XYOLKwc3ObDUUQuTR\/hP0CMrJblULqM5K\/Q0DaY2BaEez\/",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "2": "5400000000000001",
        "3": "000000",
        "4": "000000000700",
        "7": "20201228093209",
        "12": "20201228093209",
        "14": "1223",
        "18": "1332",
        "22": "M12345678901",
        "23": "000",
        "24": "100",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "37": "036203000005",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "978",
        "55": "9F26088713D0FBD9D7E3315F3401009F100706011103A000009F2701809F3704985DA2E19F36020288950500000000009A032012289C01009F02060000000007005F2A020978820200009F1A0200319F03060000000000009F3303E0F8C89F34031F00009F3501229F1E0839303030303030318407A00000000310109F0902008C9F4104000000019F6E0832303730303030305F340100",
        "64": "EE123456A123456",
        "127": "031",
        "MTI": "1100"
    },
    "method": "sale",
    "request_type": "transaction_sale",
    "serial_number": "00001504100A0042258",
    "sign": "dGtXwJW5Jsp6bPoLHo34F9RK8Vs39YVQ5EJUf6gCSfoNWOSyZ2UfcyYy4sSjf0NGTzyLI6WJvj3E195Rhb5uMUAldXYG2LQgD+aWMfo8u\/ppASc7WtuIkG3Uv3OkBJeTtXkWoDmYw4lBunO4r76O1b\/YXq7aVjd088HqtozdU+\/z1rspKM+qWw6gu7lt1BvktDLRDE3vj4dkbuyfovTMUDEzR81tl0\/CO8X2EdEdyS\/W0WrEjaUjyQsZcciOthSwYtBv\/3xTTHllJqR0eJfviOt7xpVJVSObClHWH6WmzkUIdpr+mY+UmdGgp7ROwy+JGidvO38Y6Uuhd5ZLFx+E8dIHYn\/Mw6xfFVDDxsyLGt3pCcgt1\/\/VOIQol8Qi+Wls5H+WE4DmvVcEfSo\/ASZhCXdH8blJuMzpriJu5vKOHAIANE+Bg03WaiXDlVLHT\/jA1Tln+VqFq1byJSjbSxoRGIK5b7eTW85siuXE\/YcGw1Rfn0dX9mi0Z+NoFZBW0war",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
38 M AN 6 Authorization code.
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
95 M ANS 32 Parent transaction ID.
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "000000",
    "4": "000000001000",
    "7": "20201231100945",
    "11": "000150",
    "37": "036505000066",
    "38": "008725",
    "39": "00",
    "41": "AAAAA",
    "49": "840",
    "95": "000004100016000150201231100945",
    "127": "804",
    "MTI": "110"
}

Statement

The request of mini-statement about last N operations with the card. Parameter N depends on the processing system the POS Host is connected with.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request, the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
14 M N 4 Expiration date from the original transaction.
18 M N 4 Merchant category code (MCC). For this request, the value in this parameter will be ‘5311’.
22 M AN 12 Point of service (POS) entry mode. Point of Service (POS) entry mode. You can find the description of the parameter structure here.
24 M N 3 Function code. For this request the value in this parameter will be 100.
25 M N 4 Point of service condition code. For this request the value in this parameter will be 1503.
35 C NS 37 Track2 to data. The parameter is only provided when the transaction is made using magnetic stripe, contact (insert card) or contactless (NFC) methods.
37 C AN 12 Retrieval reference number (RRN). The parameter should only be included in the MACing transactions.
41 M ANS 8 Card acceptor terminal identification.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Numeric currency code ISO-4217.
64 C AN 64 Message authentication code (MAC).
127 M A 3 Numeric country code ISO-3166.
MTI M N 4 Message type identifier. For this request the value in this parameter will be ‘1100’.
method M A 9 POS host method. For this request the value in this parameter will be ‘authorize’.
request_type M AS 21 The type of the POS operation. For this request the value in this parameter will be ‘transaction_statement’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "9100020015",
    "app_version": "1.2.7-dev",
    "data": "mpomfageapbgdgjbk7NKCKEdn7SZ3wC33v3dWA6CeqrkqbyD+DgSXZdxzEYlYhig1ijdfKQK6axdBskL+FBCLjoqIAmGT2CbJxxvTODCj8AndgXFAZf2CjWV9KNV9LgZuBKOyUYnyoO3cfg+EbJc1MVBocz65UXUYn7WRw0dGdBYDy9E2EL7fr4+0M75TW0\/GHigr51RosJnJIJRFCHxidVydxub6OyxIAoviMfbOczlu2H7\/o3oP0zHIcXrBlXEsGH+KIoAgFilqat9KsMWurJ4ChzHc1BgDh8w03X1iDGJ0NpVICMy0Vs2ayhY9RlJQQrLZBd6UCks5BStihvtpujtBlnHshgdaBp5j5K4vqMQp9\/cQeqOO532uD6f4\/af8OKdgpFgXhFp5A5w+KsoHk864q4B5h5ZRWzYDNZqDXC1I4jfEQz2S8ruayWzgL3Y0WxlKdwkGcBtEd7fJlOt1Fxm\/NKA\/h4HNcshuQ==",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "2": "5400000000000001",
        "3": "360000",
        "4": "000000000000",
        "7": "20210111085529",
        "12": "20210111085529",
        "14": "1223",
        "18": "5311",
        "22": "M12345678901",
        "24": "100",
        "25": "1503",
        "35": "2222111100002222=00001111111199911111",
        "37": "101003000015",
        "41": "AAAAA",
        "43": "Receipt Address          Receipt City GB",
        "49": "810",
        "64": "EE123456A123456",
        "127": "031",
        "MTI": "1100"
    },
    "method": "authorize",
    "request_type": "transaction_statement",
    "serial_number": "00001504100A0042258",
    "sign": "aqNmORTiK4YsJ3jbTCuNqUP9t1HCj+J\/7v+IiYeeTrGZrbObGix+GbeIREJT9w3jL2YGx+l5WJmLwssjpSPwRRgPC9qT9OqvY6sda07W9sd8YRBtXG2iYm1DAenjTmLDX+fiR4FvlULp7M+aBDt2e7+1hFAufyXWBT7tz0t8egB6iTeKQiUhO\/\/cysukBirvawN4FgZ7kog5LlURhN9F65M8Jq4Ma2BxjSMFhXKIbjJSjQS2tk3v0sHTcR6V7R8pdEc8TMQtE92M3clcsJl5Gdmqx3XTc0m\/rp\/\/PVoNZIMvrfiOvABJJxPQEBeCHFoPrGzBaQTqJK9ffOSdXBo14aLZkAGE5sHS1\/WKrBQfb3nLeGYXvVXvJhrp5NSOs33AhmhHPZIIY5MPxqG\/05CVHjbxtlyRjO83IxJszS5Qrv+L7EpmQ3UpnW3kYXaSFgZSA75B6WJANKSQILroaiwc9MUGxP8ZY6kqDKLa4cHxMjx6Av2\/EP\/MidXhY43w4+6C",
    "terminal_id": "RLMISAAC",
    "token": "89dwi1patf72bb2h3r64"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
2 M N 19 Primary account number (PAN).
3 M N 6 Processing code. For this request the value in this parameter will be ‘000000’.
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
11 M AN 6 Stan data. Used for receipts and will be unique within the day.
37 M AN 12 Retrieval reference number (RRN).
39 M AN 2 Scheme response code.
41 M ANS 8 Card acceptor terminal identification.
49 M N 3 Numeric currency code ISO-4217.
54 M AN 120 Additional amounts.
808 M OBJ - Statement data.
statement_records M OBJ -
date M N 4 Operation date (Format: MMDD).
operation_code M AN 3 The code of the operation received from the vendor.
amount M N 12 The amount in the smallest monetary unit.
symbol M S 1 If the symbol ‘+’ means laundering, if ‘-’ means prescription.
MTI M N 4 Message type identifier.
{
    "2": "5400000000000001",
    "3": "360000",
    "4": "000000000000",
    "7": "20210111085529",
    "11": "0010010030",
    "37": "101003000015",
    "39": "001",
    "41": "AAAAA",
    "49": "810",
    "54": "",
    "808": {
        "statement_records": [
            {
                "date": "0108",
                "operation_code": "027",
                "amount": "000000000123",
                "symbol": "+"
            },
            {
                "date": "0108",
                "operation_code": "004",
                "amount": "000000000123",
                "symbol": "-"
            }
        ]
    },
    "MTI": ""
}

Check Operations

Authorization check

The message is necessary to receive information if the authorization was processed successfully or not. This call accomplishes the transaction. If the response is not OK or the response was not received the transaction should be reversed automatically by the cron job after 2 minutes.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
4 M N 12 The transaction amount.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
37 M AN 12 Retrieval reference number.
41 M ANS 8 Card acceptor terminal identification.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1120’.
method M A 18 POS host method. For this message the value in this parameter will be ‘authorize_ok_check’.
request_type M AS 10 The type of the POS operation. For this message the value in this parameter will be ‘auth_check’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version O N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "M488611218",
    "app_version": "1.2.9-mb",
    "data": "ekgjfdapkpojeoikV9ub1EV76VpFRYw0P22v2W7VBQODnKQX4UKYoNPxU8iHTS9hLx05oUgFpzlEfIYEtR5NsqRPBcdxlBzgGmC7QcAlt51hb7PjJeroj89I8dsHJ/EoV1hmAT3r7a9b1/c0w1oCeWhNoxtnyfSncCNjSboo7wAQZi6o+jo8SlrGYhpI1yegS8CwnWV0yAx+mxBO",
    "guid": "basewin_00001504100A0042302",
    "initial_guid": "f59fff15-bc51-4c6b-893b-741dff93e3e5",
    "pure_json": {
        "2": "5400000000000001",
        "4": "000000000100",
        "7": "20201231125326",
        "12": "20201231125326",
        "37": "036505000061",
        "41": "AAAAA",
        "MTI": "1140"
    },
    "method": "authorize_ok_check",
    "request_type": "auth_check",
    "serial_number": "00001504100A0042302",
    "sign": "7eJINZBWunGwzHDF2b5Y5pyUyR8SEMQzDvtA/6c+G9VwQVc8g1wN0KS4Kq5EzeQtNM/8LhBUYoF0PWI05drokHa3TAhO88kolXYbfinbDW5NsxwGcCjdPftK5Czwk+GRWSfhXhuQ5Le/GrKBPaR4eOGvAW5VLajPvv51uYRcxiDPExWS7v5GyG7gM3+1x+O3TahHE7lw0AjbhyDPe7uwIgAAEMDFbXJSNY2ku2bbLcQWFrQ4g4+xhp6LUPp1c0zKvsFgRiJ/qiRRBK0g7dIf0Dtf1VeL3vXREmGv1dZOs56L5WZoMK6cIqCVdyruuLwYeD0cbIlJBZsIWWCgfCQm5mzbNLrJ3vWiDlGSe8wxJxOciTfv5hRG/be5a19m90PMvqKf52pLZ5aXYxtN9ai7ee00NPE6uXoH3XoBCrpZ5cf4PMRWnKXdxRtTiqSJ57owmkm9WhFAIWLBChFbRrsyRklPqUTHCVeoMFTal7VE0LF7q/1DSe7rKwKnEKoKeqkI",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "fr0l5orb50gehlhnhqb9"
}

Response

Parameter M Type Max Length Description
status M LIST - Listed status of the response.
code M N 2 The code of the response.
message M AN - The description of the response code.
acquirer_error_code C N 3 The code of the error from the acquirer. The parameter will appear only in the error response.
terminal_id M AN 16 The unique identifier of the terminal.
{
    "status": {
        "code": "00",
        "message": "Auth OK"
    },
    "data": "ekgjfdapkpojeoikV9ub1EV76VpFRYw0P22v2W7VBQODnKQX4UKYoNPxU8iHTS9hLx05oUgFpzlEfIYEtR5NsqRPBcdxlBzgGmC7QcAlt51hb7PjJeroj89I8dsHJ/EoV1hmAT3r7a9b1/c0w1oCeWhNoxtnyfSncCNjSboo7wAQZi6o+jo8SlrGYhpI1yegS8CwnWV0yAx+mxBO",
    "sign": "7eJINZBWunGwzHDF2b5Y5pyUyR8SEMQzDvtA/6c+G9VwQVc8g1wN0KS4Kq5EzeQtNM/8LhBUYoF0PWI05drokHa3TAhO88kolXYbfinbDW5NsxwGcCjdPftK5Czwk+GRWSfhXhuQ5Le/GrKBPaR4eOGvAW5VLajPvv51uYRcxiDPExWS7v5GyG7gM3+1x+O3TahHE7lw0AjbhyDPe7uwIgAAEMDFbXJSNY2ku2bbLcQWFrQ4g4+xhp6LUPp1c0zKvsFgRiJ/qiRRBK0g7dIf0Dtf1VeL3vXREmGv1dZOs56L5WZoMK6cIqCVdyruuLwYeD0cbIlJBZsIWWCgfCQm5mzbNLrJ3vWiDlGSe8wxJxOciTfv5hRG/be5a19m90PMvqKf52pLZ5aXYxtN9ai7ee00NPE6uXoH3XoBCrpZ5cf4PMRWnKXdxRtTiqSJ57owmkm9WhFAIWLBChFbRrsyRklPqUTHCVeoMFTal7VE0LF7q/1DSe7rKwKnEKoKeqkI",
    "pure_json" :  {
      "37": "101003000015"
    },
    "terminal_id": "TRMNL1"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
37 M AN 12 Retrieval reference number (RRN).
{
    "37": "101003000015"
}

Bin check

POS sends the request before the transaction to get BIN information.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
2 M N 19 Primary account number (PAN).
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
41 M ANS 8 Card acceptor terminal identification.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘1120’.
method M A 15 POS host method. For this message the value in this parameter will be ‘bin_table_check’.
request_type M AS 20 The type of the POS operation. For this message the value in this parameter will be ‘bin_table’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config_version M N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "9100020015",
    "app_version": "1.2.0-dev",
    "data": "joogenplbfghehofJg1q+lQC5kgmOKt5iEjoopp7LCvwDjEpnOvK5EXhV13dHnRdlYPrM5lPgNC8NJ7RXp1OPtLp7zBz11PNt6Fpf29q5wvwg\/34Wcs5I005+nFv5MOMi9C1cJaMknZ492lE6saYYLMc4y1mj5kHV6fyew==",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "2": "5400000000000001",
        "7": "20201228093208",
        "12": "20201228093208",
        "41": "AAAAA",
        "MTI": "1120"
    },
    "method": "bin_table_check",
    "request_type": "bin_table",
    "serial_number": "00001504100A0042258",
    "sign": "pUqmSZ1rHPswFOxRfRaZ6RhxpQJIPEyubtCItTxbc7EcNsUlR4lO77xnWz\/j\/m07KCUSCA0mEdTy68IabyQkOx+4wWKPaBRAg3+Qoq4luAvQYMIouQRSZ7tPffVJcEv8LEXNU+jGUR2IpYdKPJWrScSJjIgan7Ji7ZplRL8xowkmTtHyPiCkc+X1XkhZ4H\/8O0bZGKONuMgHufwvuMiuy4YCIMzccj044mAlKZ+s\/hi1ouDw+j9pHGKXFmwF1vumNdWF52dmABhfVF0enu3McRxBCKajioI3VeCyVW0IMJYEg0AUDVJoVkexh2HLiOP36ZLwfPC2Beha53YR6egAheDkS111G1B4mcUPfXVE4W8JD6K4hlUAAgxCipppt7H\/qkhHbGe3TS6ohvWXR64qTMjVL5+quBC0BaJ1riY1MNEX9O8jIgWBeKBnbUG5lQjc+8TQ14kMMABJD5PzhSv83XFH4cQw2yFy25oaqGkNwUXV+3wvvGsCuL3GA6AEel6K",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
id M N 20 The identification number of the bin record.
bin M N 12 BIN number.
cardBrand M AN 20 The brand of the schema.
countryCode M A 3 ISO-3166-1 Alpha-3 country code.
countryName M A 64 The name of the country.
cardType M A 10 The type of the card.
dateUpdated M N 11 The date and time when the bin record was updated (Format: YYYYMMDDhhmmss).
dateUpdatedMicrotime M N 20 The microtime when the record was updated the last time.
{
    "id": 1,
    "bin": "455555",
    "cardBrand": "Visa",
    "countryCode": "USA",
    "countryName": "United States",
    "cardType": "Debit",
    "dateUpdated": "19700101000001",
    "dateUpdatedMicrotime": 1587709383674600
}

EMV keys check

Request is sent from POS by cron job to check and update EMV keys. Request contains current version of EMV keys. If version matches - host returns Response Code 'H35', if version is different - host packs all EMV keys in the 813 ISO field and sends them to POS

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
813 M OBJ 999 EMV Keys.
version M N 10 EMV Keys version.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘0001’.
method M A 15 POS host method. For this message the value in this parameter will be ‘emv_keys’.
request_type M AS 20 The type of the POS operation. For this message the value in this parameter will be ‘emv_keys’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
{
    "app_version": "1.2.0-dev",
    "data": "cP0H4mpJZ2xhzU5zeM2wMLAM5lrBkq0QgnsYtS4Q7\/noNQUDa04dui2amSr9qy8yknNC3ohtPmwTCymmnmuvfvg0tlqoo0P6afIL8KnYfYeWJwhsiZkdtdHZmCTAetjE2Z17tWGdA5eePpX0",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "7": "20201228093208",
        "12": "20201228093208",
        "813": {
            "version": 0
        },
        "MTI": "0001"
    },
    "method": "emv_keys",
    "request_type": "emv_keys",
    "serial_number": "00001504100A0042258",
    "sign": "sU98OnCBrw40yJsCk6Ase3pjojlHY1nD7dwyDheXWL58KBwb5s0blmgpnU2RhDR9bE11FQRDXwhKp5nrfXTjKGPaodmXwzo4s6cPhxn9VQXcc3S5rvxfvG98I5BShBYhnPGtyeXqC+Y677qNs9p14ETSlnO3I1j\/urZQ9bSjUHCGT+MaV6pXXC6PPSxipyKNFRweAO49bTp7IY\/LZpb4iUWOk7oz5LwKTWbUMimwThapE5yFsim77sHCkm+DpUUAu1Hm0RBbjjnnGGIfYq6HqHgTSsY83JutBV8tfIwG6KCGQOz+XTnWrTw7jZTGjTFPvtFZWdu85t7+5Mzc9sfd0gmAldt563T0BN5lKdHaUxrb4SCTt\/jn0XbkvWI8h9giif23zeGlAmETgVfmDAaUPkOIEoz3DzZiWSsOChdTi6OeMQbcha0utUIdCEIPzqDOEZgRXOzT4xeCjG\/X79EtAzokTPFOGn0mjVV0ggi\/2kwexa8q8g7FE4x\/njXcqIFS"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
7 M N 14 Transmission date and time (Format: YYYYMMDDhhmmss).
39 M AN 2 Scheme response code.
813 M OBJ 999 EMV Keys.
version M N 10 EMV Keys version.
aids M OBJ - AIDs.
contact M OBJ - Array of Contact AIDs.
9F06 M HEX 24 Name.
9F08 M HEX 4 Version number.
DF01 M HEX 2 App Select Identifier.
DF11 M HEX 10 TAC Default.
DF12 M HEX 10 TAC Online.
DF13 M HEX 10 TAC Denial.
DF14 M HEX 6 Default DDOL.
DF15 O HEX 16 Offset threshold selection.
DF16 O HEX 2 Max Target percent.
DF17 O HEX 2 Target percentage.
DF18 O HEX 2 Terminal online PIN support capability.
DF19 O HEX 12 Min offline limit for contactless readers.
DF20 O HEX 12 Contactless reader transaction limit.
DF21 O HEX 12 CVM Restrictions.
9F7B O HEX 12 EC Terminal Transaction Limit.
9F1B O HEX 12 Min terminal limit.
9F1D O HEX 16 Terminal risk management data.
9F33 O HEX 16 Capability.
9F40 O HEX 16 Extended Capability.
contactless M OBJ - Array of Contactless AIDs.
9F06 M HEX 24 Name.
9F08 M HEX 4 Version number.
DF01 M HEX 2 App Select Identifier.
DF11 M HEX 10 TAC Default.
DF12 M HEX 10 TAC Online.
DF13 M HEX 10 TAC Denial.
DF14 M HEX 6 Default DDOL.
DF15 O HEX 16 Offset threshold selection.
DF16 O HEX 2 Max Target percent.
DF17 O HEX 2 Target percentage.
DF18 O HEX 2 Terminal online PIN support capability.
DF19 O HEX 12 Min offline limit for contactless readers.
DF20 O HEX 12 Contactless reader transaction limit.
DF21 O HEX 12 CVM Restrictions.
9F7B O HEX 12 EC Terminal Transaction Limit.
9F1B O HEX 12 Min terminal limit.
9F1D O HEX 16 Terminal risk management data.
9F33 O HEX 16 Capability.
9F40 O HEX 16 Extended Capability.
rids M OBJ - Array of RIDs.
9F06 M HEX 24 RID list.
9F22 M HEX 2 RID Index.
DF02 M HEX 999 Modulus.
DF03 M HEX 48 SHA.
DF04 O HEX 2 Exponent.
DF05 O HEX 8 Expiration Date.
DF07 O HEX 4 Key Length.
{
    "7": "20210524073930",
    "39": "00",
    "813": {
        "version": 1621841963,
        "aids": {
            "contact": [
                {
                    "9F06": "A0000000043060",
                    "9F08": "0003",
                    "DF01": "00",
                    "DF11": "F45004800C",
                    "DF12": "F45004800C",
                    "DF13": "0000800000",
                    "DF14": "9F3770",
                    "DF15": "00000000",
                    "DF16": "01",
                    "DF17": "01",
                    "DF19": "000000000000",
                    "9F7B": "000000000000",
                    "9F1B": "00000000"
                }
            ],
            "contactless": [
                {
                    "9F06": "A0000000041010",
                    "9F08": "0002",
                    "DF01": "00",
                    "DF11": "F45004800C",
                    "DF12": "F45004800C",
                    "DF13": "0000800000",
                    "DF14": "9F3770",
                    "DF15": "00000000",
                    "DF16": "01",
                    "DF17": "01",
                    "DF18": "01",
                    "DF19": "000000000000",
                    "DF20": "999999999999",
                    "DF21": "000000010000",
                    "9F7B": "000000000000",
                    "9F1B": "00000000",
                    "9F1D": "647A800000000000"
                }
            ]
        },
        "rids": [
            {
                "9F06": "A000000004",
                "9F22": "04",
                "DF02": "A6DA428387A502D7DDFB7A74D3F412BE762627197B25435B7A81716A700157DDD06F7CC99D6CA28C2470527E2C03616B9C59217357C2674F583B3BA5C7DCF2838692D023E3562420B4615C439CA97C44DC9A249CFCE7B3BFB22F68228C3AF13329AA4A613CF8DD853502373D62E49AB256D2BC17120E54AEDCED6D96A4287ACC5C04677D4A5A320DB8BEE2F775E5FEC5",
                "DF03": "381A035DA58B482EE2AF75F4C3F2CA469BA4AA6C",
                "DF04": "03",
                "DF05": "20251231",
                "DF07": "1152"
            }
        ]
    }
}

Device information collection

Device sends information to host with current stats (location, battery level, versions, etc.)

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
41 M ANS 8 Card acceptor terminal identification.
812 M OBJ 999 Current device stats.
812 / battery_level M N 3 Current battery charge percentage (0-100.)
812 / imei M N 15 SIM identifier.
812 / internet_traffic M N 6 Network traffic in Mbit/s.
812 / system M OBJ 999 Device system information.
812 / system / firmware_version M ANS 64 System firmware version.
812 / system / software_version M ANS 64 System software version.
MTI M N 4 Message type identifier. For this message the value in this parameter will be ‘0001’.
method M A 15 POS host method. For this message the value in this parameter will be ‘emv_keys’.
request_type M AS 20 The type of the POS operation. For this message the value in this parameter will be ‘emv_keys’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "9100020015",
    "app_version": "1.2.0-dev",
    "data": "cP0H4mpJZ2xhzU5zeM2wMLAM5lrBkq0QgnsYtS4Q7\/noNQUDa04dui2amSr9qy8yknNC3ohtPmwTCymmnmuvfvg0tlqoo0P6afIL8KnYfYeWJwhsiZkdtdHZmCTAetjE2Z17tWGdA5eePpX0",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "MTI": "0001",
        "7": "20210712062555",
        "12": "20210712092555",
        "41": "RLMISAAD",
        "812": {
            "battery_level": "100",
            "imei": "865650030736397",
            "internet_traffic": "0",
            "system": {
                "firmware_version": "SP_V9.13.1256 PA00 200103 PEDSTA=2 ",
                "software_version": "V1.29.5318"
            }
        }
    },
    "method": "device_info",
    "request_type": "device_info",
    "serial_number": "00001504100A0042258",
    "sign": "sU98OnCBrw40yJsCk6Ase3pjojlHY1nD7dwyDheXWL58KBwb5s0blmgpnU2RhDR9bE11FQRDXwhKp5nrfXTjKGPaodmXwzo4s6cPhxn9VQXcc3S5rvxfvG98I5BShBYhnPGtyeXqC+Y677qNs9p14ETSlnO3I1j\/urZQ9bSjUHCGT+MaV6pXXC6PPSxipyKNFRweAO49bTp7IY\/LZpb4iUWOk7oz5LwKTWbUMimwThapE5yFsim77sHCkm+DpUUAu1Hm0RBbjjnnGGIfYq6HqHgTSsY83JutBV8tfIwG6KCGQOz+XTnWrTw7jZTGjTFPvtFZWdu85t7+5Mzc9sfd0gmAldt563T0BN5lKdHaUxrb4SCTt\/jn0XbkvWI8h9giif23zeGlAmETgVfmDAaUPkOIEoz3DzZiWSsOChdTi6OeMQbcha0utUIdCEIPzqDOEZgRXOzT4xeCjG\/X79EtAzokTPFOGn0mjVV0ggi\/2kwexa8q8g7FE4x\/njXcqIFS",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
7 M N 14 Transmission date and time (Format: YYYYMMDDhhmmss).
37 M AN 12 Retrieval reference number (RRN).
39 M AN 2 Scheme response code. |
{
    "MTI": "1810",
    "7": "20210712072555",
    "37": "119205000003",
    "39": "00"
}

Terminal user login

Checks terminal user credentials. Returns 00 status code on success or H38 when credentials are not correct.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
41 M ANS 8 Card acceptor terminal identification.
814 M OBJ 999 Terminal user credentials.
812 / type M ANS 16 Type of credentials. Currently only user_pin is supported.
812 / username M ANS 64 User username.
812 / pin M N 8 User PIN.
MTI M N 4 1800
method M A 15 terminal_login
request_type M AS 20 terminal_login
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "9100020015",
    "app_version": "1.2.0-dev",
    "data": "cP0H4mpJZ2xhzU5zeM2wMLAM5lrBkq0QgnsYtS4Q7\/noNQUDa04dui2amSr9qy8yknNC3ohtPmwTCymmnmuvfvg0tlqoo0P6afIL8KnYfYeWJwhsiZkdtdHZmCTAetjE2Z17tWGdA5eePpX0",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "MTI": "1800",
        "7": "20210712062555",
        "12": "20210712092555",
        "41": "TRMNL1",
        "814": {
            "type": "user_pin",
            "username": "POS User 1",
            "pin": "1234"
        }
    },
    "method": "device_info",
    "request_type": "device_info",
    "serial_number": "00001504100A0042258",
    "sign": "sU98OnCBrw40yJsCk6Ase3pjojlHY1nD7dwyDheXWL58KBwb5s0blmgpnU2RhDR9bE11FQRDXwhKp5nrfXTjKGPaodmXwzo4s6cPhxn9VQXcc3S5rvxfvG98I5BShBYhnPGtyeXqC+Y677qNs9p14ETSlnO3I1j\/urZQ9bSjUHCGT+MaV6pXXC6PPSxipyKNFRweAO49bTp7IY\/LZpb4iUWOk7oz5LwKTWbUMimwThapE5yFsim77sHCkm+DpUUAu1Hm0RBbjjnnGGIfYq6HqHgTSsY83JutBV8tfIwG6KCGQOz+XTnWrTw7jZTGjTFPvtFZWdu85t7+5Mzc9sfd0gmAldt563T0BN5lKdHaUxrb4SCTt\/jn0XbkvWI8h9giif23zeGlAmETgVfmDAaUPkOIEoz3DzZiWSsOChdTi6OeMQbcha0utUIdCEIPzqDOEZgRXOzT4xeCjG\/X79EtAzokTPFOGn0mjVV0ggi\/2kwexa8q8g7FE4x\/njXcqIFS",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
37 M AN 12 Retrieval reference number (RRN).
815 M OBJ Terminal user details.
815 / permissions M ANS[] List of permissions .
{
    "MTI": "1810",
    "37": "119205000003",
    "815": {
        "permissions": [
            "tx_sale",
            "tx_reversal"
        ]
    }
}

Config

Device

Device configuration request is used on the POS side in the following cases: the last step of the device registration process; and in the splash screen. Device configuration contains all device configuration, including list of available Terminals.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
app_version M ANS 64 The version number of the app.
data M ANS 3 JSON encrypted by AES-256-CBC with the key from the sign.
device_config_version M N 11 Unique device ID number from the core QR configuration.
guid M ANS 64 ISAAC unique ID from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID for the device.
pure_json M LIST - Listed ISO8583 data.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
MTI M N 4 Message type indicator. For this message the value in this parameter will be ‘1800’.
method M A 13 POS host method. For this message the value in this parameter will be ‘device_config’.
request _type M AS 13 The type of the POS operation. For this message the value in this parameter will be ‘device_config’.
serial_number M AN 50 The serial number of the POS device.
sign M ANS 999 RSA encrypted key used for secure data transmission.
{
    "app_version": "1.2.0-dev",
    "data": "bmbpdnafhlmadfghgsAHvUIxZErV\/ht9vlKB4Y6\/R4MFu0Wf4rYI4BHmDqoPA1fqJVwTf0HpqXTDKe2dIlpte8tBPmhmijkAkIux0A==",
    "device_config_version": "111111111",
    "guid": "basewin_0000111111111111111",
    "initial_guid": "11df1ceb-a1a1-1a1c-11e1-1bce1ab11a11",
    "pure_json": {
        "7": "20201228092015",
        "12": "20201228092015",
        "MTI": "1800"
    },
    "method": "device_config",
    "request_type": "device_config",
    "serial_number": "00001504100A0042258",
    "sign": "irDlLQVuXcpjyJtZcJb3XRh58DYY55C\/fEFeKSL06hwXV0QsxZ6OtqtZUaiDjLclhG+Z6hNRoqP5N61zYv58OClPMpr4a52+3nLZZoSq2Q7unenJokkn+xSsrKU65Mem2WaZCUl+95sqDzo4Rq9q2Wydip6ceEOS\/dhiD8R5JUwTaylDoYHxHzZvyfLGyR1P61ggEBS5o0HcPGhulXBXY\/kMEUpPxAtCGgZK34h5j48Ymqrxzh1XQ9tMajtjoXocURiMtw448W5dUGVjjmTzwjpJdJGbNpB3JWv09KlUVfQEmRZcv0r8XYULzYzm5ZLT6Gef+pqGuT1ZqQMP1jZC2WifBw6g4GTm+W2Q\/t61hiv97MaTCW0HIXn08scMFhrijNqULVjB2\/ZvpnvrXM5dLfVNzEZ9deAeNHi\/fOfaBM8Eq1OUKs8N5VVvroG4Tu+V5IcOC629mmcedswLlld8iW8xPihTky6gDL40F5V7PazRO66ju0skY0CIwWcxWU1A"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
device_config M OBJ - Device configuration version
url M ANS 255 Host URL for sending requests.
initial_guid M ANS 64 POS identifier in Host (Isac) system.
guid M ANS 64 POS identifier in Host.
multi_merchants M LIST - List of POS merchants with basic settings.
token M AN 64 Calculated token.
m_id M AN 15 Merchant ID.
t_id M AN 16 Terminal ID.
name M ANS 22 The name of the merchant.
active M AN 1 Merchant active flag. If the value is ‘1’ means that the device is active if ‘0’ it is not.
terminal_config_version M N 20 Terminal configuration version.
all_available _operations M AN 999 The list of the available operations for the device.
admin_pass M ANS 64 Administrator password.
manager_pass M ANS 64 Manager password.
app_version M ANS 3 The version number of the app (hardcoded 1.0).
device_config_version M N 11 Device configuration version number.
active M AN 1 Device active flag. If the value is ‘1’ means that the device is active if ‘0’ it is not.
device_public_key M ANS 999 Keys for encrypting/decrypting requests from the device.
device_private_key M ANS 999 Keys for encrypting/decrypting requests from the device.
{
    "device_config": {
        "url": "https:\/\/pos-host.tribepayments.com\/pos-json-raw",
        "initial_guid": "c4789f77-82a8-44cb-92d8-01658647426d",
        "guid": "basewin_0000150410PI0000114",
        "multi_merchants": [
            {
                "token": "89dwi1patf72bb2h3r64",
                "m_id": "AAA1111",
                "t_id": "AAA111",
                "name": "PosHost",
                "active": 1,
                "terminal_config_version": "1000000001"
            },
            {
                "token": "8fw3ENHNHkNO2+Bfln04uFFGnmszPWbnjrAVQ+12ZWJag63ciq7pySBCDjf9FuMM",
                "m_id": "AAA0000",
                "t_id": "AAA00000",
                "name": "PosHost1",
                "active": 1,
                "terminal_config_version": 1605777998
            }
        ],
        "all_available_operations": [
            "transaction_cash_back",
            "transaction_balance",
            "transaction_cash_advance",
            "transaction_pre_auth_completion",
            "transaction_pre_auth_increment",
            "transaction_installment",
            "transaction_payment_c2c",
            "transaction_payment_a2c",
            "transaction_payment_c2a",
            "transaction_pre_auth",
            "transaction_refund",
            "transaction_reversal",
            "transaction_sale"
        ],
        "admin_pass": null,
        "manager_pass": null,
        "app_version": "1.0",
        "device_config_version": 1610367748,
        "active": 1
    },
    "device_public_key": "-----BEGIN PUBLIC KEY-----\nMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAzzWomV3cicEni8bJ0iOo\nR<...>F4rrwdd\nRRuS\/JYoPgwbxxPGiJjgmk4z\/kLyxfpR4gPqwziyN778iUQEL0BnbyT6uRtbsMAN\nQrqkertaXwIVMxILqSmXA+3lidFrXU6TY1fJyWcMJiRfAgMBAAE=\n-----END PUBLIC KEY-----",
    "device_private_key": "-----BEGIN PRIVATE KEY-----\nMIIG\/wIBADANBgkqhkiG9w0BAQEFAASCBukwggblAgEAAoIBgQDPNa<...>\/dGZQcC4g==\n-----END PRIVATE KEY-----\n"
}

Terminal

Terminal configuration request is sent to the host before each transaction. Terminal config is necessary to collect terminal information including PIN encryption keys and list of the available operations.

Endpoint Method
https://<pos-host-url>/pos-json-raw POST

Request

Parameter M Type Max Length Description
api_id M AN 15 Terminal merchant ID.
app_version M ANS 64 The version number of the app.
data M ANS 999 JSON encrypted by AES-256-CBC with the key from the sign.
guid M ANS 64 Unique device ID number from the core QR configuration.
initial_guid M ANS 64 ISAAC unique ID from the core QR configuration.
pure_json M OBJ - Listed ISO8583 data.
7 M N 14 The date and time from the POS device in UTC (format: YYYYMMDDhhmmss).
12 M N 14 Local transaction time (format: YYYYMMDDhhmmss).
41 M ANS 8 Card acceptor terminal identification.
70 M N 3 Network management information code.
MTI M N 4 Message type indicator. For this message the value in this parameter will be ‘1800’.
method M A 15 POS host method. For this message the value in this parameter will be ‘terminal_config’.
request_type M AS 15 The type of the POS operation. For this message the value in this parameter will be ‘terminal_config’.
serial_number M AN 50 Device Unique Serial Number from POS.
sign M ANS 999 RSA encrypted key used for secure data transmission.
terminal_config _version O N 20 Terminal Config Version in Datetime variable.
terminal_id M ANS 16 Terminal ID for API.
token M AN 64 API token.
{
    "api_id": "9100020015",
    "app_version": "1.2.0-dev",
    "data": "iibklmdcbdhjjjfe9OlfeLkt6D1hi+iuzxl7gLHA9IrkXigF7gT7pYKEnOlOcKGNfyc6q5Wt1W8UXDt5zYRpoHSa\/THzP\/tGVSMqzwXcPQh7ZfI08KHQCVD97LaqryEp5PWO4qe9rQS\/NooA",
    "guid": "basewin_00001504100A0042258",
    "initial_guid": "14df3ceb-e6a8-4a1c-84e9-5bce9ab12a33",
    "pure_json": {
        "7": "20201228092515",
        "12": "20201228092515",
        "41": "AAAAA",
        "70": "003",
        "MTI": "1800"
    },
    "method": "terminal_config",
    "request_type": "terminal_config",
    "serial_number": "00001504100A0042258",
    "sign": "3slCSvi4Ww0eWuLfCMgPVPlY9in5ayynnaXEzhrfQK+urfiF0BJxZJqiKRAgx4bGU4tbhlHCLpKSDgWu1JtmO0IA6Usp09IWp6iI0Qj3QIuaNEQ74GEIFomjV\/ur2cQIVLgT3Nad9Axdv0+LlxFMvJ8u7wR8mG86+oGGCOHS9yJFgPNX2Xo9ageopr+XEoIpyvu7iMP2qTYnFVb7Od1pcoQ7DrH3x0etgkaHza\/a5rlFSmTT4zKEyIQnTX+SXcHNEcD0GZjhanlqpO47KFuHJ9fQp8xJ8RJrEPmdZ\/g3m2AGToXRA5j7vxltLziXFo\/XJsY4SPClqfU7kLjqKuphzaro2viGJxX3TYoiXKpUJeywQo0eDfc1DWC08PEoosOu86xz\/G+DfFcIMJHcP2IIhjgwa+RoJ89TS5hcSZCOxZcNL4jr+vbEvYLCFKkOPJnQjhz6KlmxSBsg5MqhnZ+USMptqQPn8Q969kWWY9Fu8mreDPqO2PWDDQXHDaXoXHes",
    "terminal_config_version": "1000000001",
    "terminal_id": "TRMNL1",
    "token": "89dwi1patf72bb2h3r64"
}

Decrypted ‘Data’ in the response

Parameter M Type Max Length Description
7 M N 14 Transmission date and time (Format: YYYYMMDDhhmmss).
18 M N 4 Merchant category code (MCC) or type.
22 M AN 12 Point of service entry mode. Point of Service (POS) entry mode. You can find the description of the parameter structure here.
39 M AN 2 Scheme response code.
43 M ANS 40 Card acceptor name/location. You can find the description of the parameter structure here.
49 M N 3 Currency code, transaction.
120 M OBJ - MAC under TMK.
120 / index M N 2 The index of the key.
120 / key M ANS 34 The key value.
121 M OBJ - TPK under TMK.
121 / index M N 2 The index of the key.
121 / key M ANS 34 The key value.
122 M OBJ - TEK under TMK.
122/ index M N 2 The index of the key.
122 / key M ANS 34 The key value.
125 M ANS 64 Merchant password.
127 M A 3 Country code.
124 M ANS 34 TMK under KLK.
805 M OBJ Terminal config data.
805 / currency_symbol M ANS 3 Currency symbol (e.g. \$, €).
805 / currency_code_alpha M AN 3 ISO-4217 currency code.
805 / available_operations M OBJ[] - Listed available operations.
805 / available_operations / type M ANS - The name of the operation.
805 / available_operations / limits M OBJ - The list of the limits for the particular available operation.
805 / available_operations / limits / amount M OBJ - The list of amounts for the particular available operation.
805 / available_operations / limits / amount / per_tx M N 17 The max amount per transaction.
805 / available_operations / limits / amount / daily M N 17 The max amount per day.
805 / available_operations / limits / amount / weekly M N 17 The max amount per week.
805 / available_operations / limits / amount / monthly M N 17 The max amount per month.
805 / available_operations / limits / count M OBJ - The list of the numbers of transactions for the particular available operation.
805 / available_operations / limits / count / daily M N 17 The max number of the operation per day.
805 / available_operations / limits / count / weekly M N 17 The max number of the operation per week.
805 / available_operations / limits / count / monthly M N 17 The max number of the operation per month.
805 / available_operations / limits / pin_floor_limits M OBJ - The list of the numbers of PIN enters during the particular available operation for the specific card brand.
805 / available_operations / limits / pin_floor_limits / MC M N 17 The numbers of PIN enters during the particular available operation using the Mastercard.
805 / available_operations / limits / pin_floor_limits / VISA M N 17 The numbers of PIN enters during the particular available operation using the Visa.
805 / available_operations / limits / pin_floor_limits / JCB M N 17 The numbers of PIN enters during the particular available operation using the JCB.
805 / available_operations / limits / pin_floor_limits / UPI M N 17 The numbers of PIN enters during the particular available operation using the UPI.
805 / available_operations / partial_approval_enabled C A 5 Not displayed under the Balance inquiry operation, PIN setup, PIN change operations. If true the partial approval will be turned on for the particular operation, if false will be turned off.
805 / available_operations / selected_account OBJ -
805 / available_operations / selected_account / from C AN 11 Needed for purchase from selected account (max value 10;20;30;40) default 00.
805 / available_operations / selected_account / to C AN 11 Needed for purchase from selected account (max value 10;20;30;40) default 00.
805 / available_operations / disable_manual_card_entry M A 5 If true the manual card entry will be turned off for the particular operation, If true the manual entry will be turned on.
805 / available_operations / disable_partial C A 5 Available only under the refund and under the reverse operations. When selected the partial reversal/refund will be disabled for the terminal. If true the partial refund/reversal will be turned off for the particular operation, if false will be turned on.
805 / available_operations / allow_card_read_bypass C A 1 0 or 1 allows bypassing card reading.
805 / available_operations / installment_limit_for_sale C N Installment limit for sale (for transaction_sale only.)
user_pass_mode M N 1 Terminal login mode. 0 - never; 1 - before every transaction; 2 - once per day.
terminal_users M OBJ[] List of available users.
terminal_users / username M ANS User username to be displayed in selection.
terminal_type M AN 2 Default value 21h we are using only 21 21h Attended Terminal(Online Only). 22h Attended Terminal(Offline with online capabilities). 23h offline only.
receipt M OBJ -
address M ANS 255 Address shown in the receipt.
website M ANS 255 The URL shown in the receipt.
phone M ANS 255 Phone number shown in the receipt.
additional_info1 M ANS 255 Additional info in the receipt.
additional_info2 M ANS 255 Additional info in the receipt.
m_logo_url M ANS 255 Full URL path of logo for the receipt.
MTI M N 4 Message type indicator.
{
    "7": "20210120070107",
    "39": "00",
    "18": "1332",
    "22": "M12345678901",
    "43": "Receipt Address          Receipt City GB",
    "49": "810",
    "120": {
        "index": 2,
        "key": null
    },
    "121": {
        "index": 1,
        "key": "XE687CFC950D84D650F85D2A244C9C328"
    },
    "122": {
        "index": 1,
        "key": null
    },
    "124": null,
    "125": null,
    "127": "031",
    "805": {
        "currency_symbol": "RUR",
        "currency_code_alpha": "RUR",
        "available_operations": [
            {
                "type": "transaction_refund",
                "limits": {
                    "amount": {
                        "per_tx": null,
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "count": {
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "pin_floor_limits": {
                        "MC": null,
                        "VISA": null,
                        "JCB": null,
                        "UPI": null
                    }
                },
                "partial_approval_enabled": false,
                "selected_account": {
                    "from": [],
                    "to": []
                },
                "disable_manual_card_entry": false,
                "disable_partial": false,
                "allow_card_read_bypass": false
            },
            {
                "type": "transaction_reversal",
                "limits": {
                    "amount": {
                        "per_tx": null,
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "count": {
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "pin_floor_limits": {
                        "MC": null,
                        "VISA": null,
                        "JCB": null,
                        "UPI": null
                    }
                },
                "partial_approval_enabled": false,
                "selected_account": {
                    "from": [],
                    "to": []
                },
                "disable_manual_card_entry": false,
                "disable_partial": false,
                "allow_card_read_bypass": true
            },
            {
                "type": "transaction_sale",
                "limits": {
                    "amount": {
                        "per_tx": null,
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "count": {
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "pin_floor_limits": {
                        "MC": null,
                        "VISA": null,
                        "JCB": null,
                        "UPI": null
                    }
                },
                "partial_approval_enabled": false,
                "selected_account": {
                    "from": [],
                    "to": [
                        "10",
                        "20"
                    ]
                },
                "disable_manual_card_entry": true
            },
            {
                "type": "transaction_statement",
                "limits": {
                    "amount": {
                        "per_tx": null,
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "count": {
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "pin_floor_limits": {
                        "MC": null,
                        "VISA": null,
                        "JCB": null,
                        "UPI": null
                    }
                },
                "partial_approval_enabled": false,
                "selected_account": {
                    "from": [],
                    "to": []
                },
                "disable_manual_card_entry": false
            },
            {
                "type": "transaction_payment_c2a",
                "limits": {
                    "amount": {
                        "per_tx": null,
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "count": {
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "pin_floor_limits": {
                        "MC": null,
                        "VISA": null,
                        "JCB": null,
                        "UPI": null
                    }
                },
                "partial_approval_enabled": false,
                "selected_account": {
                    "from": [],
                    "to": []
                },
                "disable_manual_card_entry": false,
                "fee_calculation_enabled": false
            },
            {
                "type": "transaction_payment_a2c",
                "limits": {
                    "amount": {
                        "per_tx": null,
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "count": {
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "pin_floor_limits": {
                        "MC": null,
                        "VISA": null,
                        "JCB": null,
                        "UPI": null
                    }
                },
                "partial_approval_enabled": false,
                "selected_account": {
                    "from": [],
                    "to": []
                },
                "disable_manual_card_entry": false,
                "fee_calculation_enabled": false
            },
            {
                "type": "transaction_payment_c2c",
                "limits": {
                    "amount": {
                        "per_tx": null,
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "count": {
                        "daily": null,
                        "weekly": null,
                        "monthly": null
                    },
                    "pin_floor_limits": {
                        "MC": null,
                        "VISA": null,
                        "JCB": null,
                        "UPI": null
                    }
                },
                "partial_approval_enabled": false,
                "selected_account": {
                    "from": [],
                    "to": []
                },
                "disable_manual_card_entry": false,
                "fee_calculation_enabled": false
            }
        ],
        "user_pass_mode": 2,
        "terminal_users": [
            {
                "username": "Cashier"
            },
            {
                "username": "Administrator"
            }
        ],
        "terminal_type": null,
        "receipt": {
            "address": null,
            "website": null,
            "phone": null,
            "additional_info1": null,
            "additional_info2": null
        },
        "m_logo_url": ""
    },
    "MTI": "1810"
}

Appendix

Changelog

Version Date Updates
1.0.0 February, 2021 Initial version.

Enum

Function code (24 parameter)

Code Description
100 The code which should be assigned for sale, balance, cash advance, cashback, instalment, statement, PIN setup, PIN change, eligibility check, and quasi cash operations.
101 The code should be assigned for the Pre-authorization operation request.
107 The code should be assigned for pre-authorization increment operation.
200 The code should be assigned for a cash deposit, A2C, C2A and C2C payment, fee calculation operations.
201 The code should be assigned for full refund operation.
202 The code should be assigned for a partial refund and pre-authorization completion operation.
400 The code should be assigned for full reversal operation.
401 The code should be assigned for partial reversal operation.

Message reason code (25 parameter)

Code Description
1503 The code should be assigned for sale, balance, cash advance, cash advance, cashback, statement, PIN setup, PIN change, A2C, C2A, C2C payment, fee calculation eligibility check, quasi cash operations.
1777 The code should be assigned for pre-authorization increment operation.
1806 The code should be assigned for preauthorization, pre-authorization completion operations.
1820 The code should be assigned for instalment operation.
2000 The code should be assigned for refund, cash deposit operations.
4000 The code should be assigned for reversal operation.

Response codes

Code Description
00 Successful approval/completion or that VIP PIN verification is valid, Transaction approved.
01 Refer to card issuer, Please call your issuer.
02 Refer to card issuer, special condition, Please call your issuer\n(Special condition.
03 Invalid merchant or service provider, Declined. Invalid Merchant or Service Provider.
04 Pickup, Pickup Card (Issuer\'s reason).
05 Do not honor, Declined. Please call your issuer.
06 General error, Declined. General error.
07 Pickup card, special condition (other than lost/stolen card), Pickup card. Issuer\'s decision\n(Special conditions).
08 Honor with identification, Transaction approved. Honor with ID.
10 Partial approval, Partially approved.
11 VIP approval.
12 Invalid Transaction, Declined. Invalid Transaction.
13 Invalid amount (currency conversion field overflow) or amount exceeds maximum for card program, Declined. Invalid amount.
14 Invalid account number (no such number), Declined. Invalid card number.
15 No such issuer, Decline. No such issuer.
17 Customer cancellation.
19 Re-enter Transaction, Decline. Please re-enter Transaction.
20 Invalid response.
21 No action taken (unable to back out prior transaction).
22 Suspected Malfunction.
25 Unable to locate record in file, or account number is missing from the inquiry.
28 File is temporarily unavailable.
30 Format error, Decline. Format error.
41 Merchant should retain card (card reported lost), Pick-up Card. Card is lost.
43 Merchant should retain card (card reported stolen), Pick-up Card. Card is stolen.
51 Insufficient funds, Decline. Insufficient funds.
52 No checking account, Decline. No checking account.
53 No savings account, Decline. No saving account.
54 Expired card, Decline. Expired card.
55 Incorrect PIN, Decline. Incorrect PIN.
57 Transaction not permitted to cardholder, Decline. Transaction not permitted to cardholder.
58 Transaction not allowed at terminal, Decline. Transaction not allowed at terminal.
59 Suspected fraud, Decline. Suspected fraud.
61 Activity amount limit exceeded, Decline. Amount limit exceeded.
62 Restricted card (for example, in country exclusion table), Decline. Restricted card.
63 Security violation, Decline. Security violation.
65 Activity count limit exceeded, Activity count limit exceeded.
68 Response received too late.
70 Contact Card Issuer, Please call to issuer.
71 PIN Not Changed, Decline. PIN is not changed.
75 Allowable number of PIN-entry tries exceeded, Decline. PIN-entry tries exceeded.
76 Unable to locate previous message (no match on retrieval reference number), Decline. P2P Transaction error.
77 Previous message located for a repeat or reversal, but repeat or reversal data are inconsistent with original message, Decline. P2P Transaction error.
78 Blocked, first used’—The Transaction is from a new cardholder, and the card has not been properly unblocked., Decline. Invalid/nonexistent account specified or card is blocked.
80 Visa transactions: credit issuer unavailable. Private label and check acceptance: Invalid date.
81 PIN cryptographic error found (error found by VIC security module during PIN decryption).
82 Negative CAM, dCVV, iCVV, or CVV results.
83 Unable to verify PIN.
85 No reason to decline a request for account number verification, address verification, CVV2 verification; or a credit voucher or merchandise return, No reason to decline a request for account number verification, address verification, CVV2 verification; or a credit voucher or merchandise return.
86 Can't verify PIN, Decline. Can't verify PIN.
91 Issuer unavailable or switch inoperative (STIP not applicable or available for this Transaction), Decline. Issuer unavailable or switch inoperative.
92 Destination cannot be found for routing, Decline by technical reason. Destination cannot be found for routing.
93 Transaction cannot be completed, violation of law, Decline. Transaction cannot be completed, violation of law.
94 Duplicate transmission, Decline. Duplicate Transaction.
96 System malfunction, System malfunction or certain field error conditions, Decline by technical reason. System malfunction.
1A Reset Terminal Config.
2A Reset Device Config.
A00 Already Success.
B1 Surcharge amount not permitted on Visa cards (U.S. acquirers only).
H1 Internal POST-HOST error, Technical error. Please call the acquirer.
H2 Json convert error, Technical error. Please call the acquirer.
H4 Bin request error - bin not found, BIN tables error. Please call the acquirer.
H5 Missing required Json field, Technical error. Please call the acquirer.
H6 ISO8583 validation error, Technical error. Please call the acquirer.
H7 Terminal not registered on host, Registration error. Please call the acquirer.
H8 Encryption keys not found, POS Host error. Please call the acquirer.
H9 Encryption message error, POS Host error. Please call the acquirer.
H10 Processor connection error.
H11 Processor Error. Please call the acquirer.
H12 Terminal Config Error, Technical error. Please call the acquirer.
H14 Failed finalize Transaction, reversing, Transaction reversed by technical reasons.
H15 Transaction not found.
H16 Transaction state not suitable for operation.
H17 Line Down Imitation.
H18 Terminal deactivated.
H19 Pos Not connected to Acquirer, Technical error. Wrong Acquirer settings.
H20 Failed to Log On to Acquirer.
H21 Operation is not supported by Host/Acquirer.
H22 Failed to reverse last transaction.
H24 Reverse must be done with the same card as the original transaction.
H25 Error retrieving terminal configuration from processor.
H26 Failed to load encryption key. It is either missing or corrupt.
H27 Failed to save encryption key.
H28 PAN is too short. Check input for errors.
H30 Schema error.
H31 Securebox error.
H32 Device not registered on this host.
H33 Installment not permitted for cardholder.
H34 Terminal configuration invalid or incomplete.
H35 Current version of EMV keys is used, no update required.
H37 Transaction capture failed.
H38 Invalid credentials.
MAC Calculate MAC value and submit again.
TRAFFIC_ENCRYPTION Encrypt request fields and submit again.
ADVICE_INSTALLMENT Confirm installment details with customer and submit again.
CALC_FEE Confirm transaction fees with customer and submit again.
N0 Force STOP.
N3 Cash service not available.
N4 Cashback request exceeds issuer limit.
N7 Decline for CVV2 failure.
P2 Invalid biller information.
P5 PIN change/unblock request declined.
P6 Unsafe PIN.
Q1 Card authentication failed.
R0 Stop payment order.
R1 Revocation of authorization order.
R3 Revocation of all authorizations order.
XA Forward to issuer.
XD Forward to issuer.
Z3 Unable to go online.

Scheme Response code (39 parameter)

Code Description
00 Approved or completed successfully.
01 Refer to card issuer.
02 Refer to card issuer, special condition.
03 Invalid merchant.
04 Capture card.
05 Do not honor.
06 Error.
07 Pick up card, special condition (fraud account).
08 Honor with ID.
0A Approval with load.
10 Partial approval.
11 Approved (V.I.P).
12 Invalid transaction.
13 Invalid amount.
14 Invalid card number.
15 Invalid issuer.
16 Approve update of track 3.
17 Customer cancellation.
19 Re-enter transaction.
1A Additional customer authentication required.
20 Update the QRC.
21 No action taken, unable to back out prior transaction.
22 Suspected malfunction, related transaction error.
25 Unable to locate original transaction.
26 Record already in active status.
27 Issuer File Update field edit error.
28 Record permanently deleted.
29 Delete request less than 540 days.
30 Format error.
32 Partial reversal.
33 Expired card - pick up.
34 Suspect Fraud.
38 PIN try limit exceeded.
39 No credit account.
40 Requested function not supported.
41 Lost card.
43 Stolen card.
45 Fallback transaction is not allowed.
51 Insufficient funds/over credit limit.
52 No cheque account.
53 No savings account.
54 Expired card.
55 Invalid PIN.
57 Transaction not permitted to issuer/cardholder.
58 Transaction not permitted to acquirer/terminal.
59 Suspected fraud.
61 Exceeds withdrawal amount limit.
62 Restricted card.
63 Security violation.
64 Transaction does not fulfil AML requirement.
65 Exceeds withdrawal count limit.
68 Response received too late.
70 Contact card issuer.
71 PIN not changed.
75 Allowable number of PIN tries exceeded.
76 Invalid/nonexistent To account specified.
77 Invalid/nonexistent From account specified.
78 Invalid/nonexistent account specified (general).
79 Key Exchange Validation failed / Transaction already reversed.
80 Visa transactions - credit issuer unavailable. Private label - invalid date.
81 Domestic debit transaction not allowed (regional use only).
82 Negative online CAM, dCVV, iCVV, or CVV result or offline PIN authentication interrupted.
84 Invalid authorization life cycle.
85 Not declined.
86 PIN validation not possible.
87 Purchase amount only, no cash back allowed.
88 Cryptographic failure.
89 Unacceptable PIN - transaction declined - retry.
90 Cutoff is in progress.
91 Authorization system or issuer system inoperative.
92 Unable to route transaction.
93 Transaction cannot be completed; Violation of law.
94 Duplicate transmission detected.
96 System error.
97 ATM/POS terminal number cannot be located.
98 Issuer response not received.
99 PIN Block Error.
N0 Force STIP.
N3 Cash service not available.
N4 Cashback request exceeds issuer limit.
N7 Decline for CVV2 failure.
P2 Invalid biller information.
P5 PIN change/unblock request declined.
P6 Unsafe PIN.
R0 Stop payment order.
R1 Revocation of authorization order.
R3 Revocation of all authorizations order.
Y1 Offline approval.
Z1 Offline decline.
Y3 Unable to go online, approval.
Z3 Unable to go online, declined.

Terminal permissions

Permission Name
tx_pre_auth_create Pre-Authorize Create
tx_pre_auth_increment Pre-Authorize Increment
tx_pre_auth_complete Pre-Authorize Complete
tx_cash_back Cash Back
tx_refund Refund
tx_reversal Reversal
tx_sale Sale
tx_payment_a2c P2P Account to Card
tx_payment_c2a P2P Card to Account
tx_payment_c2c P2P Card to Card
tx_payment Payment
tx_balance Balance Inquiry
tx_installment Installments
tx_cash_advance Cash Advance
tx_cash_deposit Cash Deposit
tx_hearts Hearts
tx_pin_setup PIN Setup
tx_pin_change PIN Change
tx_statement Statement
tx_cash_payment Cash Payment
tx_quasi_cash Quasi Cash
tx_eligibility_check Eligibility Check
history History
z_report Z Report
check_connection Connection Check
network_pin_key_change Network PIN Key Change
network_mac_key_change Network MAC Key Change
emv_keys EMV Key Check

The structure of the 22 parameter

Position Description Possible values
1 Card data input capability. Indicates the primary meaning of getting the information from the card to the terminal. 0 - unknown (not suggested); 1 - manual, no terminal (not applicable for POS); 2 - magnetic stripe ( no smart card read capability); 3 - bar code read (not suggested); 4 - OCR (Optical Character Recognition) coding reader (not suggested); 5 - smart card read (with or without magnetic stripe read capability); 6 - key entry only (no smart card read and no magnetic stripe read capability); A - contactless magnetic-stripe read. * Magnetic stripe read and key entry is also possible. M - contactless smart card read. * Smart card, magnetic stripe read and key entry also possible.
2 Cardholder authentication capability. Indicates the primary meaning of verifying the cardholder at the terminal. 0 - no electronic authentication (signature based transactions or no authentication at all); 1 - PIN verification possible (off-line and/or on-line); 2 - electronic signature analysis; 5 - electronic authentication inoperative (i.e. PIN pad damaged); 9 - unknown (not suggested).
3 Card capture capability. Indicates whether or not the terminal has the ability to capture a card. 0 - none; 1 - capture; 9 - unknown (not suggested).
4 Operating environment. Indicates if the terminal is attended by the card acceptor and its location. 0 - no terminal used (not applicable for POS); 1 - on premises of card acceptor, attended; 2 - on premises of card acceptor, unattended; 3 - off premises of card acceptor, attended; 4 - off premises of card acceptor, unattended; 5 - on premises of card holder, unattended; 6 - off premises of cardholder, unattended; 9 - unknown (not suggested); S - CAT (Cardholder Activated Terminal) level 1, unattended; T - CAT level 2, unattended; U - CAT level 3, unattended; V - CAT level 4, unattended; W - Electronic delivery of product (AmEx transactions’ transmission only); Y - Physical delivery of product (AmEx transactions’ transmission only); Z - Transit Access Terminal – TAT; M - Mobile acceptance solution (mPOS).
5 Cardholder present. Indicates if the card is present at the point of service. 0 - cardholder present; 1 - cardholder not present, unspecified; 2 - cardholder not present, mail order; 3 - cardholder not present, telephone; 4 - cardholder not present, stand-in authorization or recurring payment; 5* - cardholder not present, electronic order; 9 - unknown (not suggested).
6 Card present. 0 - card not present; 1 - card present; 9 - unknown (not suggested).
7 Card data input mode. Indicates method used to input the information from the card to the terminal. 0 - unspecified (not suggested); 1 - manual, no terminal (not applicable for POS); 2 - magnetic stripe read1; 3 - bar code read (not suggested); 4 - OCR coding read (not suggested); 5 - smart card read; 6 - key entered; 8 - magnetic stripe read in fallback to smart card read; 9 - full magnetic stripe read (preferable for POS terminals)2; A - contactless magnetic-stripe read; M - contactless smart card read; N - PayPass mapping service; R - PAN entry via electronic commerce, including remote chip; S - electronic commerce, SET without cardholder certificate (“merchant SET”); T - electronic commerce, SET with cardholder certificate (“full SET”); U - electronic commerce, no security (Non-initial recurring payment transaction without 3D); V - electronic commerce, channel encryption (e.g. SSL); W - PAN Auto Entry via Server.
8 Cardholder authentication method. Indicates the method for verifying the cardholder identity. 0 not authenticated; 1 - PIN verified on-line or off-line; 2 - electronic signature analysis; 5 - manual signature verification; 6 - other manual verification (e.g., drivers license photo and signature comparison); 9 - unknown (not suggested).
9 Cardholder authentication entity. Indicates the entity verifying the cardholder identity. 0- not authenticated (through telephone); 1 - smart card (off-line PIN verification using smart card data); 3 - authorization agent (e.g. performing on-line PIN verification); 4 - by merchant (e.g. performing signature comparison); 5 - other (e.g. non-smart card off-line PIN verification); 9 - unknown (not suggested).
10 Card data output capability. Indicates the ability of the terminal to update the card. 0 - unknown (not suggested); 1 - none; 2 - magnetic stripe write; 3 - smart card write.
11 Terminal output capability. Indicates the ability of the terminal to print/display messages. 0 - unknown (not suggested); 1 - none; 2 - printing; 3 - display; 4 - printing and display.
12 PIN capture capability. Indicates the length of PIN which the terminal is capable of capturing. 0 - no PIN capture capability; 1 - unknown (not suggested); 4 - four characters; 5 - five characters; 6 - six characters; 7 - seven characters; 8 - eight characters; 9 - nine characters; A - ten characters; B - eleven digits; C - twelve digits.

The structure of the 43 parameter

Position of the character Description
1-25 Card acceptor name or the location of ATM.
26-38 City name.
39-40 Country code.

Notation

Parameter requirement

Notation Description
C Conditional
M Mandatory
O Optional

Type

Notation Meaning
- Not applicable.
A Alphabetic chars only.
AN Alphanumeric value.
ANS Alphanumeric with symbols value.
AS Alphabetic with symbols value.
HEX HEX value.
LIST List of values.
N Only numbers.
NS Numeric with symbols value.
OBJ Object with properties.
OBJ[] Array of objects.
ANS[] Array of strings.