Skip to content

Create MASAV Banking charge

posthttps://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

MASAV Banking Clearing System API

Execute a banking standing order charge through the MASAV clearing system.

Key Points:

  • MASAV transactions can only be performed in ILS (Israeli Shekel)
  • Credit or cancellation must be done directly with the bank after broadcast to MASAV
  • Installment transactions are not supported
  • Additional free fields (customer name, email, etc.) can be added like in credit card transactions
  • Broadcast schedules to MASAV (daily, weekly, or monthly) must be configured in your terminal settings at my.tranzila under Settings > transmit

Example Request:

Text
https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&sum=1&currency=1&bank=10&branch=123&account=11111&tranmode=T

Request

Body

application/x-www-form-urlencoded
supplierstringrequired

Terminal name

Example:myterminalname
sumstringrequired

Amount to charge

Example:10
currencystringrequired

Currency code - MASAV charges are only in ILS (use value 1)

Allowed value:1
Example:1
tranmodestringrequired

Transaction mode - must be 'T' for MASAV

Allowed value:T
Example:T
bankstringrequired

Bank code (2 digits)

Match pattern:^\d{2}$
Example:10
branchstringrequired

Branch code (3 digits)

Match pattern:^\d{3}$
Example:326
accountstringrequired

Bank account number (5-7 digits)

Match pattern:^\d{5,7}$
Example:123456
TranzilaPWstring

Password for Tranzila services (required only if token system is activated and transaction password is set)

response_return_formatstring

Response format - 'json' or 'qstr'

Allowed values:jsonqstr
Example:json

Responses

MASAV transaction response (success or application-level error)

Response Codes

The Response field in the JSON response indicates the transaction status:

  • 000 = Success
  • 701 = Invalid Bank Code
  • 702 = Invalid Branch Code
  • 703 = Invalid Account Number
  • 704 = Invalid Bank/Branch/Account Combination

Error Codes

701 - Invalid Bank Code

Description: The bank code provided doesn't exist in our system.

Details: In Israel, payment system participants are identified using a unique identification code for each entity (previously known as a "bank code").

Valid Israeli Bank Codes:

Bank NameCode
Bank Leumi10
Israel Discount Bank11
Bank Hapoalim12
Bank Otsar Ha-Hayal14
Mizrahi Tefahot Bank20
Union Bank26
First International Bank31
Bank Massad46
Bank of Jerusalem54

Resolution: Verify the bank code against the current list from the Bank of Israel.

702 - Invalid Branch Code

Description: The branch code provided is not valid for the specified bank.

Details: Branch codes are specific to each bank and must exist within that bank's branch network.

Resolution: Verify the branch code exists for the specified bank.

703 - Invalid Account Number

Description: The account number format is incorrect or invalid.

Details: Account numbers must conform to the specific format requirements for the given bank.

Resolution: Check the account number format requirements for the specified bank.

704 - Invalid Bank/Branch/Account Combination

Description: The combination of bank code, branch code, and account number is invalid.

Details: While individual components may be valid, they don't form a valid combination (e.g., branch doesn't belong to the specified bank, or account doesn't exist in the specified branch).

Resolution: Validate that the bank, branch, and account combination is correct and exists in the banking system.

Response body

response.json
JSON
1{
2  "DBFsolek": "",
3  "DBFIsForeign": "",
4  "DBFcardtype": "",
5  "DBFcard": "",
6  "currency": "1",
7  "cardtype": "",
8  "Responsesource": "",
9  "ConfirmationCode": "",
10  "supplier": "myterminalname",
11  "sum": "10",
12  "Tempref": "",
13  "Responseid": "",
14  "account": "123456",
15  "cred_type_shva": "",
16  "Response": "000",
17  "branch": "326",
18  "tz_parent": "myterminalname",
19  "bank": "10",
20  "index": "97587",
21  "cardaquirer": "",
22  "Responsecvv": "",
23  "DclickTK": "",
24  "cardissuer": "",
25  "tranmode": "T",
26  "response_return_format": "json"
27}
28
Was this page helpful?