Overview
This section is the technical reference for the Native API integration introduced in Migrate to Native API Integration. If your store hasn’t migrated yet, start there — this page assumes you’re already on the Native API mode.
In Native API mode, Bolt pulls cart, pricing, shipping, tax, and discount data — and creates orders — by calling Magento’s REST API directly, instead of running that logic inside the Bolt for Adobe Commerce plugin. The plugin still ships the storefront UI (Bolt buttons, checkout modal, admin) and exposes a small set of helper endpoints under /V1/bolt/boltpay/... for operations Magento REST cannot perform directly.
Use this section when you need to understand which calls Bolt makes against your Magento store, how Bolt authenticates, and which endpoints are exposed by the plugin (versus standard Magento REST).
This is a reference for merchant engineering and ops teams. Day-to-day setup is covered in the setup guide and operations guide.
What’s in This Section
How the Pieces Fit Together
| Layer | What it does | Reference |
|---|---|---|
| Bolt JS on storefront | Renders the Bolt button, opens the Checkout modal, collects payment + shipping. | Setup guide |
| Bolt backend → Magento REST | Reads cart, validates discounts, gets shipping options, computes tax, places the order. | Request flow |
| Bolt M2 plugin (custom REST) | Exposes a small set of /V1/bolt/boltpay/... endpoints for operations Magento REST cannot perform directly. |
Custom endpoints |
| OAuth authentication | Every Bolt → Magento call carries a Bearer token issued during plugin setup. | Authentication |
| Webhooks (Bolt → plugin) | Authorization, capture, refund, and void events drive Magento invoice/credit memo creation. | Webhooks |
Related Reading
- Migrate to Native API Integration — overview, benefits, and migration path. Read this first if you haven’t migrated yet.
- How Bolt Interacts with Your Platform — protocol-agnostic overview of the Bolt API + Merchant Callback model.
- Adobe Commerce Operations — order statuses, refunds, phone orders.
- Webhooks — webhook setup, signature verification, failure handling.