Create deposit
Create a deposit (add money to customer balance)
POST
/v1/customers/{customerId}/depositauthorization<token>
Use device JWT token
In: header
Path Parameters
customerIdstring
Customer UUID
Format
uuidamountinteger
Amount in cents
Range
0 < valuedescription?string|null
operatorId?string|null
tillId?string|null
paymentIdstring
Payment method UUID
Format
uuidResponse Body
application/json
application/json
application/json
curl -X POST "http://localhost:4012/v1/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08/deposit" \ -H "Content-Type: application/json" \ -d '{ "amount": 5000, "description": "Cash deposit", "paymentId": "a7f3c8d2-4e9b-4a1c-8f2d-6b5e9c3a1d4e", "operatorId": "3e6881da-8591-4865-b5ce-3c5227e0730e", "tillId": "15100d94-bc66-4e86-8e92-f6ba4924772b" }'{
"id": "f8e9d7c6-5b4a-4c2d-8e0f-9a8b7c6d5e4f",
"type": "deposit",
"amount": 5000,
"updatedBalance": 8000,
"totalOrder": 0,
"description": "Cash deposit",
"status": "finalized",
"currencyCode": "EUR",
"createdAt": "2025-10-28T10:00:00.000Z",
"updatedAt": "2025-10-28T10:00:00.000Z"
}{
"message": "Invalid payment method",
"code": "INVALID_PAYMENT_METHOD"
}{
"message": "Invalid payment method",
"code": "INVALID_PAYMENT_METHOD"
}