跳转到主要内容
GET
查询已提交的实物兑换状态
结账中断后,使用原 preparationId 查询结果。订单生成后,用 requestId 查看配送详情。

请求

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

响应

即使 HTTP 为 200,也要读取结账 status。收到 failed 或 submitting 时,请用原准备 ID 核对状态再决定是否重新付款。

错误码

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

授权

x-builder-api-key
string
header
必填

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

Authorization
string
header
必填

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

路径参数

preparationId
string<uuid>
必填

响应

成功

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