Make sure your iPad is charged, updated to a recent iPadOS version, and signed in to the correct Apple ID.
Connect to a reliable Wi‑Fi network you’ll use in-store. Avoid guest networks that block device‑to‑device traffic.
If taking cards, place the terminal near the iPad and on the same network/VLAN.
If printing receipts, load paper and note the printer’s IP address (usually printed on a self‑test page).
Have your business details handy (store name, address, phone, GST/VAT number) for the receipt header/footer.
Tip: Plan a $0.10 test sale to confirm terminal prompts, printing, and that it appears in History.
Getting started
Install AttoPOS from the App Store and launch the app. Open Settings(gear).
In Settings > Business, set your store name, address, and receipt header/footer.
Create your products: go to Settings > Products, add a few common items, and set prices/tax.
Tip: for quick testing, tap Load demo products in Settings > Products. You can remove them later or keep and edit for your own purposes.
Choose your Payment method(s) in Settings > Payment and pair your card terminal if using cards.
(Optional) Enable Printing and enter your receipt printer IP address, then tap Print Test Receipt.
Return to the main screen and make a small test sale (e.g., $0.10). Check it appears in History.
Payments
Open Settings > Payment. You can enable Card and Cash — they’re not mutually exclusive.
Choose your terminal type:
VCloud (NZ only): Tap Pair terminal and follow the on‑screen prompts on the terminal and iPad. When paired, the top status will show Ready.
Verifone PSDK (LAN - AU or NZ): Make sure the iPad and terminal are on the same network. Enter the terminal’s IP address (e.g. 192.168.1.50) and save.
Test mode: Use this to simulate approvals/declines during training without a terminal.
None: Use this to manually approve/decline without needing an integrated terminal.
Tip: Make a small test sale (e.g. $0.10) after pairing to confirm you see prompts on the terminal and the app returns to Ready.
Status not updating? Close Settings to return to the main screen; the app re‑initializes payment services and refreshes terminal status.
If pairing fails: power‑cycle the terminal, ensure it’s connected to the correct Wi‑Fi/VLAN, then try Pair terminal again.
Declines & retries: If a card is declined, AttoPOS shows a declined status. You can retry the same transaction; all attempts are logged under the same transaction ID in History.
Receipts: After a card payment, view or reprint the receipt from Receipts or from the transaction in History.
Still stuck? See Troubleshooting below for pairing, network, and printing checks.
Printing
In Settings > Printing, toggle Enable printing, enter your receipt printer’s IP address, then tap Print Test Receipt.
Network: Your iPad and printer must be on the same network/VLAN. ESC/POS printers usually listen on TCP 9100 (raw printing). Firewalls should allow outbound to that port.
Paper size: AttoPOS formats for standard 58 mm and 80 mm thermal printers. Use high‑quality thermal paper to improve legibility.
Kitchen printing: Enable it if you need a kitchen chit. You can reuse the main printer’s IP, or set a separate Kitchen printer IP for a second device.
ESC/POS printers (examples & setup):
Common models: Epson TM‑T20/TM‑T88 series, many ESC/POS‑compatible 58/80 mm printers. Other brands include Bixolon, HPRT, Custom, Sewoo.
Find the printer IP: Power off, then hold Feed while powering on to print a self‑test/Network report; the IP address is printed. Some brands, pressing the feed button three times will print network settings.
Static IP is best: Set a static IP in the printer’s web page (or a DHCP reservation in your router) so the address doesn’t change.
Cabling: For Ethernet printers, plug into the same switch/router as the iPad’s Wi‑Fi network. For Wi‑Fi models, join the same SSID/VLAN as the iPad.
Tip: If the test receipt doesn’t print — check paper roll and orientation, close the cover firmly, confirm the printer LEDs are normal (no error), ping the printer IP from another device, then try Print Test Receipt again.
Receipts
After each sale, AttoPOS generates Customer and Merchant receipts.
To view a past receipt: open History, choose a transaction, then tap View receipt or Reprint.
Printing options:
Thermal receipt via your ESC/POS printer configured in Settings > Printing.
System print from the receipt preview to any AirPrint‑capable printer set up on the iPad.
From the receipt preview, you can use the iOS share sheet (where available) to save or share a copy.
Customize the header/footer (store name, address, notes) in Settings > Business.
Tip: If a receipt looks truncated or too narrow, check your printer’s paper width (58 vs 80 mm) and margins on your AirPrint printer, then reprint.
Transaction history & reports
Open History to browse past transactions. Tap any entry to see details, the receipt, and refund options (where applicable).
Filters:
Date: Today, Last 7 days, This month, or a custom date range.
Method: Card or Cash.
Status: Completed, Declined, or Refunded.
Receipts: View or reprint the associated receipt directly from the transaction.
Multiple attempts: If a card payment is retried after a decline, all attempts are grouped under the same transaction ID for clear history.
Export: From the History screen, export your current results to CSV (for Numbers/Excel) or JSON for analysis.
Settings & security
Open Settings > Security to configure your PINs and other protections.
PINs: Use a User PIN for daily use and an Admin PIN to protect Settings and sensitive actions. Only trusted staff should know the Admin PIN.
Payment options: You can enable Card and Cash — they’re not mutually exclusive. Turn either on/off in Settings > Payment.
Data & backups: Transaction data is stored on‑device. Regularly export from History for safekeeping. Your iPad backups (iCloud/Computer) can include app data.
Best practices:
Use a non‑trivial Admin PIN and change it when staff change.
Limit who can access Settings; keep the Admin PIN separate from User PINs.
Label Station IDs clearly (e.g., “Front Counter”, “Window”, “Barista”).
Review Settings after any network/printer/terminal change.
Tip: If you forget the Admin PIN, contact support@attopos.app for ownership verification and reset guidance.
Troubleshooting
Network checklist
iPad, terminal, and printer on the same SSID/VLAN.
Terminal/printer have valid IP addresses (note them for support).
ESC/POS printer port 9100/tcp open; outbound allowed from the iPad.
For VCloud (web) payments, ensure general Internet access and no captive portal.
Temporarily disable VPN/Private Relay during pairing if connections fail.
Terminal not pairing: power‑cycle the terminal, confirm same network, then try Pair terminal again in Payments.
Printer not found: print the self‑test to read the IP, set a static IP (or DHCP reservation), then use Print Test Receipt in Printing.
Receipts not showing: open History and view the last transaction’s receipt to confirm it saved correctly.
Make sure your iPad is charged, updated to a recent iPadOS version, and signed in to the correct Apple ID.
Connect to a reliable Wi‑Fi network you’ll use in-store. Avoid guest networks that block device‑to‑device traffic.
If taking cards, place the terminal near the iPad and on the same network/VLAN.
If printing receipts, load paper and note the printer’s IP address (usually printed on a self‑test page).
Have your business details handy (store name, address, phone, GST/VAT number) for the receipt header/footer.
Tip: Plan a $0.10 test sale to confirm terminal prompts, printing, and that it appears in History.
Install AttoPOS from the App Store and launch the app. Open Settings (gear).
Create your products: go to Settings > Products, add a few common items, and set prices/tax.
Return to the main screen and make a small test sale (e.g., $0.10). Check it appears in History.
Status not updating? Close Settings to return to the main screen; the app re‑initializes payment services and refreshes terminal status.
If pairing fails: power‑cycle the terminal, ensure it’s connected to the correct Wi‑Fi/VLAN, then try Pair terminal again.
Declines & retries: If a card is declined, AttoPOS shows a declined status. You can retry the same transaction; all attempts are logged under the same transaction ID in History.
Receipts: After a card payment, view or reprint the receipt from Receipts or from the transaction in History.
Still stuck? See Troubleshooting below for pairing, network, and printing checks.
Kitchen printing: Enable it if you need a kitchen chit. You can reuse the main printer’s IP, or set a separate Kitchen printer IP for a second device.
ESC/POS printers (examples & setup):
From the receipt preview, you can use the iOS share sheet (where available) to save or share a copy.
Filters:
Multiple attempts: If a card payment is retried after a decline, all attempts are grouped under the same transaction ID for clear history.
Export: From the History screen, export your current results to CSV (for Numbers/Excel) or JSON for analysis.
PINs: Use a User PIN for daily use and an Admin PIN to protect Settings and sensitive actions. Only trusted staff should know the Admin PIN.
Payment options: You can enable Card and Cash — they’re not mutually exclusive. Turn either on/off in Settings > Payment.
Data & backups: Transaction data is stored on‑device. Regularly export from History for safekeeping. Your iPad backups (iCloud/Computer) can include app data.
Best practices:
Network checklist
Terminal/printer have valid IP addresses (note them for support).
ESC/POS printer port 
For VCloud (web) payments, ensure general Internet access and no captive portal.
Temporarily disable VPN/Private Relay during pairing if connections fail.