---
title: "Buy one year of rent-receipt access (€4.90, one-shot)"
method: POST
path: "/quittance-access/checkout"
tags: ["Rent Receipts", "Credits"]
---

# Buy one year of rent-receipt access (€4.90, one-shot)

`POST /quittance-access/checkout`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/quittance-access/checkout`
- Auth: HTTP bearer

Opens a Stripe Checkout session for the one-shot €4.90 purchase that
grants a year of rent-receipt sending.

It is a **one-off payment, not a subscription**: nothing renews, nothing
is trialled, and the window simply lapses. The price is fixed
server-side: the client never chooses a Stripe price id.

Redirect the user to `checkout_url`. Entitlement is granted by the
Stripe webhook once the payment settles, so re-read
`GET /quittance-access` after the user comes back to `success_url`
rather than assuming access on return.

Pointless when the plan already includes rent receipts; check
`GET /quittance-access` first.

## Request body

- CreateQuittanceAccessCheckout
  - `success_url` string, uri, required: Where Stripe returns the user after a successful payment.
  - `cancel_url` string, uri, required: Where Stripe returns the user if they abandon the payment.
  - `payment_method_types` string[], nullable: Restrict the Stripe payment methods offered. Stripe's defaults apply when omitted.

## Response `201`

Checkout session created.

- QuittanceAccessCheckoutSession
  - `checkout_url` string, uri: Stripe Checkout URL to redirect the user to.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)