查询提现状态

使用此端点按 id 仅查询指定提现的状态。

响应只包含 id 和 status，不含提现的其他数据。需要完整记录时，请使用查询提现。

可用环境

生产环境

https://api.gateway.com.br/core

端点

• 方法：GET
• 端点：/withdrawal/{id}/status
• 认证方式：Bearer token

路径参数

名称	类型	必填	说明	校验规则
id	string (UUID)	是	提现的标识	必须为有效的 UUID

请求示例

cURL

curl --request GET \
--url https://api.gateway.com.br/core/withdrawal/553e8400-e29b-41d4-a716-436251480000/status \
--header 'Authorization: Bearer your-jwt-token'

JavaScript

const response = await fetch('https://api.gateway.com.br/core/withdrawal/553e8400-e29b-41d4-a716-436251480000/status', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer your-jwt-token'
  }
});
const data = await response.json();

成功响应

字段	类型	必填	说明
id	string (UUID)	是	提现的唯一标识
status	string (enum) - PENDING, PROCESSING, PROCESSED, FAILED, CANCELED, REFUNDED, REJECTED, PENDING_COMPLIANCE	是	PENDING：提现已创建，等待处理 PROCESSING：提现处理中 PROCESSED：提现已成功处理 FAILED：处理过程中出错 CANCELED：提现已取消 REFUNDED：提现已退回 REJECTED：提现被网关拒绝 PENDING_COMPLIANCE：提现等待合规审核

响应示例

{
  "id": "553e8400-e29b-41d4-a716-436251480000",
  "status": "PROCESSED"
}

可能的错误

状态码	说明	处理方式
401	凭据无效	请检查您的凭据
403	无权限或未授权	请联系技术支持
404	未找到记录	请检查传入的 id
422	数据无效或缺失	请检查数据格式
422	校验失败	请联系技术支持
500	内部错误	请联系技术支持