帮助中心

5004-礼品卡退卡(款)

2019-10-17

接口编号:5004

接口说明:

礼品卡退卡(款)接口 

当用户购买礼品卡后想要退卡时,门店POS系统可以通过该接口退掉用户的礼品卡并将钱原路退回到用户微信支付账户或银行卡中,退卡成功后礼品卡的状态变为已失效并在列表中沉底并不再被使用。

注意事项:

礼品卡退款条件:必须是未使用并且持卡人为购买人的退款,持卡人非购买人的退款(持卡人发起退款和购买人发起退款)暂不支持

储值礼品卡退款条件:未使用和已使用的并且持卡人为购买人的退款,持卡人非购买人的退款(持卡人发起退款和购买人发起退款)

礼品卡的退卡(款)审核流程分为:自动审核和手工审核(默认为手工审核,如需改为自动审核请联系驿氪技术人员)

手工审核
1.生成一张礼品卡退款单并提交CRM系统审核(审核过程中可能要根据退卡章程收取退卡的手续费)
2.审核成功要调用微信更改礼品卡余额接口将礼品卡余额清零
(非储值礼品卡跳过),然后调用微信礼品卡核销接口或者设置礼品卡失效接口使储值礼品卡失效,最后通过Job服务调用微信支付退款接口将余额原路退回到用户微信账户。

自动审核
1.生成一张礼品卡退款单,状态为审核成功
2.调用微信更改礼品卡余额接口将储值礼品卡余额清零(非储值礼品卡跳过)
3.调用微信礼品卡核销接口或者设置礼品卡失效接口使礼品卡失效
4.通过Job服务调用微信支付退款接口将余额原路退回到用户微信账户。

请求说明:

HTTP请求方式:POST

返回数据格式:JSON

请求路径:api/wxgiftcard/ReturnWxGiftCard

请求参数:

  字段
  类型  可否为空  长度  描述
  WxCardCode  string
  否  20  礼品卡Code
  WxCardId  string  是  32  礼品卡ID
  ShopCode  string  否  20  礼品卡使用的门店编码(EZR门店)
  RefundAmount  decimal  是  12,2  礼品卡退款金额(可自定义收取退卡手续费)

请求参数示例代码(json对象):

{
    "WxCardCode": "163650423989862094", 
    "WxCardId": "puMMGs2sXx9Senqn2rt1aMv7SA0o", 
    "ShopCode":"801",
    "RefundAmount":"100.00"
}

系统级返回结果示例(json对象):

{
    "Status": true,
    "StatusCode": 200,
    "Msg": "成功",
    "Timestamp": "20150622093101",
    "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
    "Result": 见业务返回结果示例,
}