跳转到主要内容
POST
使用钱包签名结算回购
签名前,与卖家核对所选结算 ID 以及以 USDT 计价的回购总额。同一次回购请提交同一卡包的结算 ID。若混入其他卡包的 ID,接口可能在受理前返回 HTTP 404 和 EOA_PURCHASE_REJECTED。回购款以 USDT 支付给钱包。即使卖家的 USDT 余额和 Permit2 授权额度都为零,也可以完成回购。

请求

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

响应

错误码

响应原文中花括号内的内容会替换为实际值。有关各接口通用的处理建议,请参阅错误码含义与处理方式。
仅凭 CONTRACT_REVERT 无法判断转账失败的具体原因。重试前请核对钱包当前的回购报价。若 HTTP 503 返回 OP_WALLET_BUSY,请按 Retry-After 指定的秒数等待,再重发原签名。交易确认后仍可能返回 HTTP 404 和 PERPETUAL_GACHA_SUBPACK_RECORD_NOT_FOUND。再次签名前请先核对钱包活动和当前报价。

授权

x-builder-api-key
string
header
必填

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

请求体

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

响应

成功

txHash
string
必填

带 0x 前缀的十六进制字符串。

totalAmountInUsdt
string
必填
Pattern: ^[0-9]+$
itemCount
integer
必填
必填范围: x >= 1