Technical Reference
Payment Vault Service
Node payment vault service and Authorize.Net integration notes
The repo includes a payment-vault Node service for payment vault and Authorize.Net integration work. It contains server code, Authorize.Net adapters, webhook handling, idempotency storage, tests, and its own README.
Responsibilities
| Area | Responsibility |
|---|---|
| Vault interaction | Tokenize and manage saved customer payment methods. |
| Gateway calls | Execute gateway-specific payment operations through service adapters. |
| Webhooks | Accept and normalize processor events. |
| Idempotency | Prevent duplicate processing of retried gateway or webhook operations. |
| Tests | Validate gateway and service behavior with local test coverage. |
Salesforce Boundary
Salesforce owns customer, order, payment method, token, transaction, receipt, and settlement records. The service should not become an untracked source of truth for payment history.
Local Checks
Run package-specific tests from payment-vault when changing the service:
npm testUse the root payment architecture guard after Salesforce-side payment changes:
npm run architecture:payments:guardLast updated on