QuickBooks V3 PHP SDK

The QuickBooks V3 PHP SDK is Intuit’s official PHP client for the QuickBooks Online v3 REST API. It provides a DataService abstraction over the API so PHP applications can create, read, update, delete, and query accounting entities such as invoices, customers, vendors, items, and payments without hand-rolling HTTP requests or XML/JSON serialization.

The SDK bundles OAuth 2.0 authentication, request/response interceptors, retry logic, batch operations, reporting, and webhook verification. It maps the QuickBooks data model to PHP facade classes and handles the platform’s serialization formats, letting developers focus on their integration logic rather than transport and marshaling details.

What You Get

• A DataService client for CRUD and query operations across QuickBooks Online entities
• Built-in OAuth 2.0 authentication and token handling for the Intuit platform
• PHP facade classes mapping the QuickBooks data model (invoices, customers, items, payments)
• Batch operations, reporting service, and webhook verification support
• Request/response interceptors, retry logic, and diagnostic logging

Common Use Cases

• Syncing invoices and payments between an app and a customer’s QuickBooks Online company
• Creating and updating customer and vendor records from an external system
• Pulling profit-and-loss or other financial reports programmatically
• Receiving and verifying QuickBooks webhooks to react to accounting changes

Under The Hood

Architecture - The SDK is layered around DataService (src/DataService), which coordinates Core request handling, Interceptors for signing and serialization, and a Retry module for resilience. Data and Facades model QuickBooks entities, XSD/XSD2PHP generate PHP classes from the QuickBooks schema, QueryFilter builds queries, and ReportService and WebhooksService cover reporting and event verification. Security handles OAuth token management, while PlatformService covers company-level operations.

Tech Stack - PHP client distributed as quickbooks/v3-php-sdk under Apache-2.0, published on Packagist. It targets the QuickBooks Online v3 REST API, supports both XML and JSON serialization via generated XSD-to-PHP classes, and uses PHPUnit for its test suite with a bootstrap.php autoloader.

Code Quality - The codebase is broad, reflecting the full QuickBooks entity surface, with generated data classes kept separate from hand-written services. Interceptor, retry, and diagnostics layers show attention to production concerns; a test directory accompanies the source, though much of the model layer is machine-generated from the platform schema.

API Design - The DataService-centric API keeps common CRUD ergonomic (Add, Update, Delete, FindById, Query), and entity facades hide serialization. Initial setup carries some boilerplate around OAuth configuration and the config file, and the schema-driven entity classes make the surface large, but Intuit’s hosted documentation and CRUD samples ease onboarding.