A valid request URL is required to generate request examples{
"id": "dep-ok",
"orderId": "order-1",
"customerId": "cust-1",
"customerName": "Camille Laurent",
"storeId": "store-rivoli",
"currency": "EUR",
"orderTotalCents": 100000,
"payments": [
{
"amountCents": 30000,
"at": "2026-07-28T09:00:00.000Z"
},
{
"amountCents": 70000,
"at": "2026-07-28T10:00:00.000Z"
}
],
"status": "open",
"actorId": "user-cashier-1",
"createdAt": "2026-07-28T09:00:00.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
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Record a deposit payment (versement)
Records a further down-payment (versement) against an open deposit (acompte), returning the updated deposit. The deposit is addressed by the PATH id (authoritative — a body depositId is ignored). Money is integer cents. Side-effect: this takes the customer’s money and appends to the deposit ledger. 404s for an unknown deposit; 422s when the payment overpays the outstanding balance, or when the deposit is already settled.
A valid request URL is required to generate request examples{
"id": "dep-ok",
"orderId": "order-1",
"customerId": "cust-1",
"customerName": "Camille Laurent",
"storeId": "store-rivoli",
"currency": "EUR",
"orderTotalCents": 100000,
"payments": [
{
"amountCents": 30000,
"at": "2026-07-28T09:00:00.000Z"
},
{
"amountCents": 70000,
"at": "2026-07-28T10:00:00.000Z"
}
],
"status": "open",
"actorId": "user-cashier-1",
"createdAt": "2026-07-28T09:00:00.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
}
}{
"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 deposit (acompte) to read or transition.
1Body
Further down-payment (versement) in integer cents; must be strictly positive.
0 < x <= 9007199254740991Response
The deposit with the further payment appended.
The deposit with the further payment appended.
0 < x <= 9007199254740991Show child attributes
Show child attributes
open, settled 
