Skip to main content
GET
查询一笔退款

授权

Authorization
string
header
必填

会话 JWT(来自注册/登录)或 API key(pk_...)。 也接受 X-API-Key: <token> 作为替代请求头。

路径参数

refundID
string<uuid>
必填

响应

该退款。

refund_id
string<uuid>
payin_id
string<uuid>
account_id
string<uuid>
kind
enum<string>

chargeback 由发卡机构强制发起 —— 会自动记账,并可能使余额变为负数。

可用选项:
refund,
void,
chargeback
status
enum<string>
可用选项:
pending,
completed,
failed
currency
string

原始收款的货币。

local_amount
string
usdt_debited
string

从 USDT 余额中扣除的金额。原收款的手续费与汇率点差不予退还。

requested_by
enum<string>
可用选项:
account,
admin,
issuer
reason
string
failure_reason
string

statusfailed 时出现 —— 扣款已全额冲回。

idempotency_key
string
idempotency_hit
boolean
reconciliation_required
boolean

退款处于 pending 期间出现 —— 结果由对账流程解决,绝不会重新下发。

balance_after
string

出现在 payin_refunded webhook 中 —— 该笔变动后的 USDT 余额(拒付时可能为负)。

receipt_url
string
created_at
string<date-time>
updated_at
string<date-time>
最后修改于 2026年8月22日