Payanywhere API
Payanywhere is an all-in-one payments platform that gives business owners free software, hardware, and low-rate card processing across in-store, mobile, and online channels, managed through the Payments Hub merchant portal. An unofficial API lets you programmatically pull transactions, deposits, customers, employees, inventory, and invoices—and push updates like new invoices, payments, and inventory changes back into Payanywhere and Payments Hub.
What is Payanywhere?
Payanywhere is an all-in-one payments platform that provides business owners with free software, hardware, and low-rate card processing. It accepts payments in-store, on mobile via Bluetooth readers and Tap to Pay on iPhone, and online through invoices and a virtual terminal, with merchants managing transactions, reporting, customers, employees, inventory, and deposits through the Payments Hub portal. Payanywhere operates as a registered DBA of EPX and a registered ISO of multiple banks, and its processing connects through the North / Payments Hub developer platform.
Core product areas include:
- In-store card acceptance across Smart Terminal, Flex, POS+, Keypad, and PINPad Pro hardware (EMV chip, contactless tap, magstripe, PIN debit, EBT)
- Mobile payments via smartphone or tablet with the 3-in-1 Bluetooth reader and Tap to Pay on iPhone
- Online payments through one-time and recurring invoices and a virtual terminal for phone and online orders
- Payments Hub merchant portal for transaction management, real-time sales reporting, and deposit visibility
- Inventory management, customer management, and employee management with access controls
- Developer Hub with payment APIs and Android SDKs for embedding card-present and ecommerce payments
Common data entities:
- Merchants, Accounts, Locations, App Sources
- Transactions, Sales, Pre-Authorizations, Refunds, Authorization Codes
- Deposits, Batches, Payouts, Settlement Records
- Invoices (one-time and recurring), Customers, Tokenized Cards
- Inventory Items, Employees, Receipts
The Payanywhere Integration Challenge
Merchants run real-money workflows on Payanywhere and Payments Hub every day, but turning portal- and app-driven data into reliable API-driven automation is non-trivial:
- App-source gating: API access requires a unique x-nabwss-appsource identifier provisioned from the Payments Hub API Access page, so headless automation must be set up per merchant account
- Semi-integrated cloud model: Card-present sales and pre-auths are pushed to the mobile app and paired terminal, so transaction state is split across cloud, app, and hardware
- JWT session handling: A two-step auth (app-source then Bearer JWT) means tokens must be refreshed and replayed correctly to keep automation alive
- Portal-only reporting: Much of the deposit, inventory, customer, and employee data lives in the Payments Hub UI rather than a single public reporting API
- US-only geolocation restrictions: The semi-integrated API enforces geolocation, complicating server-side and CI-based integration
- Platform consolidation: Payanywhere processing now flows through the North / Payments Hub developer platform, so endpoints, hosts, and SDKs shift as the brands converge
How Supergood Creates Payanywhere APIs
Supergood reverse-engineers authenticated Payments Hub portal flows and the Payanywhere developer API to deliver a resilient, normalized API layer for your merchant account—across in-store, mobile, and online channels.
- Handles the two-step app-source plus Bearer JWT authentication and refreshes sessions automatically
- Maintains session continuity with automated token refresh and change detection across Payanywhere and Payments Hub surfaces
- Normalizes responses across transactions, deposits, invoices, customers, inventory, and employees so you integrate once and rely on consistent objects
- Aligns with merchant-specific app sources and entitlements to ensure compliant, account-scoped access
Use Payanywhere with AI agents: Payanywhere MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your Payanywhere account, Payments Hub access, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Payanywhere adapter tailored to your merchant account, channels, and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Payanywhere and Payments Hub evolve.
API Endpoints
Authentication
/authenticateAuthenticate to a Payanywhere merchant account using the app-source identifier and credentials, returning a Bearer JWT for downstream calls.
Transactions
/transactionsList sales, pre-authorizations, and refunds with filters for date range, amount, status, and channel.
Transactions
/create_paymentSubmit a card-present or card-not-present payment, optionally returning a tokenized card for future transactions.
Deposits
/depositsRetrieve deposits, batches, and settlement records with funding date and status filters.
Invoices
/invoicesPull one-time and recurring invoices with customer, status, and due-date filters.
Invoices
/create_invoiceCreate a one-time or recurring invoice for a customer and send it for payment.
Inventory
/inventory_itemsList inventory items with pricing, SKU, and stock-level details for catalog and reporting sync.
Use Cases
Sync transactions and deposits into accounting
- Pull sales, refunds, and pre-authorizations from Payanywhere into your ledger and reporting warehouse - Reconcile deposits, batches, and settlement records against bank funding - Stream transaction events to BI, fraud, and customer-experience tools
Automate invoicing and recurring billing
- Create one-time and recurring invoices from your CRM or billing system without portal clicks - Pull invoice status and payments back to keep AR in sync - Trigger dunning and receipt workflows on paid or overdue invoices
Keep inventory and customer data in sync
- Push and pull inventory items, pricing, and stock levels between Payments Hub and your catalog - Sync customer records and tokenized cards across systems - Surface low-stock and top-customer signals to downstream tools
Unify multi-channel payments reporting
- Consolidate in-store, mobile, and online sales into a single normalized feed - Attribute revenue by employee, location, and device for operational reporting - Feed real-time sales and deposit data into dashboards and finance tools
Technical Specifications
Authentication
Two-step app-source (x-nabwss-appsource) plus Bearer JWT handled in a managed session
Connectivity
Authenticated Payments Hub portal flows plus the Payanywhere / North semi-integrated cloud API where exposed
Response format
Normalized JSON across transactions, deposits, invoices, customers, inventory, and employees
Rate limits
Adaptive throttling tuned to your merchant account to avoid platform-side limits
Session management
Automatic JWT refresh, token replay handling, and credential rotation
Data freshness
Near real-time pulls for transactions and deposits with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, PCI-aware handling, and audit logging
Webhooks
Event-style callbacks for new sales, refunds, deposit funding, and invoice payment
Latency
Sub-second reads on cached entities; multi-second writes when posting payments and invoices
Throughput
Horizontally scaled workers sized to in-store, mobile, and online transaction volume
Reliability
Retry, backoff, and idempotency keys for payments, refunds, and invoice creation
Adaptation
Continuous monitoring of Payanywhere and Payments Hub releases and platform consolidation under North
Frequently asked questions
Yes. Supergood normalizes transactions across Payanywhere's in-store terminals, mobile Bluetooth readers and Tap to Pay, and online invoices and virtual terminal, so all channels surface through one consistent API.
Supergood works with your existing Payanywhere and Payments Hub credentials and provisions the required app-source access against your merchant account, so you don't have to build the two-step JWT flow yourself.
Yes. Deposits, batches, and settlement records are exposed through the same normalized API surface alongside individual sales and refunds for full reconciliation.
Payanywhere processing now flows through the North / Payments Hub developer platform. Supergood monitors these endpoints and adapts the adapter automatically as hosts, SDKs, and brands converge.
Yes. Inventory items, customers, tokenized cards, and employee records managed in Payments Hub are exposed through the API so you can sync catalog and CRM data alongside payments.