退款 API

Ask AI

端点合约

为已完成的交易发起退款。

POST /v2/refundapplication/json需要签名

请求

字段	类型	必填	描述
transactionId	String (ULID)	M	原始 GLODIPAY 交易 ID。
amount	Float	M	退款金额。最小 0.10，且受剩余可退款金额限制。
reason	String(max:1000)	O	简短的退款原因。
signature	String(max:750)	M	RSA-MD5 签名。

响应

成功的响应将返回 status, message, 以及一个包含 refundId 和 refundNumber 的 data 对象。验证错误返回 HTTP 422（带有 status: error 和 errors 数组）。

自动处理的退款： message 为 null。

等待批准： message 为 "Refund created and waiting for approval."

注意：某些提供商（PayAgency, SmartPay, ClisaPay, FinvyPay, WPay）仅支持全额退款。网关会相应地执行最小退款金额规则。

退款状态更新将发送到原始交易的 Webhook URL，并且必须在 30 秒内使用 {"returnCode":"100"} 进行确认。

来源

此页面派生自 退款 API。