master-zapier-plan-draft/packages/zappier-account-balance
George Lambert 345aeeead9
Some checks are pending
offline / test (push) Waiting to run
Bind each customer to a Verae userId for hop tracing
Signup registers/binds a Verae central user and stores veraeUserId. Public access stays the zappier API key. Chain JWTs stay server-side behind tokenRef. Authz, billing, and jobs.watch carry veraeUserId.
2026-09-11 16:18:06 -04:00
..
src Bind each customer to a Verae userId for hop tracing 2026-09-11 16:18:06 -04:00
test Bind each customer to a Verae userId for hop tracing 2026-09-11 16:18:06 -04:00
NATS.md Add NATS account-balance SoT and statement review for customers, CS, and sales 2026-09-11 15:35:37 -04:00
package-lock.json Add NATS account-balance SoT and statement review for customers, CS, and sales 2026-09-11 15:35:37 -04:00
package.json Add NATS account-balance SoT and statement review for customers, CS, and sales 2026-09-11 15:35:37 -04:00
README.md Add NATS account-balance SoT and statement review for customers, CS, and sales 2026-09-11 15:35:37 -04:00

zappier-account-balance

Source of truth for customer prepaid balances. Internal traffic is NATS request-reply; HTTP is health plus a fallback.

Forgejo: https://git.georgelambert.org/marchon/zappier-account-balance
Catalog: https://zapier.georgelambert.org/packages/zappier-account-balance/README.pdf

Zapier cloud never connects here. zappier-edge, customer-service, sales-pricing, and accounting-export do.

Subjects

Subject Kind Who
verae.billing.statement.get request-reply portal, CS, sales, admin
verae.billing.balance.get request-reply anyone internal
verae.billing.balance.adjust request-reply CS credits, portal reload
verae.billing.usage.recorded pub zappier-edge meter
verae.billing.payment.recorded pub portal reload, invoice paid
verae.billing.credit.applied pub CS

Queue group: account-balance.

Run

NATS_URL=nats://127.0.0.1:4222 PORT=3010 npm start
curl http://127.0.0.1:3010/health
curl http://127.0.0.1:3010/statement/cust_1

Statement JSON: { customerId, prepaidCents, credits[], usage[], payments[] }.