Instant refunds 🚀

Overview

Reveni (https://reveni.com/) provides an instant refund service that enables eCommerce platforms and partners to supercharge their RMA systems, thus improving customer satisfaction and reducing customer support intervention.

Please watch the video for a full integration demo:

https://drive.google.com/file/d/1rEKlEmIaSbURyWMENVaqdzNptELvqIZU/view?usp=sharing

The technical integration process consists of the following steps:

1. RMA process init. A customer initiates the RMA process through the returns portal which supports the merchant’s returns & exchanges requests. Before enabling Reveni, you must create a Webhook using the API to receive events in the RMA system. We recommend subscribing to, at least, the return.updated event type.

2. RMA process finish. Once the customer completes the RMA process and their request has been persisted in the system, Reveni is shown as a refund option for an instant payment. You may want to integrate the CheckInstantRefund API to validate if the return process can be shown to the customer, then call the CreateReturn API. The CreateReturn API returns an Order ID, Return ID and authentication token that you will provide to the reveni.init() method of the JS SDK as parameters to initiate the instant return process. These IDs will be sent from your backend to the frontend of your application. The Return API is designed to be used server-to-server, using the private API key for authentication, that cannot be exposed out of your platform.

3. Instant refund. The reveni.init() method initiates the instant refund process within an iframe , which increases the customer experience, trust and security, since they never leave your domain. The customer must accept our terms and conditions, verify their email address (for new customers only) and provide an IBAN account number to receive their refund. That’s all!

4. RMA process summary. Once the customer completes the instant refund process, it is likely that you want show a custom page for them or perform a specific task. The Reveni JS SDK can be fed with a pair of redirect URLs (success_url, reject_url and dismiss_url) or callback functions as parameters (onSuccess, onReject, onDismiss and onFinish) to implement the desired behaviour.

5. RMA dashboard (for merchant). When subscribed to the relevant event types using the Webhook API, your system will receive events each time that the status of the return changes. Then you may want to update the status of the refund in third-party systems. Common use cases for post-refund actions include:

   • Updating the return status in the eCommerce platform (Shopify, Magento, Prestashop, etc.) as already refunded, to avoid unintended duplicate refunds.
   • Updating the return status in the ERP or CMS system, to mark these transactions as processed refunds and consolidate the information.

   Once the customer completes the instant refund process and the instant payment has been confirmed to the customer, the Reveni return status transitions to in_progress, which means it is now the merchant’s responsibility to either accept or reject the return when reviewed within the 30-day deadline. You must update the internal status of the refund in your system accordingly with this status.

   It is also possible to accept/reject a Return via API, once the Merchant has checked the package returned. Check the API Reference for further details.