交易退款
使用此端点为已支付的交易申请退款。
可用环境
- 生产环境
https://api.gateway.com.br/core
端点
- 方法：
POST - 端点：
/transaction/{id}/refund - 认证方式：Bearer token
路径参数
| 名称 | 类型 | 必填 | 说明 | 校验规则 |
|---|---|---|---|---|
id | string (UUID) | 是 | 交易的标识 | 必须为有效的 UUID |
请求示例
- cURL
- JavaScript
curl --request POST \
--url https://api.gateway.com.br/core/transaction/553e8400-e29b-41d4-a716-436251480000/refund \
--header 'Authorization: Bearer your-jwt-token'
const response = await fetch('https://api.gateway.com.br/core/transaction/553e8400-e29b-41d4-a716-436251480000/refund', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-jwt-token'
}
});
const data = await response.json();
成功响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string (UUID) | 是 | 交易的标识 |
status | string (enum) - PROCESSING_REFUND | 是 | 退款处理中 |
响应示例
{
"id": "553e8400-e29b-41d4-a716-436251480000",
"status": "PROCESSING_REFUND"
}
可能的错误
| 状态码 | 说明 | 处理方式 |
|---|---|---|
| 401 | 凭据无效 | 请检查您的凭据 |
| 403 | 无权限或未授权 | 请联系技术支持 |
| 404 | 未找到记录 | 请检查传入的 id |
| 422 | 数据无效或缺失 | 请检查数据格式 |
| 422 | 校验失败 | 请联系技术支持 |
| 500 | 内部错误 | 请联系技术支持 |