[devsimze]

Summary

Adds four first-party merchant integrations that connect Stellar/fiat payments to the systems merchants already run:

• WooCommerce plugin (Implement WooCommerce plugin #954)
• Salesforce Billing integration (Add Salesforce Billing integration #955)
• Xero accounting integration (Build Xero accounting integration #956)
• QuickBooks Sync integration (Implement QuickBooks Sync integration #957)

Each follows the existing zapier/intercom module layout: a typed client, a service that owns business logic, an index.ts barrel, a thin Express router, and Vitest unit tests.

Details

WooCommerce (#954)

• REST API v3 client (HTTP Basic auth with consumer key/secret).
• HMAC-SHA256 webhook verification of X-WC-Webhook-Signature over the raw body.
• Maps orders to AgenticPay payment drafts and writes settlement status back (paid -> completed, etc.) plus an order note.

Salesforce Billing (#955)

• SOQL/sObjects REST client.
• Idempotent account/invoice/line/payment sync keyed by an external id field (External_Id__c by default).
• Defaults to the Salesforce Billing package objects, overridable per call.

Xero (#956)

• Tenant-scoped Accounting API client.
• Invoices matched by Reference (skipped when present); payments submitted with Xero idempotency keys.

QuickBooks Online (#957)

• Realm-scoped Accounting API client.
• Customers matched by DisplayName then email; invoices by DocNumber; payments created with QuickBooks requestid for idempotency.

Shared

• backend/src/integrations/accounting/types.ts holds the normalised invoice/payment schemas reused by Salesforce, Xero and QuickBooks.
• Routers mounted at /api/v1/integrations/{woocommerce,salesforce,xero,quickbooks} in backend/src/index.ts.
• WooCommerce webhook raw-body parser registered before the global JSON parser so signatures can be verified.
• ENV_VARS.md and a new docs/ACCOUNTING_INTEGRATIONS.md document configuration and API usage.

Testing

cd backend
npx vitest run src/integrations/woocommerce src/integrations/salesforce \
  src/integrations/xero src/integrations/quickbooks
# 42 passed (8 files)

• npx tsc --noEmit: no new errors (repo baseline unchanged).
• ESLint on new files: 0 errors.
• npm run test:docs: passes.
• Route test suite unchanged before/after (no regressions).

Notes

Each integration works end-to-end against the provider REST APIs and is unit-tested on both success and failure paths (invalid webhook signatures, missing invoices, provider API errors, idempotent re-syncs).

Closes #954
Closes #955
Closes #956
Closes #957

[vercel]

@Abidoyesimze is attempting to deploy a commit to the smartdevs17's projects Team on Vercel.

A member of the Team first needs to authorize it.

[drips-wave]

@devsimze Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits