Partner buyback (currently unavailable)
Retained for existing integrations. Partner buyback is currently unavailable.
Hide the action when prize.won
reports buyback.available: false or the prize response reports
buyback.eligible: false. An amount or deadline alone does not enable buyback.
An otherwise eligible request returns 409 ITEM_WALLET_SIGNATURE_REQUIRED.
Processing, unavailable, expired or shipping-related errors may be returned first.
Offer redemption when the prize response says it is redeemable.
Existing clients can use the response formats below to recognize previous requests. They should not offer new buybacks through this endpoint.
PartnerApiKeyAuthorizationBearer <token>Authorization: Bearer <your_api_key>
Keep this credential on your server, never in browser or mobile app code.
A missing, invalid or disabled key returns 401 PLATFORM_KEY_INVALID.
Ask Verity to replace a lost or exposed key.
raffleId*integer1 <= valueprizeId*integer1 <= valueapplication/json- body
external_user_ref*stringThe winning buyer's ref, as sent at purchase time.
^\S(.*\S)?$1 <= length <= 255Paid. replayed: true means a previous identical call already paid — the
amount and signature are the original ones, and no second payout happened.
application/json- response
success*booleandata*curl -X POST 'https://api-staging.theverity.xyz/api/v1/platform/raffles/77/prizes/41/buyback' \ -H 'Authorization: Bearer <your_partner_api_key>' \ -H 'Content-Type: application/json' \ -d '{ "external_user_ref": "usr_8812"}'{ "success": true, "data": { "amount_usd": 10625, "signature": "3QkR7wYpL4dHnQ3sXcV6aB1eG8tU9yWfM2kPjR5hN7xC", "replayed": false }}