视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

增加用戶記錄API

最新更新時(shí)間：2020.06.04 版本說(shuō)明


當(dāng)用戶在商戶側(cè)消費(fèi)時(shí)，用戶完成了微信先享卡的目標(biāo)或者獲取使用優(yōu)惠時(shí)，商戶需要把這個(gè)信息同步給微信先享卡平臺(tái)，用于在微信先享卡小程序展示及先享卡到期后的用戶結(jié)算。

接口說(shuō)明

適用對(duì)象：直連商戶

請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/discount-card/cards/{out_card_code}/add-user-records

請(qǐng)求方式：POST

接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml


path 指該參數(shù)為路徑參數(shù)

query 指該參數(shù)為URL參數(shù)

body 指該參數(shù)需在請(qǐng)求JSON傳參


請(qǐng)求參數(shù)

參數(shù)名 變量 類型[長(zhǎng)度限制] 必填 描述
商戶領(lǐng)卡號(hào) out_card_code string[1,32] 是 path 商戶在請(qǐng)求領(lǐng)卡預(yù)受理接口時(shí)傳入的領(lǐng)卡請(qǐng)求號(hào)，同一個(gè)商戶號(hào)下必須唯一，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫(xiě)字母_-|*
示例值：6e8369071cd942c0476613f9d1ce9ca3
先享卡模板ID card_template_id string[1,64] 是 body 先享卡卡模板ID，唯一定義此資源的標(biāo)識(shí)。創(chuàng)建模板后可獲得。
示例值：87789b2f25177433bcbf407e8e471f95
+ 目標(biāo)完成記錄 objective_completion_records array 否 body 用戶完成的目標(biāo)明細(xì)列表。
特殊規(guī)則：限制僅提交1條
參數(shù)名 變量 類型[長(zhǎng)度限制] 必填 描述
目標(biāo)完成流水號(hào) objective_completion_serial_no string[1,32] 是 目標(biāo)流水號(hào)，由商戶側(cè)生成，由數(shù)字、字母組成，由商戶側(cè)保證商戶系統(tǒng)內(nèi)全局唯一性，用于做目標(biāo)同步時(shí)的冪等判斷。
示例值：578354545
目標(biāo)ID objective_id string[1,32] 是 微信先享卡為每個(gè)先享卡目標(biāo)分配的唯一ID。
示例值：123456
目標(biāo)完成時(shí)間 completion_time string[1,32] 是 用戶履約行為發(fā)生的時(shí)間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開(kāi)頭，HH:mm:ss.sss表示時(shí)分秒毫秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35.120+08:00表示北京時(shí)間2015年05月20日13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00
目標(biāo)完成類型 completion_type string[1,8] 是 目標(biāo)完成類型，枚舉值：?
INCREASE：增加數(shù)量，表示用戶發(fā)生了履約行為
DECREASE：減少數(shù)量，表示取消用戶的履約行為（例如用戶取消購(gòu)買、退貨退款等）
示例值：INCREASE
目標(biāo)完成描述 description string[1,20] 是 用戶本次履約的描述。
示例值：購(gòu)買商品
目標(biāo)完成數(shù)量 completion_count int 是 用戶本次履約的數(shù)量，必須大于0。
示例值：1
備注說(shuō)明 remark string[1,50] 否 對(duì)于用戶履約情況的一些補(bǔ)充信息。
示例值：特價(jià)商品
+ 優(yōu)惠使用記錄 reward_usage_records array 否 body 優(yōu)惠使用記錄列表。
特殊規(guī)則：限制僅提交1條
參數(shù)名 變量 類型[長(zhǎng)度限制] 必填 描述
優(yōu)惠使用記錄流水號(hào) reward_usage_serial_no string[1,32] 是 商戶側(cè)生成，由數(shù)字、字母組成，由商戶側(cè)保證商戶系統(tǒng)內(nèi)全局唯一性，用于做獎(jiǎng)勵(lì)同步時(shí)的冪等判斷。
示例值：578354
優(yōu)惠ID reward_id string[1,32] 是 微信先享卡為每個(gè)先享卡優(yōu)惠分配的唯一ID
示例值：123456
優(yōu)惠使用時(shí)間 usage_time string[1,32] 是 用戶使用優(yōu)惠的時(shí)間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開(kāi)頭，HH:mm:ss.sss表示時(shí)分秒毫秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35.120+08:00表示北京時(shí)間2015年05月20日13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00
優(yōu)惠使用類型 usage_type string[1,8] 是 目標(biāo)完成類型，枚舉值：?
INCREASE：增加數(shù)量，表示用戶發(fā)生了履約行為
DECREASE：減少數(shù)量，表示取消用戶的履約行為（例如用戶取消購(gòu)買、退貨退款等）
示例值：INCREASE
優(yōu)惠使用描述 description string[1,20] 是 用戶獲得獎(jiǎng)勵(lì)的描述
示例值：購(gòu)買商品
數(shù)量 usage_count int 是 用戶本次獲得的獎(jiǎng)勵(lì)數(shù)量，必須大于0。
示例值：1
金額 amount int64 是 1、優(yōu)惠金額，用戶此項(xiàng)本次享受的優(yōu)惠對(duì)應(yīng)的優(yōu)惠總金額，單位：分，必須大于0。
2、子優(yōu)惠已享金額累計(jì)≤創(chuàng)建模板時(shí)配置的此子優(yōu)惠的價(jià)值金額 例如：優(yōu)惠為【滿10元減3元優(yōu)惠券4張】時(shí)，用戶一次消費(fèi)使用了2張優(yōu)惠券，優(yōu)惠金額為本次優(yōu)惠總金額6元，優(yōu)惠數(shù)量為本次使用優(yōu)惠的優(yōu)惠券數(shù)量2張
示例值：100
備注說(shuō)明 remark string[1,50] 否 對(duì)于用戶獎(jiǎng)勵(lì)情況的一些補(bǔ)充信息
示例值：特價(jià)商品

