Refund order payment

Refund a paid order via Stripe, in full or in part. Requires write access. The customer is refunded first, then the platform fee is adjusted for the refunded amount. Errors: 403 when refunds are not enabled for your workspace — contact support to turn them on. 404 when the order does not exist, and when the endpoint is not available to you. 400 when the order exists but cannot be refunded: it was paid through a processor that doesn't support refunds through this API, its status does not allow a refund, or the amount is above what is still refundable. The 400 message says which. Refunds on a workspace can also be temporarily limited while earlier ones finish settling; that is a 400 telling you to try again later, and it clears on its own. A disputed charge is checked against Stripe live, at request time. If that lookup fails, you get a 503, not a 400 — retry the request; this is not a rejection. Idempotency: send a stable `idempotencyKey` on every retry. Retries carrying the same key are deduplicated. A refund sent without a key is not guaranteed to be deduplicated, so retrying one after a lost response can refund the customer again. Retrying a non-exhausting partial refund with the same `idempotencyKey` returns the original refund and changes nothing else — no second refund, no status change, no notification. If that same key repeats a request a fresh eligibility check now rejects — a full refund, an exhausting partial, or one above the currently refundable amount — you get a 400. Retry with a smaller amount, or contact support to confirm the original refund's status.

curl -X PATCH "https://example.com/v0/orders/550e8400-e29b-41d4-a716-446655440000/refund" \  -H "Content-Type: application/json" \  -d '{}'

{  "status": "success",  "data": {    "refundId": "string",    "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",    "amount": 1,    "currency": "AFN",    "status": "succeeded",    "createdAt": "string",    "replayed": true  }}