FAfanvue

List a creator's checkout-link payments

Changed on

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

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/creators/{creatorUserUuid}/checkout-links/payments
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:creator

Path parameters

creatorUserUuidstring uuid required

Query parameters

limitinteger

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

cursorstring

Cursor for pagination, as returned in a previous page's nextCursor.

clientReferenceIdstring

Filter to payments carrying this exact client_reference_id.

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

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.

Changes

  • 79b9aba8a759Revision changes
    • info

      added the required property /// to the response with the status

  • 4d08f36ad6c8Revision changes
    • info

      removed the pattern ^\d+$ from the query request parameter cursor

    • info

      added the required property // to the response with the status