請(qǐng)求示例


{
  "card_template_id" : "87789b2f25177433bcbf407e8e471f95",
  "reward_usage_records" : [ {
    "usage_count" : 100,
    "amount" : 1,
    "usage_type" : "INCREASE",
    "usage_time" : "2015-05-20T13:29:35.120+08:00",
    "reward_usage_serial_no" : "578354",
    "description" : "購(gòu)買商品",
    "reward_id" : "123456",
    "remark" : "特價(jià)商品"
  }],
  "objective_completion_records" : [ {
    "completion_time" : "2015-05-20T13:29:35.120+08:00",
    "objective_completion_serial_no" : "578354545",
    "description" : "購(gòu)買商品/取消購(gòu)買商品",
    "completion_count" : 1,
    "remark" : "特價(jià)商品",
    "completion_type" : "INCREASE",
    "objective_id" : "123456"
  }, {
    "completion_time" : "2015-05-20T13:29:35.120+08:00",
    "objective_completion_serial_no" : "578354545",
    "description" : "購(gòu)買商品/取消購(gòu)買商品",
    "completion_count" : 1,
    "remark" : "特價(jià)商品",
    "completion_type" : "INCREASE",
    "objective_id" : "123456"
  } ]
}


    
｛
JAVA示例代碼
｝

返回參數(shù)

204
處理成功，應(yīng)答無(wú)內(nèi)容


返回示例


無(wú)數(shù)據(jù)（Http狀態(tài)碼為204）
                                

    http://2323weixin.qq.com

錯(cuò)誤碼公共錯(cuò)誤碼

狀態(tài)碼 錯(cuò)誤碼 描述 解決方案
500 SYSTEM_ERROR 系統(tǒng)錯(cuò)誤 5開(kāi)頭的狀態(tài)碼都為系統(tǒng)問(wèn)題，請(qǐng)使用相同參數(shù)稍后重新調(diào)用
400 PARAM_ERROR 參數(shù)錯(cuò)誤 根據(jù)錯(cuò)誤提示，傳入正確參數(shù)
404 RESOURCE_NOT_EXISTS 訂單不存在，請(qǐng)檢查訂單號(hào)是否正確 請(qǐng)傳入正確的訂單號(hào)
400 INVALID_REQUEST 請(qǐng)求參數(shù)符合參數(shù)格式，但不符合業(yè)務(wù)規(guī)則 當(dāng)前狀態(tài)無(wú)需操作
401 SIGN_ERROR 簽名驗(yàn)證失敗 請(qǐng)檢查簽名參數(shù)和方法是否都符合簽名算法要求
403 NO_AUTH 權(quán)限異常 請(qǐng)開(kāi)通商戶號(hào)相關(guān)權(quán)限，請(qǐng)聯(lián)系產(chǎn)品或商務(wù)申請(qǐng)
429 FREQUENCY_LIMITED 請(qǐng)求超過(guò)頻率限制 請(qǐng)求未受理，請(qǐng)降低頻率后重試

版本說(shuō)明

關(guān)閉
V1.0
2020.03.26
1. 更新先享卡訂單接口上線

技術(shù)咨詢

文檔反饋