Patientco API
Patientco is a patient financial engagement and payments platform used by health systems, hospitals, and provider groups to deliver consolidated statements, collect payments across channels, manage payment plans and financing, and analyze patient billing performance. With an unofficial API, you coul
What is Patientco?
Patientco provides patient-centric billing and payment capabilities tailored for healthcare. It helps providers present clear, consolidated statements, offer flexible payment options (including plans and financing), process payments securely, and communicate with patients via web, mobile, email, SMS, and paper. Patientco often integrates with EHRs and practice management systems (e.g., Epic, Cerner, athenahealth) for posting and reconciliation.
Core product areas include:
- Patient/Guarantor Accounts and balances
- Statement generation, delivery, and tracking
- Payment processing (card/ACH), refunds, and settlement
- Payment plans, autopay, and financing options
- Communications and reminders across channels
- Analytics and performance reporting for revenue cycle teams
Common data entities:
- Patients and Guarantors
- Accounts (linked to MRN/encounters) and balances
- Statements (periods, itemized charges, delivery status)
- Payments, refunds, and settlement batches
- Payment Methods (tokenized card/ACH) and receipts
- Payment Plans (terms, schedules, next draft dates)
- Facilities/Locations and service lines
- Communication events (email/SMS/paper delivery)
The Patientco Integration Challenge
Organizations rely on Patientco daily, but turning portal-based workflows into automated pipelines is hard:
- PCI and HIPAA compliance: Card data tokenization, PII handling, and audit requirements demand careful automation
- Strong enterprise security: SSO/MFA and network controls complicate headless access for bots and services
- Portal-first delivery: Statement lifecycle, communications, and posting often live in web apps rather than public APIs
- Batch timing and settlement windows: Nightly statement postings, payment settlement batches, and bank cutoffs must be respected
- Cross-system mapping: Accounts, guarantors, and encounters need consistent linkage between Patientco and your EHR/PM
- Refunds/voids edge cases: Reversals, partial refunds, and chargebacks require precise status handling and audit trails
How Supergood Creates Patientco 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 accounts, statements, payments, and plans so you can integrate once across facilities and merchant setups
- Aligns with customer entitlements and licensing constraints to ensure compliant access
- Bridges batch exports where applicable with signed URL retrieval and delivery (e.g., statement PDFs, settlement reports)
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your Patientco product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened Patientco adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Patientco 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.
Accounts
/accountsRetrieve patient/guarantor accounts with balances and linkage to your EHR/PM. Use this to drive statement retrieval, payment posting, and reconciliation.
Statements
/statementsRetrieve statements for an account with delivery status, due dates, and optional PDF links. Use this to power portals and outreach.
Payments
/paymentsCreate a payment against an account or a specific statement. Supports tokenized card/ACH and returns receipt artifacts for reconciliation.
Use Cases
EHR-to-Patient Billing Synchronization
- Push patient and guarantor demographics from your EHR/PM into Patientco - Maintain a single source of truth for account linkages (MRN, guarantor IDs, encounter references) - Continuously reconcile balances, payments, and settlement statuses
Statement Lifecycle Tracking
- Pull open statements with itemized charges and delivery status - Identify patients eligible for plan enrollment or financial assistance - Drive outreach via your CRM/engagement tools using Patientco delivery signals
Payment Processing and Reconciliation
- Post tokenized card/ACH payments programmatically and retrieve receipts - Track settlement batches and update your general ledger or PM - Manage refunds, voids, and chargebacks with clean audit histories
Payment Plan Orchestration
- Enroll patients in compliant payment plans with autopay - Surface remaining balance, installment schedules, and next draft dates in your portal - Automate plan adjustments or cancellations based on EHR/PM events
Communications and Reminders
- Trigger reminders for due dates, failed drafts, and new statements - Respect patient communication preferences and consent - Measure engagement and optimize channel strategy
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 accounts, statements, payments, and receipts
Security
Encrypted transport, scoped tokens, and audit logging; respects Patientco entitlements, HIPAA, and PCI requirements
Webhooks
Optional asynchronous delivery for statement updates, payment captures, and settlement changes
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume payment posting and statement retrieval
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 commonly used Patientco portal flows subject to your licensing and entitlements. We scope coverage (e.g., accounts/balances, statement retrieval, payment posting, refunds, settlement reporting, payment plan signals) during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth where enabled. Card/ACH data is handled via tokens only; we never store raw PAN/bank details and maintain audit trails aligned to PCI and HIPAA.
Yes. We return receipt artifacts, settlement batch IDs, and posting references so you can update your PM/EHR and general ledger. We can also fetch statement PDFs or batch exports for downstream archiving.