交易通知
注意:
(1)交易通知接口是交易成功完成后会向 notify_url这个地址(主扫交易或者被扫交易请求中的notify_url字段)发起交易结果通知。拉卡拉系统通知时,如果商户的应答没有按照以下“响应参考报文”示例返回成功状态时,则系统认为通知失败,系统会通过一定的策略定期重新发起通知。
(2)同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。
(3)在没有收到拉卡拉支付交易通知的情况下,建议商户主动调用【06查询】确认交易状态。
(4)被扫交易如果交易接口实时返回成功结果,则不再通过该接口发出交易通知;只有没有实时返回成功结果时,才会通过该接口发出交易通知。
请求报文
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| out_trade_no | 商户请求流水号 | M | String(32) |
|
| settle_channel_type | 结算渠道类型 | M | String(16) | 微信:WECHAT 支付宝:ALIPAY 拉卡拉:LAKALA |
| trade_no | 拉卡拉交易流水号 | M | String(32) | 拉卡拉交易流水号 |
| acc_merchant_trade_no | 账户端商户交易流水号 | M | String(32) | 账户端商户交易流水号 |
| acc_trade_no | 账户端交易订单号 | M | String(32) | 账户端交易订单号 |
| account_type | 钱包类型 | M | String(32) | 微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 微企付:ENTPAY |
| trade_state | 交易状态 | M | String(16) | INIT-初始化 CREATE-下单成功 SUCCESS-交易成功 FAIL-交易失败 DEAL-交易处理中 UNKNOWN-未知状态 CLOSE-订单关闭 PART_REFUND-部分退款 REFUND-全部退款 REVOKED-订单撤销 |
| total_amount | 订单金额 | M | String(12) | 单位分,整数数字型字符 |
| payer_amount | 付款人实付金额 | C | String(12) | 付款人实付金额,单位分 |
| acc_settle_amount | 账户端结算金额 | C | String(12) | 账户端应结订单金额,单位分 |
| acc_mdiscount_amount | 商户侧优惠金额(账户端) | C | String(12) | 商户优惠金额,单位分 |
| acc_discount_amount | 账户端优惠金额 | C | String(12) | 拉卡拉优惠金额,单位分 |
| trade_time | 交易完成时间 | C | String(14) | 实际支付时间。yyyyMMddHHmmss |
| user_id1 | 用户标识1 | C | String(128) | 微信sub_open_id 支付宝buyer_logon_id(买家支付宝账号) |
| user_id2 | 用户标识2 | C | String(128) | 微信openId 支付宝buyer_user_id |
| acc_resp_fields | 账户端返回信息域 | C | Object | 账户端返回信息域 |
支付宝返回的accRespFields域
| 字段名 | 说明 | 必选 |
| 备注 |
|---|
| user_id | 买家在支付宝的用户id | M | String(64) | buyer_user_id |
| alipay_store_id | 支付宝的店铺编号 | C | String(32) |
|
| fund_bill_list | 交易支付使用的资金渠道 | C | String(4096) |
|
| discount_goods_detail | 单品券优惠的商品优惠信息 | C | String(4096) |
|
| voucher_detail_list | 本交易支付时使用的所有优惠券信息 | C | String(4096) |
|
| enterprise_pay_info | 企业支付信息 | C | String(1024) |
|
微信返回的accRespFields域
| 字段名 | 说明 | 必选 |
| 备注 |
|---|
| openid | openId | M | String(64) |
|
| sub_openid | subOpenId | C | String(64) |
|
| promotion_detail | 优惠功能信息 | C | String(4096) |
|
银联二维码返回的accRespFields域
| 字段名 | 说明 | 必选 |
| 备注 |
|---|
| user_id | 用户id | M | String(64) |
|
| up_iss_addn_data | 银联单品营销 附加数据 | C | String(8000) | 参与单品营销优惠时返回 |
| up_coupon_info | 银联优惠信息/出资方信息 | C | String(500) | 参与单品营销优惠时返回 |
响应报文参考
{
"code": "SUCCESS",
"message": "接收成功"
}
复制