inquiryRefund

2026-05-15 09:30

POST /v2/payments/inquiryRefund

调用 inquiryRefund 接口来查询退款状态。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：

请求参数

参数名称	类型	是否必需	描述
refundId	String	是	refund 接口返回的退款 ID。

响应参数

参数名称	类型	是否必需	描述
refundId	String	是	退款 ID。
result	Result	是	接口调用的结果。
refundStatus	String	是	退款状态。用于表示退款的最终状态。有效值为： `SUCCESS`：表示退款成功。 `FAILED`：表示退款失败。 `PENDING`：表示退款正在处理中。
refundTime	String	否	退款完成时间。
paymentId	String	是	支付 ID。

Result

参数名称	类型	是否必需	描述
resultStatus	String	是	结果状态。有效值为： `S`：成功 `F`：失败 `U`：未知
resultCode	String	否	结果码。（最大长度：64 个字符）
resultMessage	String	否	详细描述结果码的结果消息。（最大长度：256 个字符）

结果码

结果码	状态码	结果信息	后续操作
`SUCCESS`	`S`	成功	无需后续操作。
`DPOS_PAYMENT_ACCESS_DENIED`	`F`	访问被拒绝。	请联系 Antom 技术支持以获取详细原因。
`DPOS_PAYMENT_CURRENCY_NOT_SUPPORT`	`F`	币种不受支持。	请联系 Antom 技术支持以获取详细原因。
`DPOS_PAYMENT_INVALID_MERCHANT_STATUS`	`F`	由于存在限制，商户状态异常。	请联系 Antom 技术支持以获取详细原因。
`DPOS_PAYMENT_ORDER_NOT_EXIST`	`F`	订单不存在。	检查 paymentId 是否正确。如果正确，请联系 Antom 技术支持以获取具体原因。
`DPOS_PAYMENT_ORDER_STATUS_INVALID`	`F`	订单状态无效。交易正在进行中或交易失败。	检查订单状态并采取相应操作。如果交易正在处理中，请等待。如果交易失败，不要发起退款。请具体原因联系 Antom 技术支持。
`DPOS_PAYMENT_REPEAT_REQ_INCONSISTENT`	`F`	金额或币种与先前请求不同。	确保请求中的所有字段相同，或使用新的 paymentRequestId 重新发起退款。
`DPOS_PAYMENT_RISK_REJECT`	`F`	因风险控制，请求被拒绝。	提示买家请求被拒绝，因为风险控制失败。
`DPOS_PAYMENT_ORDER_IS_CANCELED`	`F`	交易已取消。	交易已取消，无法退款。
`DPOS_SYSTEM_ ERROR`	`F`	发生系统错误。	获取 Antom 技术支持前请勿重试。
`DPOS_REFUND_KEY_NOT_FOUND`	`F`	找不到 Antom 或商户的私钥或公钥。	检查私钥或公钥是否存在。如果不存在，请在 Antom 开发者中心上传私钥。
`DPOS_REFUND_MERCHANT_BALANCE_NOT_ENOUGH`	`F`	商户余额不足。	当商家账户余额充足后，再次调用接口。重试时需要修改 refundRequestId 参数。
`DPOS_REFUND_MULTIPLE_REFUNDS_NOT_SUPPORTED`	`F`	由于合同限制，不支持多次退款。	检查是否存在多个退款。不要再调用退款接口。每个退款请求仅调用一次接口。
`DPOS_REFUND_NO_INTERFACE_DEF`	`F`	接口未定义。	检查链接是否正确。请参考接口文档中的端点。
`DPOS_REFUND_INVALID_API`	`F`	调用的接口无效或未激活。	请联系 Antom 技术支持解决此问题。
`DPOS_REFUND_PROCESS_FAIL`	`F`	发生了常见的业务失败。	获取 Antom 技术支持前请勿重试。
`DPOS_REFUND_REFUND_AMOUNT_EXCEED`	`F`	退款总额超过了支付金额。	确认退款总额是否超过支付金额。创建一个金额小于或等于支付金额的新退款，或联系 Antom 技术支持。
`DPOS_REFUND_REFUND_WINDOW_EXCEED`	`F`	退款日期超过了合同约定的退款期限。	确认退款日期是否超过可退款期限。在合同中查看可退款期限，或联系 Antom 技术支持获取具体可退款期限。
`DPOS_REFUND_REQUEST_TRAFFIC_EXCEED_LIMIT`	`F`	请求流量超过限制。	再次调用接口来解决问题。如果问题未解决，请联系 Antom 技术支持。
`DPOS_REFUND_REFUND_IN_PROCESS`	`U`	退款正在处理中。	等待异步通知或调用 inquiryRefund 接口查询最终退款状态。请勿重试退款请求。
`DPOS_REFUND_REFUND_NOT_SUPPORT`	`F`	该交易不支持退款。	检查交易状态和合同中的退款政策。如果交易成功且合同允许退款，请联系 Antom 技术支持。
`DPOS_REFUND_PARTIAL_REFUND_NOT_SUPPORTED`	`F`	该交易不支持部分退款。	进行全额退款或与买家协商线下退款。
`DPOS_REFUND_PAYMENT_METHOD_NOT_SUPPORTED`	`F`	支付状态成功时，支付方式不支持取消或退款交易。	获取 Antom 技术支持前请勿重试。
`DPOS_REFUND_UNKNOWN_EXCEPTION`	`U`	由于未知原因，接口调用失败。	再次调用接口以解决问题。如果未解决，请联系 Antom 技术支持。

示例

以下代码展示了一个请求报文：

copy
{
    "refundId": "20260410194010890100111910209******",
}

以下代码展示了一个响应报文：

copy
{
    "refundId": "20260410194010890100111910209******",
    "refundRequestId": "2026040919452311010022209B******",
    "refundStatus": "SUCCESS",
    "refundTime": "2026-04-10T03:04:44Z",
    "result": {
        "resultCode": "SUCCESS",
        "resultMessage": "Success.",
        "resultStatus": "S"
    }
}