淘宝开放平台

登录
文档中心 > API类目 > 海南离岛免税api

海南离岛免税api

qimen.alibaba.gdfc.points.refundcalc (退款积分渲染)

退款申请时，查询并计算用户可退/需补扣的积分数额

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
refundOrderInfo OrderDO 必须 退款单信息
  • └ orderId
  • String
  • 必须
  • 123
  • 原正向订单id
  • items
  • ItemDO []
  • 可选
  • 子单商品
  • └ totalPrice
  • Number
  • 可选
  • 100
  • 总金额。无小数位，保留到分位。如500，等于5元
  • └ qty
  • Number
  • 可选
  • 2
  • 件数
  • └ outerItemId
  • String
  • 可选
  • 123
  • 外部商品id
  • └ id
  • String
  • 可选
  • 123
  • 商品id
  • └ extraInfo
  • String
  • 可选
  • {}
  • 备注
outerUserId String 可选 12305 外部用户id
userId String 必须 123 用户id
traceId String 可选 123 123
dutyfreeType String 可选 11 免税店铺业务类型

响应参数

名称 类型 示例值 描述
data Data 返回对象
  • └ maxRefundMoney
  • Number
  • 1000
  • 最大可退金额
  • └ deductPrice
  • Number
  • -100
  • 积分余额不足抵扣，需要使用现金抵扣的金额
  • └ extraInfo
  • String
  • JSONString
  • 备注-可返回erp系统的查询token，如特殊场景的sellPayments等
success Boolean true 请求成功标识
respMsg String succ 错误描述
respCode String 200 错误码

请求示例

{"traceId":"123","refundOrderInfo":{"orderId":"123","items":[{"outerItemId":"123","totalPrice":100,"qty":2,"id":"123","extraInfo":"{}"}]},"dutyfreeType":"11","outerUserId":"12305","userId":"123"}

响应示例

{
    "data":{
        "maxRefundMoney":1000,
        "deductPrice":-100,
        "extraInfo":"JSONString"
    },
    "success":true,
    "respMsg":"succ",
    "respCode":"200"
}

验签示例

{"success":"false","respMsg":"Illegal request","respCode":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案
isp.http-read-timeout

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部