# RMAs

## Introduction

When an RMA event occurs in the returns portal, Optoro will notify your webhook about the RMA and its details.
These events can be at the time your customer has created an RMA or when the RMA has been shipped.

Optoro's system will make an HTTP POST request to the API endpoint at the configured URL.
The API endpoint will need to return an HTTP 200-299 status for a webhook to be considered successful.

See the [Webhook Message Behaviors](../../../content/webhooks/#message-behaviors) for more details about aspects to consider regarding message delivery.

## When it is used

- Optoro posts an **RMAs** message to you when the shopper initiates a return.
- Optoro posts an **RMAs** message to you when carrier tracking details are provided (when applicable).
- Optoro posts an **RMAs** message to you when the carrier receives and scans the return.
- Optoro posts an **RMAs** message when the shopper drops off the return at a drop-off location or when a pick-up partner picks up the return from the shopper.
- Optoro posts an **RMAs** message when the item is received (and ready for refund) when you also use Optoro’s Returns Management solution.
- Optoro posts an **RMAs** message to you after you update the order with refund details in the Refunds object of the **Returns Portal Order** API.

## Changelog

### Version 4

* FEATURE: There is a new top-level field `bonus_credit_amount_cents` (applicable for instant store credit refunds).
* BREAKING: The `UNEVEN_GC` item refund type value is renamed to `INSTANT_STORE_CREDIT`.
* BREAKING: The `EVEN_EXCHANGE` item refund type value is renamed to `INSTANT_EXCHANGE`.


Version: 4.0.0

## Download OpenAPI description

[RMAs](https://developer.optoro.com/_bundle/openapi/rmas/@4/openapi.yaml)

## Other

### RMA Event

 - [POST /rmas](https://developer.optoro.com/openapi/rmas/4/openapi/other/rmas.md)