--- title: "Centra configuration guide" canonical: "https://ingrid-support.refined.site/space/KB/403636226/Centra%20configuration%20guide" format: markdown --- The Centra configuration guide explains how to connect your Centra store to Ingrid Returns, enabling automated order lookup, return processing, exchange handling, and refund creation - including advanced configurations for vouchers, gift cards, and product attributes. --- ### **Onboarding Requirements** - Centra admin access - API credentials from Centra --- ### **Setup Steps** 1. In Centra admin, generate API credentials 2. In Returns Back-office: **Settings → Integrations → E-com Integration → Add New** 3. Select **Centra** from dropdown 4. Enter Centra API credentials: - **Transfer API URL** - **Order API URL** - **Order API Key** - **Checkout API URL** - **Product display name** field configuration 5. Configure exchange settings: - **Exchange courier task** - **Exchange product price**: How to price exchange items - **Exchange voucher discount?**: Enable if using vouchers 6. Configure gift card settings: - **Gift card voucher type to receive** - **Gift card maximum qty to receive** 7. Set product attributes: - **Export property hidden**: Select property to export - **Hide property hidden**: Configure hidden properties - **Product attributes on tags**: Map product tags 8. Configure order attributes: - **Identifier for payout used added on tags in the order**: Set order tags 9. Optional: Enable “Stop creating exchange shipment” and “Send refund email” 10. Optional: Enable “Create returns from warehouse notifications” 11. Click **SAVE** --- ### **Available Centra Settings** | **Setting** | **Description** | **Required** | | --- | --- | --- | | GraphQL API Url | The base URL for Centra’s GraphQL API endpoint. Used to fetch store data (products, variants, etc.) via GraphQL. | Yes | | GraphQL API Key | API key used to authenticate against the Centra GraphQL API. | Yes | | Order API Key | API key used to authenticate requests made to the Centra Order API. | Yes | | Checkout API Url | The base URL for Centra’s Checkout API. Used for checkout-related operations (typically for exchanges, vouchers, or checkout creation). | Yes | | Checkout API Key | API key used to authenticate requests made to the Centra Checkout API. | Yes | | Product display name | Controls which Centra product name field is used in Ingrid:
- **Display name** – Usually the customer-facing product name - **Product name** – The internal/system product name | No | | Exchange voucher type | Defines what kind of voucher Centra should generate for exchanges:
- **Discount** – A discount voucher applied at checkout - **Credit** – A store credit voucher (credit-based) | No | | Exchange voucher result | Defines what value the exchange voucher is based on:
- **Order total** – Voucher is based on the total order value - **Product total** – Voucher is based only on returned product value(s) | No | | Exchange voucher apply discount on | Controls where the voucher discount is applied:
- **Order** – Applies discount to the whole order total
- **Order items** – Applies discount to specific order items | Yes | | Gift card voucher apply to markets | Defines where gift card vouchers can be used:
- **Original market** – Voucher is restricted to the market where it was issued
- **All markets** – Voucher can be used across all markets | No | | Gift card definition | Controls how gift cards are created/represented in Centra:
- **Credit only** – Gift card is handled purely as credit
- **Include discount fixed amount** – Gift card includes a fixed-amount discount component | No | | Skip creating exchange shipment | Checkbox option. When enabled, Ingrid will not create a shipment for the exchange flow (useful if exchanges are handled without shipment creation in Centra). | No | | Send refund email | Checkbox option. When enabled, refund confirmation emails are sent (likely via Centra’s system) when refunds are triggered. | No | | Non-refund return creation | Defines what Ingrid should do in Centra when the return does **not** result in a refund:
- **Create return and complete** – Creates the return and marks it completed - **Create return do not complete** – Creates the return but leaves it open/incomplete - **Do not create return** – No return object is created in Centra | No | | Image order | Controls which product image should be used when multiple images exist:
- **First** – Uses the first image in Centra’s image list
- **Last** – Uses the last image in Centra’s image list | No | | Product attributes | Section that controls how product and variant attributes are parsed, displayed, and used inside Ingrid. | | | Variant property hidden | Checkbox option. When enabled, the product variant property will not be shown to the end customer in the return flow. | No | | Size property hidden | Checkbox option. When enabled, size information will be hidden from the return flow UI. | No | | Custom attributes | Dropdown/multi-select field used to define which Centra product attributes should be used to group variants together (e.g., grouping by color, material, etc.). | No | | Ignore attribute values | Dropdown/multi-select field used to filter out attributes that match certain values. Helpful for removing irrelevant attributes like “N/A”, “Default”, “One size”, etc. | No | | Add variant attributes as tags | Dropdown/multi-select field that defines which variant attributes should be converted into tags inside Ingrid. These tags can later be used for return policy logic. | No | | Order attributes section | Section that lets you define which Centra order attributes should be extracted and stored as Ingrid order tags. | | | CREATE NEW (Order attributes) | Button to add a new order attribute mapping. | No | | Order attribute mapping fields | | | | Name | The tag name that will be created inside Ingrid (human-readable label). | No | | Key | The Centra order attribute key that Ingrid will read from the order and map into a tag. | No | | Create returns from warehouse notifications | Checkbox option. When enabled, Ingrid will automatically create returns based on warehouse notifications from Centra / connected warehouse flows. | No | ![image](media://67ea00f7-59b0-4864-ac38-6d32e82e95fe) --- ### Related articles - [Centra integration](https://support.ingrid.com/space/KB/583827461/Centra+integration) — how the integration works (overview) - [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)