適用對象: 直連商戶
請求URL:https://api.mch.weixin.qq.com/v3/marketing/busifavor/callbacks
請求方式:GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
商戶號 | mchid | string[8,15] | 否 | query 微信支付商戶的商戶號,由微信支付生成并下發(fā),不填默認查詢調用方商戶的通知URL。 示例值:10000098 |
https://api.mch.weixin.qq.com/v3/marketing/busifavor/callbacks?mchid=10000098
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
通知URL地址 | notify_url | string[10,256] | 是 | 商戶提供的用于接收商家券事件通知的url地址,必須支持https。 示例值:http://www.tg885.com |
商戶號 | mchid | string[8,15] | 是 | 微信支付商戶的商戶號,由微信支付生成并下發(fā)。 示例值:10000098 |
{
"mchid": "10000098",
"notify_url": "http://www.tg885.com"
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 查看具體錯誤信息,調整參數(shù) |
400 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 請使用相同參數(shù)稍后重新調用 |
400 | RESOURCE_ALREADY_EXISTS | 批次已存在 | 查看out_request_no字段是否重復使用 |
券已被其他訂單核銷 | 請通過查詢券API確認券是否已被其他訂單核銷 | ||
404 | RESOURCE_NOT_EXISTS | 查詢的資源不存在 | 請檢查查詢資源的對應id是否填寫正確 |
403 | NOAUTH | 無權限 | 查看具體錯誤信息,確認是否有權限 |
400 | APPID_MCHID_NOT_MATCH | appid與請求方商戶無關聯(lián)關系 | appid與請求方商戶不匹配,請確認appid與請求方商戶是否有關聯(lián)關系 |
400 | MCH_NOT_EXISTS | 商戶號不存在 | 請確認傳入的商戶號是否正確 |
404 | USER_NOT_EXISTS | openid不正確 | 請確認傳入的openid是否正確 |
500 | SYSTEM_ERROR | 系統(tǒng)失敗 | 多為網(wǎng)絡超時引起,重試 |
429 | FREQUENCY_LIMITED | 頻率限制 | 調用太頻繁,請降低調用接口頻率 |
403 | RULELIMIT | 券不在有效期 | 請確認券是否能在當前時間核銷 |
400 | INVALID_REQUEST | 發(fā)券模式不合法 | 請更換支持預上傳code的批次后重試 |
上傳的自定義code已達上限 | 請更換一個新的批次后重試 |