Skip to main content
POST
This endpoint creates a refund request that can process partial or full refunds. It handles payment reversals, inventory adjustments, and customer notifications.

Authentication

This endpoint requires a valid API key with refunds:write permissions.

Request Body

string
required
Original order ID to refund
string
required
Refund type: “full”, “partial”, “item_return”, “shipping”, “tax_only”
string
required
Refund reason code
string
Detailed explanation of refund reason
array
Items to refund (required for partial/item refunds)
object
required
Refund amounts breakdown
object
Refund payment method
object
Return shipping details
object
Processing options
string
Internal notes about the refund
object
Additional custom fields

Response

Returns the created refund object.