latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

List a creator's checkout-link payments

List checkout-link payments for the specified creator, most recent first, with cursor-based pagination. Filter by your own clientReferenceId to reconcile a specific checkout, or by status. Webhooks remain the primary delivery mechanism; this endpoint is for reconciliation and recovering missed events.

<Info> **Polling for real-time updates? Use a webhook instead.**

If you are calling this endpoint on a schedule to detect new activity, subscribe to the checkout_link.payment.succeeded, checkout_link.payment.pending, checkout_link.payment.failed webhook events instead — you'll get pushed updates in real time without polling. See the webhook documentation. </Info>

get/creators/{creatorUserUuid}/checkout-links/payments

Path parameters

creatorUserUuidstring uuid required

Query parameters

limitinteger

Number of results to return (default 20, max 100).

Number of results to return (default 20, max 100).

cursorstring

Cursor for pagination.

Cursor for pagination.

clientReferenceIdstring

Filter to payments carrying this exact client_reference_id.

Filter to payments carrying this exact client_reference_id.

status'pending' | 'succeeded' | 'failed'

Filter to payments with this status.

Filter to payments with this status.

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

List of checkout-link payments

nextCursorstring nullable required

Cursor for the next page, or null if none.