支付結(jié)果通知API(支持單品優(yōu)惠)
場(chǎng)景介紹
支付接口上傳參數(shù)version后，則支付通知也將返回單品信息，同時(shí)取消以下字段返回（轉(zhuǎn)移到新增參數(shù)promotion_detail中，以json方式展示），開(kāi)發(fā)時(shí)請(qǐng)注意：
| 字段名稱 | 字段說(shuō)明 |
|---|---|
代金券使用數(shù)量（coupon_count） |
取消了該參數(shù)返回，我們將展示每張券的具體信息，商戶可以通過(guò)解析promotion_detail參數(shù)來(lái)確認(rèn)使用了幾張代金券。 |
總代金券金額（coupon_fee） |
取消了該參數(shù)返回，返回參數(shù)展示了每張券的金額（amount），商戶可以通過(guò)累加得出總代金券金額。 |
單個(gè)代金券支付金額（coupon_fee_$n） |
與amount對(duì)應(yīng) |
代金券類型（coupon_type） |
與type 對(duì)應(yīng)，COUPON表示普通代金券（原值：CASH），DISCOUNT表示免充值券（原值：NO_CASH） |
代金券id（coupon_id） |
與 promotion_id 對(duì)應(yīng) |
應(yīng)結(jié)訂單金額（settlement_total_fee） |
取消了該參數(shù)返回，商戶可以通過(guò)現(xiàn)有返回參數(shù)計(jì)算出應(yīng)結(jié)訂單金額，應(yīng)結(jié)訂單金額（settlement_total_fee）=訂單總金額（total_fee）-優(yōu)惠類型（type）為免充值券（DISCOUNT）的優(yōu)惠券金額（amount） |
接口地址
該地址是通過(guò)【統(tǒng)一下單API】中提交的參數(shù)notify_url設(shè)置，如果通知url無(wú)法訪問(wèn)，商戶將無(wú)法接收到微信通知，所以通知url必須為直接可訪問(wèn)的url，不能攜帶參數(shù)。示例：notify_url：“http://www.tg885.com/wxpay/pay.action”
是否需要證書(shū)
不需要。
通知參數(shù)
| 名稱 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 其他返回字段列表見(jiàn) | |||||
| 營(yíng)銷詳情 | promotion_detail | 是 | String(6000) | 示例見(jiàn)下文 | 新增返回參數(shù)，請(qǐng)務(wù)必做好通知結(jié)果的簽名驗(yàn)收工作。統(tǒng)一下單API上傳參數(shù)version后才有返回，返回值為Json格式 |
單品優(yōu)惠活動(dòng)promotion_detail字段列表說(shuō)明：
| 名稱 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 券ID | promotion_id | 是 | String(32) | 109519 |
券或者立減優(yōu)惠id |
| 優(yōu)惠名稱 | name | 否 | String(64) | 單品惠-6 |
優(yōu)惠名稱 |
| 優(yōu)惠范圍 | scope | 否 | String(32) | SINGLE |
GLOBAL- 全場(chǎng)代金券 SINGLE- 單品優(yōu)惠 |
| 優(yōu)惠類型 | type | 否 | String(32) | DISCOUNT |
COUPON- 代金券，需要走結(jié)算資金的充值型代金券,（境外商戶券幣種與支付幣種一致） DISCOUNT- 優(yōu)惠券，不走結(jié)算資金的免充值型優(yōu)惠券，（境外商戶券幣種與標(biāo)價(jià)幣種一致 |
| 優(yōu)惠券面額 | amount | 是 | int | 5 | 用戶享受優(yōu)惠的金額 |
| 活動(dòng)ID | activity_id | 是 | String(32) | 931386 |
在微信商戶后臺(tái)配置的批次ID |
| 微信出資 | wxpay_contribute | 否 | int | 0 | 特指由微信支付商戶平臺(tái)創(chuàng)建的優(yōu)惠，出資金額等于本項(xiàng)優(yōu)惠總金額，單位為分 |
| 商戶出資 | merchant_contribute | 否 | int | 0 | 特指商戶自己創(chuàng)建的優(yōu)惠，出資金額等于本項(xiàng)優(yōu)惠總金額，單位為分 |
| 其他出資 | other_contribute | 否 | int | 5 | 其他出資方出資金額，單位為分 |
| +商品列表 | goods_detail | 否 | String | 見(jiàn)下文 | 商品信息，使用Json數(shù)組格式提交,字段詳細(xì)說(shuō)明請(qǐng)點(diǎn)擊行前的+展開(kāi) |
注意：goods_remark為備注字段，按照配置原樣返回，goods_tag是訂單優(yōu)惠標(biāo)記，用于區(qū)分訂單是否可以享受優(yōu)惠，兩個(gè)字段內(nèi)容都在微信后臺(tái)配置券時(shí)進(jìn)行設(shè)置。
promotion_detail字段值舉例如下：
{
"promotion_detail":[
{
"promotion_id":"109519",
"name":"單品惠-6",
"scope":"SINGLE",
"type":"DISCOUNT",
"amount":5,
"activity_id":"931386",
"wxpay_contribute":0,
"merchant_contribute":0,
"other_contribute":5,
"goods_detail":[
{
"goods_id":"a_goods1",
"goods_remark":"商品備注",
"quantity":7,
"price":1,
"discount_amount":4
},
{
"goods_id":"a_goods2",
"goods_remark":"商品備注",
"quantity":1,
"price":2,
"discount_amount":1
}
]
}
]
}