创建退款
创建退款。charge 与 payment_id 必须二选一且不能同时传：普通支付退款传 charge，表示要退款的普通支付 ID；订阅退款传 payment_id，表示订阅账单产生的支付 ID。新建退款当前进入 processing 状态。
Documentation Index
Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt
Use this file to discover all available pages before exploring further.
授权
Bearer API Key，例如 Bearer sk_live_xxx。
Unix 时间戳（秒）。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串，长度 16-64 个字符，建议每次请求使用新的 UUID。
使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256，结果为小写 hex。GET 请求的 requestBody 为空字符串。
请求头
Unix 时间戳（秒）。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串，长度 16-64 个字符，建议每次请求使用新的 UUID。
16 - 64使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256，结果为小写 hex。GET 请求的 requestBody 为空字符串。
请求体
charge 与 payment_id 必须且只能传一个；不要同时传两个字段。
- 普通支付退款
- 订阅退款
charge 与 payment_id 必须二选一且不能同时传。普通支付退款使用 charge；订阅退款使用 payment_id。
普通支付退款使用。传要退款的普通支付 ID。
商户自定义唯一退款单号，作为幂等键。
退款金额，使用币种最小单位，必须大于 0。
x >= 1退款币种，当前请求结构限制为 USDT 或 USDC。
USDT, USDC 订阅退款使用。传订阅账单产生的支付 ID。
退款原因。
requested_by_customer, duplicate, fraudulent, expired_uncaptured 退款说明。
可选链上退款目标地址。
可选链上退款目标地址 ID；仅大于 0 时生效。
商户自定义元数据。
响应
退款创建成功。
创建退款成功后返回的退款对象。
商户提供的退款单号。
订阅退款场景返回的支付标识。
商户订单 ID，普通支付退款场景返回。
退款金额，使用币种最小单位。
退款币种。
USDT, USDC 退款状态。新建退款当前通常返回 processing。
pending, processing, completed, failed, canceled 退款原因。
requested_by_customer, duplicate, fraudulent, expired_uncaptured 退款说明。
退款创建时间，Unix 秒。
商户自定义元数据。
订阅退款时返回的发票 ID。
订阅退款时返回的订阅 ID。