--- title: "Centra integration" canonical: "https://ingrid-support.refined.site/space/KB/583827461/Centra%20integration" format: markdown --- ## What is it? The **Centra integration** connects Ingrid Returns to your Centra e-commerce backend. Once connected, returns initiated through the Ingrid Returns widget are synchronized with Centra — orders are fetched directly, refunds are issued back into Centra, and exchange orders are created without manual intervention. The integration follows the same standardized e-commerce integration pattern used across all Ingrid Returns platform connectors, so it participates in the same returns lifecycle as Shopify, Magento, and other supported platforms. --- ## Key benefits - **Automated returns workflow** — orders are fetched, refunds are issued, and exchange orders are created automatically. No manual data entry in Centra. - **Native Centra experience for shoppers** — exchange orders appear in your Centra fulfillment queue just like any standard order. - **Faster return-to-refund cycle** — refunds are triggered as soon as the return is approved at the warehouse. - **Consistent integration model** — the same logic that powers Shopify and Magento connectors also powers Centra, so behavior is predictable across platforms. --- ## How it works The integration handles the operations Ingrid Returns needs during a return: reading order data, triggering refunds, creating exchange orders, and fetching product information. ### Order fetching When a customer initiates a return, Ingrid Returns fetches the relevant order from Centra using the order identifier provided. The order data is used to verify return eligibility, populate line items, and calculate refund amounts. ### Refunds When a return is confirmed at the warehouse, Ingrid Returns triggers a refund in Centra. Refund amounts are calculated from customer-currency price fields on the order. ### Exchanges When a customer selects a replacement item, the integration creates a new order in Centra. The exchange order enters your standard Centra fulfillment process — your team treats it like any other order. ### Products and variants The integration fetches product and variant data from Centra to support return reason configuration and product-level policies. Products are identified by their Centra product and variant IDs. --- ## Use cases **Ideal for:** Fashion and lifestyle merchants running Centra as their primary e-commerce backend who want to automate the returns and refunds workflow. **Common applications:** - Automated refund issuance to Centra when a return is processed at the warehouse - Exchange order creation directly in Centra when a customer selects a replacement item - Product catalog lookup to populate return reasons and eligibility rules - Order eligibility checks before a customer can initiate a return --- ## Configuration guide ### Setup location `Returns Back-office → Settings → Admin → [Shop] → Edit ecom integration` ### Onboarding requirements Setting up the Centra integration requires API credentials from your Centra account. The Ingrid Returns team typically assists with initial setup. ### Required configuration values The integration requires six values — one URL and one API key for each of the three Centra APIs. All fields are required. | Setting | Description | | --- | --- | | GraphQL API URL | Base URL for the Centra GraphQL API | | GraphQL API key | Authentication key for the GraphQL API | | Order API URL | Base URL for the Centra Order API | | Order API key | Authentication key for the Order API | | Checkout API URL | Base URL for the Centra Checkout API | | Checkout API key | Authentication key for the Checkout API | ### Step-by-step 1. In the Returns Back-office, navigate to `Settings → Admin` and locate your shop. 2. Select **Edit ecom integration** and choose Centra as the platform. 3. Enter all six API URLs and keys provided by your Centra account. 4. Save the configuration. 5. Create a test order in Centra and initiate a return through the widget to verify the connection end-to-end. --- ## FAQ **Q: Which Ingrid Returns features work with Centra?** A: Order fetching, automated refunds, exchange order creation, and product catalog lookup. Inventory restock back to Centra is not supported. **Q: Does the integration support multi-currency orders?** A: Yes. Ingrid Returns carries both customer-currency and shop-currency amounts on all orders. **Q: How are refund amounts calculated?** A: From the customer-currency price fields on the original Centra order. **Q: Where do exchange orders appear in Centra?** A: In your standard order queue, like any other Centra order. Your fulfillment team processes them the same way. **Q: How long does it take to set up the integration?** A: With API credentials ready, the configuration step takes a few minutes. Your Ingrid Returns team will assist with verification and the first test return. --- ## Getting started To connect Centra to Ingrid Returns, gather your six API credentials (GraphQL, Order, and Checkout — URL and key for each) and contact your Ingrid Returns team. They will assist with setup and verification. Check the [Centra configuration guide](https://support.ingrid.com/space/KB/403636226/Centra+configuration+guide). For Centra-specific scenarios — refunds, exchanges, and payments — see the dedicated articles: - [Centra refunds](https://support.ingrid.com/space/KB/584744961/Centra+refunds) - [Centra exchanges](https://support.ingrid.com/space/KB/584155138/Centra+exchanges) - [Centra payments](https://support.ingrid.com/space/KB/583106566/Centra+payments)