Error
A valid request URL is required to generate request examples{
"id": "ref-2026-000128",
"subjectKind": "deposit",
"subjectId": "dep-4417",
"customerId": "cus-882",
"storeId": "store-paris-01",
"currency": "EUR",
"amountCents": 4500,
"modality": "store_credit",
"instrumentId": "avoir-ref-2026-000128",
"instrumentCode": "AV-K7QMD3PZRT",
"note": "Réparation impossible — acompte rendu",
"actorId": "usr-cashier-12",
"refundedAt": "2026-08-05T09:41:07.000Z"
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Returns
Get a store-credit refund by id
Returns one recorded store-credit refund, including the avoir it minted. 404s when no refund carries the given id.
GET
/
v1
/
refunds
/
{refundId}
Error
A valid request URL is required to generate request examples{
"id": "ref-2026-000128",
"subjectKind": "deposit",
"subjectId": "dep-4417",
"customerId": "cus-882",
"storeId": "store-paris-01",
"currency": "EUR",
"amountCents": 4500,
"modality": "store_credit",
"instrumentId": "avoir-ref-2026-000128",
"instrumentCode": "AV-K7QMD3PZRT",
"note": "Réparation impossible — acompte rendu",
"actorId": "usr-cashier-12",
"refundedAt": "2026-08-05T09:41:07.000Z"
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Authorizations
Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.
Path Parameters
Id of the store-credit refund to read.
Minimum string length:
1Response
The recorded refund.
The recorded refund.
Available options:
deposit Required range:
0 < x <= 9007199254740991Available options:
store_credit, original_method 
