# DPD

> DPD (Digital Product Delivery, getdpd.com) sells digital downloads, physical goods and subscriptions for creators. These docs cover putting a DPD store's products and cart on any website with the <dpd-*> embed components (dpd.js), the classic buy button embed codes, and the read-only DPD REST API.

Key facts for agents:

- Embed components: load `<script src="https://STORE.dpdcart.com/dpd.js" defer></script>` (STORE is the store's subdomain), then use `<dpd-product product="ID">`, `<dpd-add-to-cart product="ID">`, `<dpd-cart>`, `<dpd-cart-button>` and `<dpd-checkout-button>`. Product IDs come from the DPD admin. The page's domain must be the store's website or listed under Settings > Checkout > Embed domains, or the components show "This store's cart isn't available on this website."
- Style the components with `--dpd-*` CSS custom properties and `::part()`; the page's other CSS doesn't reach inside their shadow roots.
- REST API: base URL `https://api.getdpd.com/v2`, HTTP Basic auth with the DPD username and the API password from the profile page. It's read-only apart from reactivating a purchase. Empty lists and missing records answer 404 `{"status":"NOTFOUND"}`. Lists page with `page` (100 per page); count up until a 404.
- The full API description is OpenAPI 3.1 at https://docs.getdpd.com/openapi.yaml. Use it for endpoints, parameters and response fields.
- Never put the API password in browser code; call the API from a server.

## Documentation Sets

- [Abridged documentation](https://docs.getdpd.com/llms-small.txt): a compact version of the documentation for DPD, with non-essential content removed
- [Complete documentation](https://docs.getdpd.com/llms-full.txt): the full documentation for DPD
- [Embed components](https://docs.getdpd.com/_llms-txt/embed-components.txt): The <dpd-*> elements, styling, embed domains and events
- [Classic buy buttons](https://docs.getdpd.com/_llms-txt/classic-buy-buttons.txt): Cart links, buttons, widgets and the lightbox
- [REST API guide](https://docs.getdpd.com/_llms-txt/rest-api-guide.txt): Authentication, pages, dates, errors and notification verification

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [OpenAPI description](https://docs.getdpd.com/openapi.yaml): The DPD REST API as OpenAPI 3.1: every endpoint, parameter and response field
- [Cast & Crumb demo shop](https://castandcrumb.com): A complete site built with the embed components, styled with custom properties and ::part()