• 简体中文
  • 退款(预授权卡支付)

    适用市场:ZA 南非

    请求路径

    /api/v2/payment/merchant/refund

    对已捕获的卡支付订单发起退款,将已结算资金通过原卡退回持卡人账户。仅适用于Capture单状态 orderStatus = 2 (succeeded) 的订单。

    前置条件:订单 orderStatus = 2 (succeeded) 时方可调用。

    ⚠️ 预授权未捕获时请使用 [Cancel] 取消授权,不要调用 Refund。

    请求参数

    参数类型必填说明
    originOrderNostring是原捕获订单的平台订单号
    orderIdstring是商户唯一订单号
    notifyUrlstring否退款结果异步通知地址
    nonceStrstring是随机字符串(参与签名)
    requestTimeinteger是Unix 秒时间戳
    versionstring是2.0.0.0

    是 必填 · 否 选填

    返回值

    字段说明
    orderNo退款订单号(PalmPay 生成)
    orderId商户订单号(回显)
    orderStatus1 (pending) = 异步处理中,最终结果需查询或等通知
    amount退款金额(分)

    示例

    请求 / 响应

    curl 'https://open-gw-daily.palmpay-inc.com/api/v2/payment/merchant/refund' \
      -H 'CountryCode: ZA' -H 'Authorization: Bearer xxx' -H 'Content-Type: application/json' \
      -d '{"originOrderNo":"24260608092828582939","orderId":"testc9ffae997fc1",
           "notifyUrl":"/callback","nonceStr":"xxx","requestTime":16999258500,"version":"2.0.0.0"}'
    {
      "respCode": "00000000",
      "respMsg": "success",
      "status": true,
      "data": {
        "orderNo": "2424220903032435363613",
        "orderId": "testc9ffae997fc1",
        "orderStatus": 1,
        "amount": 1000
      }
    }