A valid request URL is required to generate request examples{
"subjectKind": "deposit",
"subjectId": "dep-4417",
"currency": "EUR",
"paidCents": 9000,
"refundedCents": 4500,
"refundableCents": 4500
}{
"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
}
}How much is still refundable on an acompte / caution
Returns what the customer actually PAID IN against the subject, what has already been given back, and the difference — the amount a refund may not exceed. Reach for it before POST /refunds/store-credit to show the operator the real bound: the refund route REFUSES an over-refund rather than trimming it, so asking first is how a caller avoids a 422. Note that paidCents is the sum of the acompte’s payments, NOT the order total — a 50 € acompte on a 500 € order is refundable up to 50 €.
A valid request URL is required to generate request examples{
"subjectKind": "deposit",
"subjectId": "dep-4417",
"currency": "EUR",
"paidCents": 9000,
"refundedCents": 4500,
"refundableCents": 4500
}{
"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
Which domain owns the refunded subject. deposit = an acompte / caution.
deposit Id of the acompte / caution to measure.
1Response
The paid / refunded / still-refundable figures, in integer cents.
The paid / refunded / still-refundable figures, in integer cents.