Skip to content

Storefront API (1.0.0)

REVER's Storefront Returns API is the solution to building your custom made returns storefront while leveraging the power of REVER's returns engine.

Quick Integration

  • RESTful architecture
  • OpenAPI specification with ready-to-use examples and client library generation

Features

  • Return initiation and validation
  • Smart exchange recommendations
  • Multiple refund options (store credit, bank transfer, gift cards)
  • Automated return logistics
  • Tracking and status updates
  • Risk Assesment

Technical Highlights

  • REST-based API with JSON payloads
  • Secure authentication via API keys
  • Sandbox environment for testing
  • Rate limiting with generous quotas

Get started quickly with our step-by-step integration guide. Our support team is ready to help you at every step of your integration journey.

Authentication

The REVER Admin API uses API key authentication.

Authenticating via API Key

This authentication method is primarily used for server-to-server (unattended) integrations. You must request an API key through your account manager.\nThe API key must be kept secure and confidential, do not share it with anyone.

To authenticate a request using an API key, include the header x-rever-api-key. Example: x-rever-api-key: 87bf223499abeef

Download OpenAPI description
storefront.json
storefront.yaml
Overview
URL
https://itsrever.com
REVER
developer@itsrever.com
Languages
Servers
Mock server
https://docs.itsrever.com/_mock/apis/storefront/

Return Request

Returns are a way to return items to the store.

Operations

Exchange Options

Exchange options are the steps when the user decides to return an item. The first step is to get the available exchange options and try to get the best exchange option for the user.

Operations

Return Reasons

Return reasons are the reasons why the user wants to return an item available for the ecommerce.

Operations

Refund Options

Refund options are a way to refund items. A refund is not an exchange, the available refund options are BANK_TRANSFER, STORE_CREDIT, GIFT_CARD, ORIGINAL_PAYMENT_METHOD.

Operations

Return Options

Return options are a way to return items to the store.

Operations

Return Checkout

Checkout is the final step when the user decides to return an item. The user will be redirected to the checkout page to complete the return.

Operations

Tracking and Status

Tracking and status are a way to track and status of a return.

Operations
REVER all rights reserved.