Taypay v1

发起退款接口

Taypay v1 发起退款接口说明与示例。

发起退款接口

POST /api/payment/open/v1/refund/create
Content-Type: application/json

当前版本只支持全额退款。

请求参数

字段	类型	必填	说明
app_id	string	是	商户应用 ID。
merchant_order_no	string	是	商户订单号。
refund_no	string	是	商户退款单号。
amount	string	是	退款金额, 当前版本要求全额退款。
reason	string	否	退款原因。
timestamp	integer	是	秒级时间戳。
nonce	string	是	请求随机串。
sign_type	string	是	固定为 `HMAC-SHA256`。
sign	string	是	签名值。

请求示例:

{
  "app_id": "your_app_id",
  "merchant_order_no": "M202605220001",
  "refund_no": "R202605220001",
  "amount": "99.00",
  "reason": "用户申请退款",
  "timestamp": 1779465690,
  "nonce": "random_refund_nonce",
  "sign_type": "HMAC-SHA256",
  "sign": "generate_by_app_secret"
}

响应参数

字段	类型	说明
code	integer	业务响应码, `0` 表示成功。
message	string	响应说明。
data	object	退款结果。
data.refund_no	string	商户退款单号。
data.platform_order_no	string	平台订单号。
data.merchant_order_no	string	商户订单号。
data.amount	string	退款金额。
data.status	string	退款状态。

响应示例:

{
  "code": 0,
  "message": "success",
  "data": {
    "refund_no": "R202605220001",
    "platform_order_no": "EP202605220001",
    "merchant_order_no": "M202605220001",
    "amount": "99.00",
    "status": "processing"
  }
}

编辑此页面

关闭订单接口

Taypay v1 关闭订单接口说明与示例。

支付通知

Taypay v1 支付通知回调格式和处理要求。