curl --request GET \
--url https://api.fanvue.com/apps/{appUuid}/payments/me/{invoiceNumber} \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/apps/{appUuid}/payments/me/{invoiceNumber}"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/apps/{appUuid}/payments/me/{invoiceNumber}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"uuid": "00000000-0000-4000-8000-0000000000aa",
"appUuid": "00000000-0000-4000-8000-000000000001",
"buyerUuid": "00000000-0000-4000-8000-000000000003",
"planUuid": "00000000-0000-4000-8000-000000000002",
"invoiceNumber": "FVE-20260619-1234",
"billingReferenceId": "appotp_000000001VgEh72lXvTXkL",
"clientReferenceId": "order_9f8c",
"status": "completed",
"amount": 4999,
"currency": "USD",
"externalPaymentId": "pi_3Q1example",
"createdAt": "2026-06-19T08:30:00.000Z",
"updatedAt": "2026-06-19T08:30:05.000Z"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}Get the authenticated user's one-time (app-OTP) payment by invoice number
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.
curl --request GET \
--url https://api.fanvue.com/apps/{appUuid}/payments/me/{invoiceNumber} \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/apps/{appUuid}/payments/me/{invoiceNumber}"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/apps/{appUuid}/payments/me/{invoiceNumber}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"uuid": "00000000-0000-4000-8000-0000000000aa",
"appUuid": "00000000-0000-4000-8000-000000000001",
"buyerUuid": "00000000-0000-4000-8000-000000000003",
"planUuid": "00000000-0000-4000-8000-000000000002",
"invoiceNumber": "FVE-20260619-1234",
"billingReferenceId": "appotp_000000001VgEh72lXvTXkL",
"clientReferenceId": "order_9f8c",
"status": "completed",
"amount": 4999,
"currency": "USD",
"externalPaymentId": "pi_3Q1example",
"createdAt": "2026-06-19T08:30:00.000Z",
"updatedAt": "2026-06-19T08:30:05.000Z"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}read:self— Access your own user profile information, including basic account details and settings.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
Headers
API version to use for the request
"2025-06-26"
Path Parameters
"00000000-0000-4000-8000-000000000001"
"FVE-20260619-1234"
Response
The user's one-time payment
Horizon purchase identifier.
UUID of the app the purchase belongs to.
UUID of the purchasing Fanvue user.
UUID of the purchased pricing plan / item.
Fanvue invoice number. Use as the idempotency key for fulfilment. Null for purchases that settled before reconciliation was enabled, or not yet settled.
The appotp_… reference minted at checkout.
Merchant-supplied reference passed at checkout via ?client_reference_id=; empty string when unset.
Lifecycle status of the one-time purchase.
pending, completed, failed, refunded, expired Amount in minor currency units, snapshotted at checkout.
ISO currency code.
Provider payment id; empty string until completed.
When the purchase was created.
When the purchase was last updated.
Was this page helpful?