跳转到主要内容
POST
根据已保存的报价准备 EOA 的 Permit2 兑换
  1. 请钱包持有人核对所选卡牌、收件人、地址、快递和总价。
  2. 使用服务端报价中的费用。准备结账时,这些信息会与当前开发者绑定。
  3. 提交前,请核对钱包授予 Permit2(permitTypedData.domain.verifyingContract)的 USDT 额度,确保足以支付 permitTypedData.message.permitted.amount。额度不足时,请授权所需金额并等待确认。仅签署 witness 不会增加这项额度。
  4. 保存准备 ID,并让钱包签署一份 Permit2 witness 授权。

请求

需要开发者密钥和钱包访问令牌

响应

错误码

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

授权

x-builder-api-key
string
header
必填

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

Authorization
string
header
必填

钱包访问令牌,用于实物兑换的 Bearer 身份验证。

请求体

application/json
quoteId
string<uuid>
必填
courierId
string
必填
recipient
object
必填
insurance
boolean
必填

响应

成功

preparationId
string<uuid>
必填
requestId
string
必填

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

walletAddress
string
必填

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

tokenIds
string[]
必填

每个数值代币 ID 只能出现一次,例如 "1" 与 "01" 表示同一代币。

Required array length: 1 - 50 elements

小于 2^256 的无符号十进制整数,以字符串表示。

Pattern: ^\d{1,78}$
expiresAt
string<date-time>
必填
address
object
必填
recipient
object
必填
courierName
string
必填
fees
object
必填
redemptionTypedData
object
必填
permitTypedData
object
必填