跳转到主要内容
POST
提交已签名的回购请求并轮询结果
  1. 签名。 让卖家对同一卡包内的结算 ID 签署 BuybackUserAuthorization。使用与结算回购相同的请求体和开发者密钥。其他卡包的 ID 可能返回 HTTP 404 和 EOA_PURCHASE_REJECTED。
  2. 查询进度。 保存 HTTP 202 返回的 requestId,约每秒查询一次回购状态,直到状态为 COMPLETED 或 FAILED。每次提交都会创建独立请求。
  3. 处理失败。 异步请求与直接结算返回相同的错误码。遇到 OP_WALLET_BUSY 可使用原签名重试;其他失败需刷新报价并重新签名。

请求

需要开发者密钥和钱包签名

响应

HTTP 202 返回 status: "PENDING"、error: null 和新的 requestId。如需查看结算失败原因,请查询回购状态。

错误码

在下表中查找接口返回的 HTTP 状态码和响应原文。有关各接口通用的处理建议,请参阅错误码含义与处理方式。

授权

x-builder-api-key
string
header
必填

已获准使用的开发者 API 密钥,仅在后端保存。抽卡和市场的写入操作还需钱包签名,实物兑换还需钱包签署登录消息后由 API 签发的 Bearer 令牌。

请求体

application/json
buyerWalletAddress
string
必填
cardPackId
string<uuid>
必填
buybackAuth
object
必填
userSignature
string
必填

响应

每次成功提交均创建新请求。请使用 requestId 轮询 GET /v2/gacha/buyback/status 查询结果。

requestId
string<uuid>
必填
status
enum<string>
必填
可用选项:
PENDING
buyerWalletAddress
string
必填

带 0x 前缀的 20 字节钱包或合约地址。请使用全小写或有效的校验和格式。

cardPackId
string<uuid>
必填
settlementIds
string[]
必填

32 字节,以 0x 开头,后接 64 个十六进制数字。

txHash
null
必填
totalAmountInUsdt
null
必填
itemCount
null
必填
error
null
必填