Shopware Setup

The Shopware integration is planned as a store plugin flow. Until the plugin is finalized, use this page as the conceptual setup model for agency outreach and implementation planning.

Planned setup flow

1. Create a Manatee account.
2. Get a testnet API key.
3. Install or connect the Shopware plugin when available.
4. Configure testnet mode first.
5. Set the webhook endpoint and signing secret.
6. Create a test order.
7. Confirm that the store updates after payment.confirmed.
8. Switch to mainnet only after the test flow works.

Planned payment flow

1. Customer selects Bitcoin at checkout.
2. The plugin creates a Manatee payment for the Shopware order.
3. The checkout displays the returned Bitcoin address, amount, and expiry time.
4. Manatee sends signed webhook events as payment state changes.
5. The plugin verifies the signature and updates the order.

Status mapping

Use the same payment status model documented in Status Model:

• pending
• detected
• confirmed
• expired
• cancelled

Store-facing labels such as "waiting for payment", "confirming", "underpaid", or "overpaid" should be mapped by the plugin or store integration.

Security requirements

A Shopware plugin should:

• Keep API keys server-side.
• Verify webhook signatures using the raw request body.
• Store processed X-Manatee-Event-Id values.
• Use testnet before mainnet.
• Avoid collecting wallet seed phrases or private keys.

For webhook details, see Webhooks and Security.