400 | CONTRACT_REVERT | error | Redemption request failed The redemption was rejected. Read GET /v2/redeem/checkout/{preparationId} before you try again. |
400 | FUNCTION_ERROR | error | Redemption request failed The state of a collectible could not be read. Read GET /v2/redeem/checkout/{preparationId} before you try again. |
400 | INSUFFICIENT_USDT_AMOUNT | error | Redemption request failed Check the fee balance and the USDT allowance for Permit2. Look up the original preparation before another payment. |
400 | REDEMPTION_ORDER_VALIDATION_FAILED | error | Redemption request failed The prepared redemption is no longer valid. Prepare again from a new quote. |
400 | WRONG_REQUEST_PARAMS | error | Invalid redemption input
Request body is too large
Redemption request failed
Preparation expired A field is missing or has the wrong form, or a collectible in the preparation can no longer be redeemed. Prepare again from a new quote. |
400 | INSUFFICIENT_ALLOWANCE | error | Redemption request failed This HTTP error can surface if the failed payment cannot be matched to its recorded checkout. A matched failure returns HTTP 200 with status: "failed". Check the fee balance and the USDT allowance for Permit2. Look up the original preparation before another payment. |
401 | API_AUTH_INVALID_CREDENTIAL | error | Invalid authentication credential The builder key or the wallet access token is malformed, unknown, expired or revoked. Check the key. For the token, refresh the tokens or have the wallet sign in again. |
401 | API_AUTH_MISSING_CREDENTIAL | error | Required authentication credential is missing The builder key or the wallet access token is missing. Send both: the key in the x-builder-api-key header and the token as a Bearer token. |
403 | API_AUTH_CREDENTIAL_NOT_ALLOWED | error | Credential is not allowed by this policy A credential this route does not take was sent. Send the builder key and the wallet access token only. |
403 | API_AUTH_INSUFFICIENT_SCOPE | error | Required authentication scope is missing The wallet access token lacks the scope this route needs: redeem:read to read, redeem:write to change. Have the wallet sign in again and ask for the scope. |
403 | API_AUTH_INTEGRATION_MISMATCH | error | Authentication integrations do not match The wallet access token was issued to another builder than the key. Use the key of the builder that issued the token. |
403 | API_AUTH_INVALID_ACTION | error | Invalid wallet action proof The signature does not match the wallet or the prepared data, or the preparation has expired. Prepare again and have the wallet sign the new data. |
403 | API_AUTH_SUBJECT_MISMATCH | error | Authentication subjects do not match The wallet access token is not for the chain of this API. Have the wallet sign in again for the right chain. |
403 | GACHA_V3_BUILDER_NOT_ACCEPTED_ON_PUBLIC_API | error | This builder checks out on its own surface, not on the public API This builder key cannot be used on this API. Do not retry; contact Renaiss. |
404 | REDEMPTION_ORDER_NOT_FOUND | error | Not found or expired
Not found There is no such quote or preparation for this wallet and builder, or it has expired. Ask for a new quote. |
409 | REDEMPTION_ORDER_CHECKOUT_STILL_ACTIVE | error | Redemption request failed A checkout for these collectibles is already in progress. Do not send it again. Read GET /v2/redeem/checkout/{preparationId} to follow it. |
429 | API_AUTH_RATE_LIMITED | error | Authentication rate limit exceeded The builder key hit its rate limit. Wait a little, then retry at a lower rate. |
500 | API_AUTH_INVALID_CONFIGURATION | error | Internal server error Contact Renaiss with x-request-id if wallet authentication keeps failing. |
500 | API_AUTH_ERROR | error | Internal server error The signature could not be checked because the chain could not be read. Retry the request. |
500 | FUNCTION_ERROR | error | Internal server error |
503 | FUNCTION_ERROR | error | Internal server error |