Issue Refund

POST 
/api/stripe/invoices/:id/refunds

Issues a partial or full refund against the charge backing a paid Stripe Invoice. Requires admin or power-user privileges. Throttled to 20 requests/minute.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Fields:

• amount_in_cents (optional, integer, min 1) — refund amount; if omitted, refunds the full remaining refundable amount
• reason (optional, enum) — one of duplicate, fraudulent, requested_by_customer

Request

Responses

201

Created

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden

Response Headers

Content-Type

404

Not Found

Response Headers

Content-Type

422

Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.