Getting Started

Get up and running with NamiPay terminal integration in under 15 minutes.

Step 1: Choose Your Platform

Step 2: Connect to Terminal

Ensure the Nami payment terminal is powered on and connected to the same network (TCP/IP) or paired (Bluetooth). Default TCP port: 8888.

Step 3: Register ECR

Send a Register request (txnType = 17) with your Cash Register Number.

Register Request:
  txnType: 17
  cashRegisterNumber: "ECR001"
  Expected: Success response confirming registration

Step 4: Start Session

Send a Start Session request (txnType = 18) to begin the transaction session.

Step 5: Perform a Purchase

Purchase Request:
  txnType: 0
  amount: "100" (SAR 1.00 - amount in halalas)
  ecrRefNo: "REF001"
  date: "130623193000" (ddMMyyHHmmss)

Step 6: Parse the Response

Use the SDK's parse function to extract the response code, approval code, and receipt data from the pipe-delimited response string.