Withdraw a checkout-link refund request

Take back a refund request Fanvue has not decided on yet. Only a pending request can be withdrawn: once it is approved the reversal may already be with the payment provider, and money on its way back cannot be recalled. Returns 404 if the request does not exist or does not belong to this creator, and 409 once it has been decided.

post/creators/{creatorUserUuid}/checkout-links/refund-requests/{uuid}/withdraw

Path parameters

creatorUserUuidstring uuid required
uuidstring uuid required

Fanvue refund-request identifier.

Fanvue refund-request identifier.

Headers

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

API version to use for the request

Response

Refund request withdrawn

uuidstring required

Fanvue's unique refund-request identifier.

paymentIdstring required

Invoice number of the payment this request is against (invoiceNumber).

status'pending' | 'approved' | 'failed' | 'refunded' | 'rejected' | 'withdrawn' | 'chargebacked' required

Where the request stands. pending is awaiting review; approved means Fanvue accepted it and is reversing the payment; failed means a reversal attempt did not go through and Fanvue is still working it (not a decision against the request); refunded is the money back with the fan, and also fires checkout_link.refund.created; rejected is refused, with the reason in reviewNote; withdrawn is the creator taking their own request back; chargebacked means the fan disputed the payment with their bank before the request was settled, so the money went back through the dispute instead (see the checkout_link.dispute.* events). The Fanvue dashboard shows approved and failed together as "processing".

reason'duplicate' | 'fraudulent' | 'requested_by_customer' | 'other' required

Why the creator is asking for the payment to be refunded.

notestring nullable required

The note the creator sent with the request.

reviewNotestring nullable required

Fanvue's reason for the decision; populated when status is rejected.

createdAtstring date-time required

When the request was opened.

resolvedAtstring date-time nullable required

When the request reached a final state, or null while it is still open.

Changes

Changed in 1 of the 5 revisions of this API.1