Getting started
This guide is an introduction to the integration capabilities of the Returnista Platform.
It introduces the lifecycle of a return within the Retunista Platform and its three core interoperability points: - Ecomm Bridge - REST API - Webhooks
Terminology
This table describes the language we use within the domain of Returns Management:
| Term | Description |
|---|---|
| Account | Used to access the Returnista app. An account can have multiple stores. |
| Consumer | The individual who initiates a return request or on whose behalf such a request is made. |
| Ecomm Bridge | A connection between Returnista and an ecommerce platform that enables order data synchronization, product information retrieval, and resolution processing. |
| Evidence Form | A customizable form that customers can fill out to provide additional information or proof for their return request. |
| Exchange Product | A replacement item offered to customers when they choose an exchange resolution instead of a refund. |
| Gatekeeping | A feature that allows merchants to review and approve return requests before they are processed, often requiring additional information or evidence. |
| Magic Link | A secure, time-limited URL sent to customers via email that allows them to access their return portal without entering order details. |
| Purchase | A line item (a single product with a quantity of one or more) in a sales order, purchased by a Consumer |
| Request Resolution | How the request is resolved. Such as refund, exchange or store credit |
| Resolution Transaction | A processed batch of return requests that have been sent to the ecommerce platform for refund, exchange, or store credit processing. |
| Restock Location | The warehouse or fulfillment center where returned items are sent for inventory processing. |
| Return Location | A physical address where returned items are received. Return locations are stored at the account level, and each store can have a default return location assigned from the account's return locations. |
| Return Order | A Return Order groups multiple Return Requests made at the same time. These Return Requests will share a payment associated with the Return Order and typically one or more packages shipped for return. |
| Return Request | A request to return a single Purchase. |
| Return Request Fee | A charge applied to return orders, typically when the return value is below a certain threshold. |
| Return Request Lifecycle | The stages a Return Request goes through, from the request beginning to resolution. |
| Return Rule | A configurable business rule that can modify return periods, enable gatekeeping, or control shipping options based on specific conditions. |
| Service User | A special type of user with API access credentials, used for system-to-system integrations and automated processes. |
| Store | Returnista store will use an Ecomm bridge. Contains branding, return policy and return locations. |
| Store Credit Incentive | A bonus amount added to store credit refunds to encourage customers to choose store credit over cash refunds. |
| Tag | A label that can be applied to return orders for categorization, filtering, and reporting purposes. |
| Voucher | A discount or incentive that can be applied to returns, such as free return shipping or extended return periods. |
| Webhook Subscription | A configuration that allows external systems to receive real-time notifications about return order events. |
Account setup
Action items
After learning about these topics, you can start creating your integration with Returnista.
Create and activate your account
- Create your Returnista account.
- Create required stores.
Explore the Dashboard
- Review the settings page.
- Configure branding settings.
- Test your Returns Portal using demo mode.
- Add team members.
- Request developer keys.
Review resources
- Determine if your business would benefit from a third party partner or implementation support.
- Review Returnista docs and API references.