MAmadethis
Money

Refund an order, fully or partially (Idempotency-Key required)

post/orders/{id}/refund

Request

  • Base URL
    https://api.madethis.com/v1
  • URL
    https://api.madethis.com/v1/orders/{id}/refund
  • Auth
    HTTP bearer

Path parameters

idstring required

Headers

Idempotency-Keystring required

Unique per intent, 1–128 printable ASCII characters. Reuse the SAME value on a retry: the request replays instead of running twice. Required on this route.

Request body

amountCentsinteger
reason'duplicate' | 'fraudulent' | 'requested_by_customer'
notestring

Response

Success envelope.

hintstring

One-sentence orientation for agents.

next_actionstring

The literal next call an agent would chain.

Changes

No recorded changes to this operation across all 1 revision of this API.