Skip to content
SoundSyncAudio software platform

API reference

External Order Fulfillment

Report approved partner sales with scoped products and stable transaction references.

Choose the supported partner path

Reseller relationships, product assignments and reporting are separate from custom order fulfillment. Custom Partner API credentials, external-order submission, manual license issue, serial allocation and fulfillment webhooks require activation by SoundSync. These custom fulfillment operations are not currently enabled by default.

An approved WooCommerce connection has its own authorization, mapping and activation checks. Native affiliate and collaborator programs are separate again; the custom fulfillment setting does not switch those programs off. Historical records remain subject to their normal account permissions. Contact SoundSync before planning a custom fulfillment integration.

Use the approved relationship

Authenticate with the partner Bearer key and the permitted sales:write or orders:write scope. Report the external order and its relevant product lines using the contract in the partner API reference. Assignments and serial/entitlement policy decide what can be fulfilled.

The /sales and /orders surfaces share the fulfillment service. A new operation returns 201; an idempotent replay or recognized duplicate returns 200. These are not two separate sales to report for the same purchase.

Reconcile outcomes

Save the returned SoundSync order/line references, allocated delivery, and safe error codes. Keep the same idempotency key for an unchanged retry. A WooCommerce mixed cart must not fulfill unrelated store items or silently approve an unmapped candidate.

External fulfillment does not automatically put the reseller transaction under SoundSync Merchant of Record coverage.

Handle fulfillment availability before retrying

Custom fulfillment can return 410 PARTNER_FULFILLMENT_DISABLED before any order or license is issued. Do not retry with a new external order ID to bypass this response. Confirm activation with SoundSync, keep a stable Idempotency-Key and use the environment and relationship assigned to the integration. Read-only access and approved WooCommerce fulfillment follow their separate contracts.