OnBuy Integration Setup

📋Before You Start

• Active OnBuy seller account (onbuy.com/sell)
• OnBuy API key generated in your seller dashboard

🔧Setup Steps

1. 1
   Generate your OnBuy API Key

   Log into your OnBuy Seller Dashboard. Navigate to Settings → API → Generate API Key. Give the key a name ("Pythias Integration") and select Orders: Read/Write permission. Click Generate. Copy the API key.
2. 2
   Enter credentials in Pythias

   In Pythias, go to Admin → Integrations → Add New Integration → OnBuy. Enter your API Key. Click Test Connection. If successful, click Save.
3. 3
   Configure shipping settings

   OnBuy requires sellers to use tracked shipping services. In the integration settings, configure your default carrier for UK orders (Royal Mail, DPD UK, Hermes, DHL UK). Pythias will include the carrier name and tracking number in the shipment confirmation.

🔄What Gets Synced

• ✓New orders (polled every 10 minutes)
• ✓Order items, OnBuy product IDs, quantities, and buyer shipping address
• ✓Shipment tracking confirmation pushed to OnBuy
• ✓Order fulfillment status update

💡Tips & Troubleshooting

• ⚡OnBuy charges a commission fee per sale. Ensure your pricing accounts for this before listing.
• ⚡OnBuy's API uses GBP for all pricing — confirm your pricing is in the correct currency.
• ⚡If your API key is rotated, update it in Pythias immediately to avoid order sync interruption.