---
title: "Custom platform configuration guide"
canonical: "https://ingrid-support.refined.site/space/KB/410091531/Custom%20platform%20configuration%20guide"
format: markdown
---
The Custom Platform Integration configuration guide explains how to connect a proprietary or unsupported e-commerce platform to Ingrid Returns using Ingrid's Public API and web-hooks, enabling automated order lookup, return processing, and refund creation. 

---

### Onboarding Requirements

- Custom platform with API capabilities
- Ability to implement order lookup endpoint
- Web-hook support (optional but recommended)

---

### **Setup Steps**

1. Review Ingrid Returns API documentation: [https://developer.ingrid.com/returns/integration/](https://developer.ingrid.com/returns/integration/)
2. Implement on your platform:
  1. **Order lookup endpoint**: Responds to Ingrid API requests for order data
  2. **Refund creation logic**: Processes refunds when triggered by Ingrid
  3. **Web-hook subscriptions**: Listen for return events from Ingrid
3. In Returns Back-office: **Settings → Integrations → Ecom Integration → Add New**
4. Select **Custom** from dropdown
5. Optional: Enable “Create returns from warehouse notifications”
6. Click **SAVE**
7. Configure API communication:
  1. Provide your order lookup endpoint URL to Ingrid
  2. Subscribe to Ingrid webhooks: `return.created`, `return.processed`, `refund.approved`
  3. Test integration with sandbox environment

---

### **Available Custom Platform Settings**

![Screenshot_2026-01-07_at_14.39.38.png](media://534c0f78-d369-4096-a5db-a16c3e9a78d0)