Your merchant credentials from NABC. Format: CUST_NBR-MERCH_NBR-DBA_NBR-TERMINAL_NBR Find these in your North Developer account → User Profile → View Dashboard → Credentials.
epi-Id:???-???-???-???
Step 2 — EPI Key (HMAC Shared Secret)
Used to generate the epi-Signature header via HMAC-SHA256. Per the EPX spec: HMAC-SHA256(endpoint + JSON_payload, epiKey). Never expose this in client-side production code — route through your FastAPI backend at 35.88.253.122.
Step 3 — HTTP Request Headers (Auto-built per EPX spec)
content-type ......... application/jsonRequired
epi-Id ............. ???-???-???-??? ← enter credentials above
Per EPX spec: code === "00" = Approval. Any other code = Decline. Always use the code value, not the text — approval text varies. Reference is always returned. Only data OR errors is populated, never both.
Response Structure (EPX Spec)
{
"reference": "EPX123456", // Always returned"data": [
{
"code": "00", // "00" = Approval, anything else = Decline"text": "APPROVAL", // Text may vary — always use code to determine result"authCode": "ABC123", // Authorization code
...
}
],
"errors": null // Populated if any error — never both data + errors
}
TunaPOS Backend Proxy (Production)
Browser CORS prevents direct EPX calls from the frontend. In production, TunaPOS routes all payments through the FastAPI backend at 35.88.253.122:8035. The backend handles HMAC-SHA256 signing with the EPI Key server-side and forwards to EPX, then returns the response to the POS terminal. This keeps the EPI Key secure and off the client.
POSThttp://35.88.253.122:8035/api/payment/sale
POSThttp://35.88.253.122:8035/api/payment/void
POSThttp://35.88.253.122:8035/api/payment/refund
→ Backend signs with EPI Key → forwards to https://epi.epxuap.com
T
TunaPOS
Franchisee Portal — Secure Login
Email / Franchise ID
Password
Trouble signing in? Contact HQ Support
Demo Accounts
👤 Franchisee — Tuna Grill NYC Midtown→
👔 Manager — Tuna Grill Boston Harbor→
T
TunaPOS
FRANCHISEE PORTAL
FRANCHISEE
Tuna Grill — NYC Midtown
⚠ 1 HQ MESSAGE
--:--:--
MR
Maria Rodriguez
💰 Royalty — This Period
Reported to HQ · Auto-calculated
🔒
HQ Brand Standards Active
Core menu items are locked by Tuna Grill HQ. You can add local specials within approved categories. Pricing must stay within HQ-set min/max range.
Compliance Score
Overall Score
Updated hourly
91
Today at a Glance
Terminals Online
Quick Actions
Revenue Analytics
Transaction Log
Menu Rules from HQ
🔒 Core items cannot be removed
💲 Price range: HQ min/max enforced
✅ Local specials: max 8 items
📋 Changes require 24hr HQ review
Your Local Specials
Staff Management
Today's Schedule
Modal
Open Tabs
Bar tabs, table tabs, and house accounts
Transactions
Search, view, and manage transaction history.
Refunds
Full, partial, and item-level refunds with manager approval.
Voids
Void unpaid or same-day transactions with reason tracking.
Adjustments
Discounts, comps, price overrides, tax corrections, and tip corrections.
Audit Log
Tracks refunds, voids, no sales, overrides, discounts, and manager actions.
Chargebacks
Track disputes, evidence, pending responses, wins, and losses.
