发起退款（Payin Refund API）

端点目标 URL

沙盒环境请求地址：POST https://api.futurepay-develop.com/payin/refund

生产环境请求地址：POST https://api.futurepay.global/payin/refund

字段说明

调用的特定输入参数

字段名	类型	是否必填	描述
originalReference	String	是	原交易的FuturePay流水号（唯一标识）
reference	String	是	本次退款的唯一流水号
reason	String	是	退款原因
webhookUrl	String	否	退款结果通知地址，如为空则读取开发者配置的WEBHOOKS配置地址
amount.currency	String	是	币种（如：USD、EUR）
amount.value	Integer	是	金额，单位为最小币种单位（如：分、厘）

{
  "originalReference": "1943512883304464384",
  "reference": "1943560730985009152",
  "reason": "客户要求",
  "amount": {
    "currency": "USD",
    "value": 100
  }
}

调用的特定响应参数

字段名	类型	描述
msg	String	接口消息，通常为 `success`
code	String	状态码，成功为 `"0"`
success	Boolean	接口是否成功（true/false）
serverTime	Long	接口响应时间戳（毫秒）
data.originalReference	String	原始订单号
data.merchantReference	String	商户退款单号（即请求中的 `reference`）
data.pspReference	String	平台退款交易流水号
data.amount.currency	String	币种
data.amount.value	Integer	金额
data.resultCode	String	退款状态，如：`PENDING`, `SUCCEED`, `FAILED`

{
  "msg": "success",
  "code": "0",
  "data": {
    "originalReference": "1943512883304464384",
    "amount": {
      "currency": "USD",
      "value": 100
    },
    "resultCode": "PENDING",
    "merchantReference": "1943560730985009152",
    "pspReference": "1943560731479900160"
  },
  "success": true,
  "serverTime": 1752215962682
}

📘 说明

resultCode 初始状态可能为 PENDING，请轮询或等待异步回调通知最终退款结果。
amount.value 单位为最小货币单位（如 100 表示 1.00 美元）。

如需我补充：签名机制、错误码说明、异步回调格式 或 接口状态机图，可随时告知，我可以进一步完善该文档。