跳到主要内容

查询退款

开放待确认。 查看适用范围。

对象与完整字段 · 认证、金额与错误 · 接入指南

GET /v1/refunds/{id}

查询一笔退款的当前状态、签名入口及最近执行错误,可用于恢复签名页面展示或核对退款结果。

Attributes​

属性位置类型必填说明
idpathstring是退款的唯一标识

仅允许查询当前商户的退款。退款不存在或无权访问时,统一返回 404,错误响应沿用通用约定。本接口无需 Idempotency-Key,无请求体。

请求示例​

GET /v1/refunds/re_example
Authorization: Bearer inv_test_...

返回示例​

200 OK,返回完整的 Refund 对象。以下示例表示退款已成功,商户无需再进行钱包操作。

{
"id": "re_example",
"attempt_id": "8b8fbb6b-4ec7-48d1-92a1-3b20c24b0c21",
"payment_intent": "pi_example",
"amount": "2.5",
"currency": "usdc",
"status": "succeeded",
"payment_method": {
"type": "erc20_transfer",
"erc20_transfer": {
"chain": 56,
"recipient_address": "0x1234567890abcdef1234567890abcdef12345678"
}
},
"next_action": null,
"last_execution_error": null,
"description": "Price adjustment",
"metadata": {
"return_id": "RETURN_001"
},
"created_at": "2026-10-27T08:00:00Z",
"updated_at": "2026-10-27T08:05:00Z"
}

业务错误码