> For the complete documentation index, see [llms.txt](https://docs.papelship.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.papelship.com/api-based-store/refunds.md).

# Refunds

Invoice refund processing API

## Trigger Invoice Refund

> Initiates a partial or full refund for a completed invoice.

```json
{"openapi":"3.0.3","info":{"title":"PapelShip API Gateway","version":"1.0.0"},"tags":[{"name":"Refunds","description":"Invoice refund processing API"}],"servers":[{"url":"https://papelship.com","description":"Production API Server"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API-Key","description":"Pass your secret API key formatted as: `Authorization: Bearer psa_...`"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Alternative header format: `X-API-Key: psa_...`"}}},"paths":{"/api/api-store/v1/refunds":{"post":{"summary":"Trigger Invoice Refund","description":"Initiates a partial or full refund for a completed invoice.","operationId":"createRefund","tags":["Refunds"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["invoice_id"],"properties":{"invoice_id":{"type":"string"},"amount_cents":{"type":"integer","description":"Optional partial refund amount in cents"},"reason":{"type":"string"}}}}}},"responses":{"200":{"description":"Refund processed successfully"}}}}}}
```