curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/checkout-links/payments/{invoiceNumber} \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/checkout-links/payments/{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/v1/creators/{creatorUserUuid}/checkout-links/payments/{invoiceNumber}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"invoiceNumber": "FVE-20260619-1234",
"status": "succeeded",
"billingReason": "one_time",
"clientReferenceId": "order_9f8c",
"gross": 9999,
"net": 8000,
"fees": {
"fanvueFee": 1500,
"transactionFee": 499
},
"currency": "USD",
"transactionId": "txn_abc123",
"createdAt": "2026-06-19T08:30:00.000Z",
"paidAt": "2026-06-19T08:30:05.000Z",
"checkoutLink": {
"uuid": "0b3c0e4a-1f2d-4c8a-9a1b-3e5f7a9c1d2e",
"name": "Premium Coaching",
"productUuid": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"productPriceUuid": "9z8y7x6w-5v4u-3t2s-1r0q-9p8o7n6m5l4k"
},
"purchaser": {
"uuid": "7c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
"email": "buyer@example.com"
},
"metadata": {
"campaign": "summer"
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Get a creator's checkout-link payment by invoice number
Fetch a single checkout-link payment by its Fanvue invoiceNumber, scoped to the specified creator. Returns 404 if the payment does not exist or does not belong to this creator.
curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/checkout-links/payments/{invoiceNumber} \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/checkout-links/payments/{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/v1/creators/{creatorUserUuid}/checkout-links/payments/{invoiceNumber}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"invoiceNumber": "FVE-20260619-1234",
"status": "succeeded",
"billingReason": "one_time",
"clientReferenceId": "order_9f8c",
"gross": 9999,
"net": 8000,
"fees": {
"fanvueFee": 1500,
"transactionFee": 499
},
"currency": "USD",
"transactionId": "txn_abc123",
"createdAt": "2026-06-19T08:30:00.000Z",
"paidAt": "2026-06-19T08:30:05.000Z",
"checkoutLink": {
"uuid": "0b3c0e4a-1f2d-4c8a-9a1b-3e5f7a9c1d2e",
"name": "Premium Coaching",
"productUuid": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"productPriceUuid": "9z8y7x6w-5v4u-3t2s-1r0q-9p8o7n6m5l4k"
},
"purchaser": {
"uuid": "7c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
"email": "buyer@example.com"
},
"metadata": {
"campaign": "summer"
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}read:creator— Access creator profiles, content, and creator-specific information.
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
Fanvue payment identifier (invoice number).
Response
The checkout-link payment
Fanvue's unique payment identifier. Use this as the idempotency key for fulfilment.
Settlement status of the payment.
pending, succeeded, failed What the payment was for: a one-off purchase, the first payment of a subscription, or a subscription renewal. Matches the billing_reason on the checkout_link.payment.* webhook.
one_time, subscription_initial, subscription_renewal The merchant-supplied reference passed at checkout via ?client_reference_id=. Use it to match the payment to your own order/customer.
Gross amount the buyer paid, in minor units.
Creator net amount after fees, in minor units.
Show child attributes
Show child attributes
Informational only — the local currency the fan originally paid in (e.g. 'BRL'). The gross, net, and fee amounts are already converted to USD minor units regardless of this value.
Payment processor transaction reference.
When the payment was created.
When the payment settled, if it did.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Arbitrary merchant metadata passed at checkout via ?metadata[key]=value.
Show child attributes
Show child attributes
Was this page helpful?