退款凭证
使用此端点按 id 查询某笔提现的退款凭证。
可用环境
- 生产环境
https://api.gateway.com.br/core
端点
- 方法：
POST - 端点：
/withdrawal/{id}/refund/receipt - 认证方式：Bearer token
路径参数
| 名称 | 类型 | 必填 | 说明 | 校验规则 |
|---|---|---|---|---|
id | string (UUID) | 是 | 提现的标识 | 必须为有效的 UUID |
请求示例
- cURL
- JavaScript
curl --request POST \
--url https://api.gateway.com.br/core/withdrawal/553e8400-e29b-41d4-a716-436251480000/refund/receipt \
--header 'Authorization: Bearer your-jwt-token'
const response = await fetch('https://api.gateway.com.br/core/withdrawal/553e8400-e29b-41d4-a716-436251480000/refund/receipt', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-jwt-token'
}
});
const data = await response.json();
成功响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | 提现的标识 |
paymentReceiptUrl | string | 是 | 用于下载或查看退款凭证的地址 |
expirationDate | string (ISO) | 否 | 凭证的过期时间 |
响应示例
{
"id": "553e8400-e29b-41d4-a716-436251480000",
"paymentReceiptUrl": "https://files.exemplo.com.br/receipts/refund-withdrawal-553e8400-e29b-41d4-a716-436251480000.pdf",
"expirationDate": "2026-04-01T00:00:00.000Z"
}
可能的错误
| 状态码 | 说明 | 处理方式 |
|---|---|---|
| 401 | 凭据无效 | 请检查您的凭据 |
| 403 | 无权限或未授权 | 请联系技术支持 |
| 404 | 未找到提现或退款凭证 | 请检查传入的 id |
| 422 | 数据无效或缺失 | 请检查数据格式 |
| 500 | 内部错误 | 请联系技术支持 |