POST /api/v1/deposits
Authorization: Bearer YOUR_TOKEN
Idempotency-Key: booking-12345-deposit
Content-Type: application/json

{
  "booking_reference": "BOOKING-12345",
  "amount": 300.00,
  "currency": "EUR",
  "customer": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "check_in_date": "2026-09-10",
  "check_out_date": "2026-09-17",
  "metadata": {
    "apartment_id": "APT-42"
  }
}

GET /api/v1/deposits?booking_reference=BOOKING-12345
GET /api/v1/deposits/{id}

POST /api/v1/deposits/{id}/capture
Content-Type: application/json

{
  "amount": 75.00,
  "description": "Damage to kitchen table"
}

POST /api/v1/deposits/{id}/release