Academy / Week 4 / Forms & Payments Implementation / Payment Write-backs & Bulk Collections — Technical Overview

Payment Write-backs & Bulk Collections — Technical Overview

Lesson 15.2⏱ ~8 minWeek 4

💡 Why This Matters

Payment write-backs and bulk collections are the two primary payment features Weave provides. Understanding both at a technical level — including how capabilities are added to standard.json — is your entry point into Payments integration work.

🎯 What You'll Learn

  • The two payment integration features: payment write-back and bulk collection
  • Payment write-back: a payment made in Weave → reflected in the patient's PMS ledger
  • How to enable payment write-back: add a 'payment_type' capability to standard.json for the integration
  • Bulk collection: syncing accounts with outstanding balances for the Weave collections tab
  • How the PXE team (Payments Experience team) uses bulk collection data
  • The standard.json capability model and how it gates feature availability per integration

Watch Video

Open in Google Drive 💡 Open in Drive for AI-powered transcript search

📋 Lesson Summary

Two payment features exist at the integration level. Payment write-back: when a patient pays in Weave, that payment is written to their account in the PMS ledger. Enabling it requires adding a 'payment_type' capability entry to the integration's standard.json file. Bulk collection: syncing the list of patients with outstanding balances (aging data) into Weave so offices can send bulk payment request messages. The PXE team (Payments Experience) consumes bulk collection data to populate the collections tab. Capabilities in standard.json act as feature flags — if the capability isn't listed, the feature isn't available for that integration.

🏷 Key Concepts

Payment Write-backBulk Collectionstandard.jsonPayment Type CapabilityPMS LedgerPXE TeamCollections TabCapability Flag Model

Key Takeaways

01Two steps to enable payment write-back: add capability to standard.json + implement the write-back RPC in SyncApp
02standard.json is the capability manifest — it gates which features are available for each PMS integration
03Bulk collection and payment write-back are independent features — an integration can support one without the other
04The PXE team depends on your bulk collection data to power the collections tab — data quality matters
05Always check standard.json when investigating why a payment feature isn't working for a specific integration