B12 Simulator - FoneTag

Connection Initialize() / DeInitialize()

Reset device on connect (RTS pulse, same as the C# library)

Expected firmware (optional, e.g. 1.0.3)

Heartbeat

Every 5 s, disconnect after 5 misses

Not connected.

Firmware OTA and MAC read go through esptool.exe in the C# library, so they aren't available here.

Payment RequestDeviceToStartAcceptingPayment()

Amount (NPR)

PRN / invoice ref (sent to your backend)

Dynamic QR string from Fonepay (the token the device shows as QR)

Amount sent as

No payment in progress.

Token from devicetype: —

Result to show on the device:

Verify with backend as soon as a token arrives Back to IDLE 5 s after showing a result

Device commands

Backend for Fonepay (production)

Your Fonepay merchant secret must stay on a server, so this page never calls Fonepay directly. It calls your own endpoints. A Frappe {"message": …} wrapper is unwrapped automatically. If the page is opened from a file or another host, the endpoints need CORS.

QR endpoint (POST)

Verify endpoint (POST)

Authorization header (optional)

Request and response shapes

QR endpoint
  request  {"amount": 10, "prn": "SIM-…"}
  response {"qr": "<dynamic QR string>"}   (qrMessage also accepted)

Verify endpoint
  request  {"amount": 10, "prn": "SIM-…", "token": "<payload.data>", "type": "<payload.type>"}
  response {"status": "PAYMENT_SUCCESS" | "PAYMENT_INITIATED" | "PAYMENT_FAILED",
            "message": "optional text"}

Any other status is treated as unknown. Nothing is shown on the device, and you pick the result by hand.

NiziPOS Simulator

Connection Initialize() / DeInitialize()

Payment RequestDeviceToStartAcceptingPayment()

Device commands

Virtual device acts like the NiziPOS firmware

Serial monitor 115200 baud, newline-terminated