InstaMed API
InstaMed is a healthcare payments platform used by providers, payers, and patients to send and pay bills, manage payment methods and plans, process card/ACH transactions, and reconcile insurance remittances and deposits. With an unofficial API, you could initiate and capture patien
What is InstaMed?
InstaMed (a J.P. Morgan company) provides a secure healthcare payment network used by providers, payers, and consumers to streamline patient billing and collections, process payments online and at point-of-care, manage payment methods and plans, and reconcile insurance remittances and deposits. InstaMed connects to PM/EHR systems, portals, and clearinghouse channels to consolidate payment acceptance and settlement reporting.
Core product areas include:
- Patient billing and statements (online bill pay, eStatement delivery)
- Payment acceptance (card-present and card-not-present; ACH/eCheck)
- Stored payment methods and payment plans
- Claims clearinghouse and ERA (835) remittance retrieval for reconciliation
- Deposit reporting and settlement summaries
- Refunds, adjustments, and chargeback management
Common data entities:
- Patients/Guarantors
- Statements/Invoices and balances
- Transactions (card/ACH, authorization, capture, settlement)
- Payment Methods (vaulted tokens, card, ACH)
- Payment Plans (terms, installments, next due)
- Remittances (ERA/835, payer, check, claim lines, adjustments)
- Deposits/Settlement batches
- Providers/Merchants and locations/terminals
The InstaMed Integration Challenge
Organizations rely on InstaMed daily, but turning portal-based payment and reconciliation workflows into automated pipelines is hard:
- PCI + HIPAA requirements: Strict controls around card data, ACH credentials, and PHI complicate headless automation
- Strong enterprise security: SSO/MFA and network policies introduce session management complexity
- Portal-first delivery: Statements, transactions, and ERA artifacts often live in web apps or batch exports rather than unified public APIs
- Settlement timing: Batching windows, file availability (ERA, deposit reports), and cutoffs must be respected
- Posting logic: Mapping statements and transactions back to PM/EHR requires consistent identifiers and reconciliation rules
How Supergood Creates InstaMed APIs
Supergood reverse-engineers authenticated browser flows, batch interfaces, and network interactions to deliver a resilient API endpoint layer.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes payment, statement, remittance, and deposit objects so you can integrate once across provider locations
- Aligns with customer entitlements and licensing constraints to ensure compliant access
- Bridges batch exports and SFTP/EDI flows with signed URL retrieval and delivery for ERA/835 and deposit reports
- Respects PCI principles: No storage of raw PAN/ACH data in your environment; tokenization and encryption via controlled flows
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your InstaMed product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened InstaMed adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as InstaMed evolves.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
Patient Statements
/statementsRetrieve patient statements with balances, due dates, and line items. Use this to power billing views and to validate payment posting.
Payments
/paymentsCreate a patient payment (card or ACH) against a statement/invoice. Supports immediate capture and receipt delivery.
Remittances (ERA/835)
/remittancesRetrieve ERA remittance summaries and detail lines for payer payments. Use this for reconciliation and posting back to claims.
Use Cases
Patient Billing Automation
- Pull statements and balances from InstaMed - Offer embedded checkout (card/ACH) and post payments back to your PM/EHR - Send receipts and update payment preferences
Point-of-Service Collections
- Surface outstanding balances at check-in - Capture card-not-present payments with stored tokens or ACH authorizations - Keep front-desk workflows synchronized with settlement statuses
Payment Plan Management
- Identify patients eligible for plans and display terms - Track installments, next due dates, and failed payments - Automate reminders and post-plan payments to ledgers
ERA and Deposit Reconciliation
- Retrieve ERA (835) files for payer payments - Match remittance lines to claims and patient responsibility - Tie deposits and settlement batches to transaction-level records
Refund and Adjustment Workflows
- Initiate partial or full refunds against transactions - Track reversal statuses and update patient balance/ledger - Monitor disputes and chargebacks alongside transaction history
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
Response format
JSON with consistent resource schemas and pagination
Rate limits
Tuned for enterprise throughput while honoring licensing and usage controls
Session management
Automatic reauth and cookie/session rotation with health checks
Data freshness
Near real-time retrieval of statements, transactions, ERA, and deposit artifacts
Security
Encrypted transport, scoped tokens, and audit logging; respects InstaMed entitlements, PCI obligations, and HIPAA safeguards
Webhooks
Optional asynchronous delivery for payment captured/refunded, ERA availability, and deposit postings
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume patient payments and reconciliation pipelines
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions
Adaptation
Continuous monitoring for UI/API changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across commonly used InstaMed provider portals and payment reporting tools, subject to your licensing and entitlements. We scope coverage (e.g., statements and balances, payments, ERA/835 retrieval, deposit summaries) during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. For batch flows, we manage SFTP/EDI timing windows, retrieve ERA/835 and deposit reports, and provide signed URLs or artifacts programmatically. We adhere to PCI principles—tokenizing card data and avoiding storage of raw PAN/ACH details.
Yes. You can fetch ERA detail and deposit summaries, map remittance lines to claims and patient responsibility, and tie settlements to transaction-level records to achieve end-to-end reconciliation.