Deprecated
The Account Pairing API and its guides are deprecated and may be removed in a future release. Contact your Otter representative for migration options.
Partial store onboarding
Accept store upsert webhooks and finish pairing manually in Otter Developer Portal when you cannot register the external id immediately via API.
Before you begin
- Same webhook setup as Onboard a store
Steps
- (Optional) Implement Fetch Store Credentials (
stores.fetch_credentials) for custom credential schemas. - When Otter adds a store, Upsert Store (
stores.upsert) fires — return 2xx to acknowledge. - Mark the store as waiting for manual onboarding in your systems if helpful.
- An operator completes onboarding in Otter Developer Portal by supplying the external store id.

Verify
Acknowledge a test upsert; confirm the store appears in Otter Developer Portal and can be completed manually.
Next
- Onboard a store — fully automated path
- Stores & account pairing overview