appointments

Book Appointment V2

Book an appointment and create Stripe checkout session, requiring the tax deduction question to be answered.

post/api/appointments/v2/book

Request body

availability_idstring required

Availability slot UUID to book

appointment_typestring required

Type of appointment (CALL_CONOSCITIVA, CALL_GRATUITA, INCONTRO_PSICOLOGO, INCONTRO_NUTRIZIONISTA)

coupon_idstring nullable

Optional Stripe coupon ID to apply to the payment

Example request

{
  "appointment_type": "CALL_CONOSCITIVA",
  "availability_id": "123e4567-e89b-12d3-a456-426614174000",
  "coupon_id": "coupon_abc123"
}

Response

Successful Response

payment_idstring nullable

Payment UUID when checkout is required

checkout_urlstring nullable

Stripe checkout URL when payment required

expires_atstring date-time nullable

Checkout lock expiry when payment required

amountinteger required

Amount in cents (0 for instant free booking)

currencystring

Currency code

appointment_idstring nullable

Confirmed appointment UUID when no Stripe step (e.g. CALL_GRATUITA)

titlestring nullable

Success title (set only on instant confirmation)

Example response

{
  "amount": 4900,
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_test_...",
  "currency": "eur",
  "expires_at": "2025-11-20T10:15:00+00:00",
  "payment_id": "123e4567-e89b-12d3-a456-426614174002"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.