Error
A valid request URL is required to generate request examples{
"amountCents": -1800,
"reason": "Remboursement R-ret-ok",
"at": "2026-07-28T10:00:00.000Z",
"returnId": "ret-ok",
"originalTransactionId": "sale-return-seed"
}{
"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 return's cash-drawer pay-out
Resolves the signed cash-drawer pay-out a processed return produced — a NEGATIVE integer-cent movement for a cash refund, or null for a non-cash / zero-valued one. This is the figure the back-office reconciles the register against. 404s when no return carries the given id.
GET
/
v1
/
returns
/
{id}
/
cash-movement
Error
A valid request URL is required to generate request examples{
"amountCents": -1800,
"reason": "Remboursement R-ret-ok",
"at": "2026-07-28T10:00:00.000Z",
"returnId": "ret-ok",
"originalTransactionId": "sale-return-seed"
}{
"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 processed return (retour) to read.
Minimum string length:
1Response
object | null
The signed cash pay-out, or null for a non-cash / zero-valued refund.