Ask for a refund
post/payments/refunds
Ask for a refund. It waits for a person's approval; the limits of the money policy apply.
Before you call
- Credential
Authorization: Bearer $KEY- Scope
shop:write- Mcp
rivier_payments_refund_request- Graphql
Mutation.requestRefund- Sdk
shop.refund.request- Cli
shop refund request- Events
shop.refund.requested
Request bodyapplication/json, required
- paymentIdstring (uuid)required
- amountMinorintegerAt most 99999999999.
- currencystringPattern: ^[a-z]{3}$.
- reasonstringDefault: . At most 300 characters.
- idempotencyKeystringrequiredAt most 120 characters.
Responses
- 201application/jsonSuccess
- 400application/jsonThe request was malformed
- errorstringrequired
- messagestring
- 401application/jsonNo valid credential
- errorstringrequired
- messagestring
- 403application/jsonThe credential lacks the scope, origin or address
- errorstringrequired
- messagestring
- 429application/jsonOver the key's rate limit; see Retry-After
- errorstringrequired
- messagestring