Skip to main content
The doTransaction method initiates and processes payment transactions within the TweezerComm protocol. It enables client applications, such as point-of-sale (POS) systems or electronic cash registers (ECRs), to interact with the Agamento payment terminal for secure transaction execution. This method supports multiple transaction types, including:
  • Regular Transactions: Standard payments using credit cards or closed-loop payment methods.
  • Refunds: Partial or full refunds of previous transactions.
  • Pre-Authorizations: Reserve a specified amount on a customer’s card for later confirmation.
  • Deferred Payments: Approving transactions even in cases where there is no immediate network connectivity.
  • MOTO (Mail Order/Telephone Order) Transactions: Processing card-not-present transactions securely.
  • Pre-Authorization Completion and Cancellation: Completing or voiding previously authorized transactions.
The sections below will describe the request parameters in more detail:

​
Request

JSON-RPC 2.0All methods in TweezerComm follow a JSON-RPC 2.0 structure. See Get Started for more details on how the requests are structured and sent.
In the request, ensure to configure the following:
  • The method field needs to be set to doTransaction.
  • The service must be set to ashrait in the params.
{
    "jsonrpc": "2.0",
    "method": "doTransaction",
    "params": [
        "ashrait",
        {
            "amount": 2000,
            "vuid": "1234567890",
            "currency": "376",
            "creditTerms": 1,
            "tranCode": 1,
            "tranType": 1,
            "cardNumber": "4580000000000000",
            "expDate": "2308",
            "cvv": "666"
        }
    ],
    "id": 1
}

​
Request Parameters

The table below describes the parameters of the request:
Mandatory Fieldsvuid, amount and tranType are mandatory for all requests. All others depend on the type of transaction made.
NameTypeDescription
vuidstringVendor (client) unique transaction identifier.
amountintegerAmount in cents.
tranCodeintegerThe transaction code. Below are the possible values for this parameter: 1: Single Step Transaction 2: Refund (Partial refund is supported) 3: Pre Authorization 4: Deferred 5: MOTO 6: Complete Pre Authorization 7: Cancel Pre Authorization
tranTypeintegerThe transaction type code. Below are the possible values for this parameter: 1 - Regular 3 - Forced Transaction 6 - Cash Back 7 - Cash 30 - Balance 53 - Refund
originalTransactionIdstringThe original transaction ID, this parameter is used when refunding a transaction.
panstringCard number (PAN) for MOTO transactions.
expstringCard expiration date.
cvvstringCard verification value (3 digits).
apmCodeintegerAdditional payment method (not EMV). Below are the possible values for this parameter: 2: Nayax Prepaid 4: 10BIS 5: Cibus 9: Multipass 28: Goodi
cardNumberstringThe card number is for the MOTO payment method (not EMV).
Mandatory for MOTO. Irrelevant for the rest of the payment methods
productInfostringSend product info to DCS.

​
Response

A successful request will return a response similar to the one in the code block below: 
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "statusCode": 0,
        "statusMessage": "TRANSACTION APPROVED",
        "appVersion": "01.05.22",
        "retailerId": "0883012013",
        "ecrNo": "1",
        "vuid": "ee5e7af5-7719-4726-992f-0eb2915b992a",
        "tranCode": 1,
        "currency": "376",
        "amount": 100,
        "mutag": 1,
        "mutagName": "Mastercard",
        "manpik": 2,
        "solek": 2,
        "cardNumber": "*********",
        "expDate": "2305",
        "cardName": "Mastercard",
        "tokenizedCardNumber": "c8ae19356dd1d7e946165fab67a14516",
        "tranType": 1,
        "posEntryMode": 5,
        "isClub": false,
        "isPrepaid": false,
        "creditTerms": 1,
        "uid": "23031212432508830123729",
        "rrn": "948767075   ",
        "authCodeManpik": 1,
        "issuerAuthNum": "0652073",
        "acquirerMerchantID": "6543505",
        "sysTraceNumber": "01001001",
        "merchantReceipt": [
            {
                "fieldName": "סכום",
                "fieldValue": "1000"
            },
            {
                "fieldName": "ATC",
                "fieldValue": "0289"
            }
        ],
        "customerReceipt": [
            {
                "fieldName": "סכום",
                "fieldValue": "1000"
            },
            {
                "fieldName": "ATC",
                "fieldValue": "0289"
            }
        ]
    }
}

​
Response Parameters

Below is a table with all the possible response parameters and their description:
NameTypeDescription
statusCodeintegerThe status of the operation. 0 indicates success.
statusMessagestringA message describing the status, such as “OK”.
mutagintegerThe card brand.
solekintegerThe acquirer.
manpikintegerThe card issuer.
uidstringThe transaction unique identifier.
posEntryModeintegerPOS Entry Mode, type of card transaction. Values include: 0 (MSR), 5 (CTLS MSR), 40 (Contact EMV), 50 (Phone), 51 (Signature only), 80 (Fallback (err)), and 81 (Fallback (no AID)).
cardNumberstringThe masked personal account number (PAN).
rrnstringTransaction authorization number from the authorized entity.
issuerAuthNumstringThe issuer authorization number.
acquirerMerchantIDstringThe merchant ID in the acquirer system.
authCodeManpikintegerCode of authorization. Values include: 0 (Unauthorized), 1 (Authorized by issuer), 2 (Declined by issuer), 3 (Stip approved), 4 (Stip declined), 5 (Voice approval), 6 (Voice declined), 7 (Approved pre-auth), 8 (Approved by card).
gatewayTokenstringThe gateway token for the card.
appVersionstringThe payment application version.
retailerIdstringThe terminal retailer ID.
ecrNostringThe POS identifier.
vuidstringThe vendor unique identifier.
tranCodestringThe transaction code.
merchantReceiptarray of key/valueThe merchant receipt data to print or save.
customerReceiptarray of key/valueThe customer receipt data to print.