Update a payment
Partially update a payment by its document ID. Only the fields provided in the body are modified; omitted fields are left unchanged.
The body follows the same contract as the response: amount in integer cents, dates as YYYY-MM-DD (interpreted in Europe/Paris), and status verbatim. The received_date and due_date fields accept null to clear them.
Updating a payment automatically emits the payment.updated webhook. Security deposits (holds) are out of scope and return 404.
Authorizations
Bearer authentication using your BookingShake API key. Retrieve your API key from Settings > Integrations in your BookingShake dashboard.
Path Parameters
Payment document ID (the id field carried by the payment.* webhooks).
Body
Fields that can be updated on a payment. All fields are optional (partial update): only the fields present in the body are modified. Same conventions as the response - amount in integer cents, dates as YYYY-MM-DD in the Europe/Paris timezone. At least one field must be provided.
Payment label
255"Acompte 30%"
Amount in integer cents
x >= 090000
waiting, paid, canceled "paid"
Payment method, verbatim label
255"Virement bancaire"
Date the payment was received, YYYY-MM-DD. Pass null to clear.
"2026-06-10"
Date the payment is expected, YYYY-MM-DD. Pass null to clear.
"2026-06-15"
Response
Payment updated successfully. Returns the full payment in its post-update state.
