---
title: "Purchase a gift package"
method: POST
path: "/api/gifts/purchase"
tags: ["gifts"]
---

# Purchase a gift package

`POST /api/gifts/purchase`

Initiate Stripe checkout for a gift package purchase. Public endpoint (no auth required).

## Request body

- PurchaseGiftRequest — Request to purchase a gift package.
  - `package_id` string, required — Gift package ID to purchase (e.g., 'gift-4-sessions')
  - `sender_name` string, required — Name of the person buying the gift
  - `sender_email` string, required — Email of the person buying the gift
  - `recipient_email` string, required — Email to send the gift notification to
  - `message` string, nullable — Optional personal message from sender

## Response `201`

Successful Response

- PurchaseGiftResponse — Response after initiating gift purchase.
  - `gift_id` string, required — Gift purchase UUID
  - `checkout_url` string, required — Stripe checkout session URL
  - `package_id` string, required — Gift package ID purchased
  - `price` integer, required — Package price in EUR

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)