---
title: "Get the authenticated user's one-time (app-OTP) payment by invoice number"
method: GET
path: "/apps/{appUuid}/payments/me/{invoiceNumber}"
---

# Get the authenticated user's one-time (app-OTP) payment by invoice number

`GET /apps/{appUuid}/payments/me/{invoiceNumber}`

## Request

- Base URL: `https://api.fanvue.com`
- URL: `https://api.fanvue.com/apps/{appUuid}/payments/me/{invoiceNumber}`
- Auth: OAuth 2
  - Authorization code: `https://auth.fanvue.com/oauth2/auth`
  - Token URL: `https://auth.fanvue.com/oauth2/token` scopes: `read:self`

`read:self`. Fetches one of the caller's own payments by Fanvue invoice number. 404 for unknown invoice numbers, another buyer's payment, or pre-migration rows.

## Path parameters

- `appUuid` string, uuid, required
- `invoiceNumber` string, required

## Headers

- `X-Fanvue-API-Version` string, required

## Response `200`

The user's one-time payment

- object
  - `uuid` string, required: Horizon purchase identifier.
  - `appUuid` string, required: UUID of the app the purchase belongs to.
  - `buyerUuid` string, required: UUID of the purchasing Fanvue user.
  - `planUuid` string, required: UUID of the purchased pricing plan / item.
  - `invoiceNumber` string, nullable, required: Fanvue invoice number. Use as the idempotency key for fulfilment. Null for purchases that settled before reconciliation was enabled, or not yet settled.
  - `billingReferenceId` string, required: The `appotp_…` reference minted at checkout.
  - `clientReferenceId` string, required: Merchant-supplied reference passed at checkout via `?client_reference_id=`; empty string when unset.
  - `status` 'pending' | 'completed' | 'failed' | 'refunded' | 'expired', required: Lifecycle status of the one-time purchase.
  - `amount` number, required: Amount in minor currency units, snapshotted at checkout.
  - `currency` string, required: ISO currency code.
  - `externalPaymentId` string, required: Provider payment id; empty string until completed.
  - `createdAt` string, date-time, required: When the purchase was created.
  - `updatedAt` string, date-time, required: When the purchase was last updated.

## Other responses

- `400`: Bad Request - API version not supported OR validation failed OR invalid UUID
- `401`: Unauthorized Response
- `403`: Unauthorized Response
- `404`: App not found / not owned, or payment not found
- `410`: API version no longer supported (sunset)
- `429`: Too many requests - rate limit exceeded
- `502`: Failed to load payments from upstream
- `503`: Developer API upstream is not configured

---

[API](https://skmtc.dev/fanvue/apis/fanvue-api.md) - [All operations](https://skmtc.dev/fanvue/apis/fanvue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fanvue/apis/fanvue-api/revisions/966260af2770?raw)