交易通知
注意:
(1)交易通知接口是交易成功完成后會(huì)向 notify_url這個(gè)地址(主掃交易或者被掃交易請(qǐng)求中的notify_url字段)發(fā)起交易結(jié)果通知。拉卡拉系統(tǒng)通知時(shí),如果商戶(hù)的應(yīng)答沒(méi)有按照以下“響應(yīng)參考報(bào)文”示例返回成功狀態(tài)時(shí),則系統(tǒng)認(rèn)為通知失敗,系統(tǒng)會(huì)通過(guò)一定的策略定期重新發(fā)起通知。
(2)同樣的通知可能會(huì)多次發(fā)送給商戶(hù)系統(tǒng),商戶(hù)系統(tǒng)必須能夠正確處理重復(fù)的通知。
(3)在沒(méi)有收到拉卡拉支付交易通知的情況下,建議商戶(hù)主動(dòng)調(diào)用【06查詢(xún)】確認(rèn)交易狀態(tài)。
(4)被掃交易如果交易接口實(shí)時(shí)返回成功結(jié)果,則不再通過(guò)該接口發(fā)出交易通知;只有沒(méi)有實(shí)時(shí)返回成功結(jié)果時(shí),才會(huì)通過(guò)該接口發(fā)出交易通知。
請(qǐng)求報(bào)文
| 字段名 | 中文名稱(chēng) | 是否必填 | 類(lèi)型 | 說(shuō)明 |
|---|
| out_trade_no | 商戶(hù)請(qǐng)求流水號(hào) | M | String(32) |
|
| settle_channel_type | 結(jié)算渠道類(lèi)型 | M | String(16) | 微信:WECHAT 支付寶:ALIPAY 拉卡拉:LAKALA |
| trade_no | 拉卡拉交易流水號(hào) | M | String(32) | 拉卡拉交易流水號(hào) |
| acc_merchant_trade_no | 賬戶(hù)端商戶(hù)交易流水號(hào) | M | String(32) | 賬戶(hù)端商戶(hù)交易流水號(hào) |
| acc_trade_no | 賬戶(hù)端交易訂單號(hào) | M | String(32) | 賬戶(hù)端交易訂單號(hào) |
| account_type | 錢(qián)包類(lèi)型 | M | String(32) | 微信:WECHAT 支付寶:ALIPAY 銀聯(lián):UQRCODEPAY 微企付:ENTPAY |
| trade_state | 交易狀態(tài) | M | String(16) | INIT-初始化 CREATE-下單成功 SUCCESS-交易成功 FAIL-交易失敗 DEAL-交易處理中 UNKNOWN-未知狀態(tài) CLOSE-訂單關(guān)閉 PART_REFUND-部分退款 REFUND-全部退款 REVOKED-訂單撤銷(xiāo) |
| total_amount | 訂單金額 | M | String(12) | 單位分,整數(shù)數(shù)字型字符 |
| payer_amount | 付款人實(shí)付金額 | C | String(12) | 付款人實(shí)付金額,單位分 |
| acc_settle_amount | 賬戶(hù)端結(jié)算金額 | C | String(12) | 賬戶(hù)端應(yīng)結(jié)訂單金額,單位分 |
| acc_mdiscount_amount | 商戶(hù)側(cè)優(yōu)惠金額(賬戶(hù)端) | C | String(12) | 商戶(hù)優(yōu)惠金額,單位分 |
| acc_discount_amount | 賬戶(hù)端優(yōu)惠金額 | C | String(12) | 拉卡拉優(yōu)惠金額,單位分 |
| trade_time | 交易完成時(shí)間 | C | String(14) | 實(shí)際支付時(shí)間。yyyyMMddHHmmss |
| user_id1 | 用戶(hù)標(biāo)識(shí)1 | C | String(128) | 微信sub_open_id 支付寶buyer_logon_id(買(mǎi)家支付寶賬號(hào)) |
| user_id2 | 用戶(hù)標(biāo)識(shí)2 | C | String(128) | 微信openId 支付寶buyer_user_id |
| acc_resp_fields | 賬戶(hù)端返回信息域 | C | Object | 賬戶(hù)端返回信息域 |
支付寶返回的accRespFields域
| 字段名 | 說(shuō)明 | 必選 |
| 備注 |
|---|
| user_id | 買(mǎi)家在支付寶的用戶(hù)id | M | String(64) | buyer_user_id |
| alipay_store_id | 支付寶的店鋪編號(hào) | C | String(32) |
|
| fund_bill_list | 交易支付使用的資金渠道 | C | String(4096) |
|
| discount_goods_detail | 單品券優(yōu)惠的商品優(yōu)惠信息 | C | String(4096) |
|
| voucher_detail_list | 本交易支付時(shí)使用的所有優(yōu)惠券信息 | C | String(4096) |
|
| enterprise_pay_info | 企業(yè)支付信息 | C | String(1024) |
|
微信返回的accRespFields域
| 字段名 | 說(shuō)明 | 必選 |
| 備注 |
|---|
| openid | openId | M | String(64) |
|
| sub_openid | subOpenId | C | String(64) |
|
| promotion_detail | 優(yōu)惠功能信息 | C | String(4096) |
|
銀聯(lián)二維碼返回的accRespFields域
| 字段名 | 說(shuō)明 | 必選 |
| 備注 |
|---|
| user_id | 用戶(hù)id | M | String(64) |
|
| up_iss_addn_data | 銀聯(lián)單品營(yíng)銷(xiāo) 附加數(shù)據(jù) | C | String(8000) | 參與單品營(yíng)銷(xiāo)優(yōu)惠時(shí)返回 |
| up_coupon_info | 銀聯(lián)優(yōu)惠信息/出資方信息 | C | String(500) | 參與單品營(yíng)銷(xiāo)優(yōu)惠時(shí)返回 |
響應(yīng)報(bào)文參考
{
"code": "SUCCESS",
"message": "接收成功"
}
復(fù)制