This endpoint is only relevant to Fully Hosted and Custom integrations.

If you’re building with a Forage SDK, then use the Payment Refunds endpoints.

Learn more about the high-level phases of an SDK integration in the Forage JS Quickstart, or check out the Payments API introduction for a list of resources by integration type.

Creates a new refund object and immediately begins processing the refund.

Unlike adding a payment, which is not processed until the order is captured, this request will have immediate financial side effects.

Once the refund is processed, a POST request will be made to your server indicating whether the Refund succeeded or failed.

HTTP Status Code

This endpoint always returns a 201 status code if the Refund was submitted for processing, even if the refund attempt fails, because a Refund object is created on the Forage server to preserve a record of the failed Refund attempt. Therefore, even if your app receives a 201 HTTP status code from the Forage Payments API, it will still need to check the status of the Refund response is succeeded. If the status is failed, please check the refund_errors field in the response for more detail.

Click Try It! to start a request and see the response here!