跳转到主要内容
POST
提交一次已准备好的 EOA 兑换
兑换完成后,所选 NFT 会被销毁。付款只需提交一次。若连接中断,使用原准备 ID 查询结账结果。重复使用同一 ID 会返回已记录的状态。结账成功后会创建兑换订单。发货和物流进度请查看订单。

请求

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

响应

HTTP 200 可能返回 status: "failed",且没有原因码。若状态为 failed 或 submitting,再次付款前请先使用原 preparationId 查询结果。

错误码

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

授权

x-builder-api-key
string
header
必填

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

Authorization
string
header
必填

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

请求体

application/json
preparationId
string<uuid>
必填
signature
string
必填
Pattern: ^0x(?:[a-fA-F0-9]{128}|[a-fA-F0-9]{130})$

响应

成功

requestId
string
必填
status
enum<string>
必填
可用选项:
prepared,
submitting,
succeeded,
failed
transactionHash
string