Terminal

A Terminal is a virtual POS device that allows a merchant or user to process card transactions through the EdfaPay SoftPOS system. Each terminal has unique identifiers provided by SAMA (Saudi Central Bank) and can be configured with specific payment methods and features.

Creating a Terminal(Single)

When creating a terminal, you may need to select the merchant or user (if you are setting it up on their behalf). If you are logged in as the merchant, the terminal will be added directly to your account.

Then enter the following details:

Field	Required	Description
Branch	Optional	Identifies the branch where the terminal will be used (if the merchant has multiple locations).
TSRM ID	Mandatory	A 6-digit identifier provided by SAMA (Saudi Central Bank). It is used to register and authenticate the terminal in the national payment network.
Terminal ID	Mandatory (16 digits)	A unique 16-digit identifier provided by SAMA (Saudi Central Bank). It is used to uniquely identify the merchant’s terminal during every transaction.

Bulk Import Terminals

Instead of adding terminals one by one, you can import multiple terminals at once by uploading a CSV/Excel file.

Steps:

Go to Terminal Options → Add Multiple Terminals → Download Template.
Open the template file and fill in the required details for each terminal:
- providerTid A numeric field that represents the provider’s terminal ID. Each entry should be unique and consist only of numbers.
- trsm A numeric field that represents the internal terminal identifier. This value is also unique and should be entered as numbers only.
Save the file and upload it back in the same section.
The system will validate the file and create all listed terminals in bulk.

🚧
Ensure that TSRM ID and Terminal ID match exactly what was provided by SAMA (Saudi Central Bank).

Payment Methods

You can enable or disable which Card Schemes the terminal will accept:

American Express
Visa
Mastercard
Maestro
Mada
UnionPay
Discover

Features

You can also control which transaction features are available for this terminal:

Purchase– Standard payment transaction.
Refund– Return of funds to the customer.
Reverse– Cancel a transaction before settlement.
Reconciliation– End-of-day balancing and reporting.