拉卡拉聚合扫码-交易通知API

好拓客 6天前 ( 11-13 13:25 ) 51

注意:

(1)交易通知接口是交易成功完成后会向 notify_url这个地址(主扫交易或者被扫交易请求中的notify_url字段)发起交易结果通知。拉卡拉系统通知时,如果商户的应答没有按照以下“响应参考报文”示例返回成功状态时,则系统认为通知失败,系统会通过一定的策略定期重新发起通知。

(2)同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。

(3)在没有收到拉卡拉支付交易通知的情况下,建议商户主动调用【06查询交易】确认交易状态。

(4)被扫交易如果交易接口实时返回成功结果,则不再通过该接口发出交易通知;只有没有实时返回成功结果时,才会通过该接口发出交易通知。

请求报文

字段名中文名称是否必填类型说明
merchant_no商户号MString(32)拉卡拉分配的商户号(交易请求接口中商户号)
out_trade_no商户交易流水号MString(64)
trade_no拉卡拉交易流水号MString(32)拉卡拉交易流水号
log_no拉卡拉对账单流水号MString(14)trade_no的后14位
acc_trade_no账户端交易订单号MString(32)账户端交易订单号
account_type钱包类型MString(32)微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付: BESTPAY 苏宁易付宝: SUNING  数字人民币-DCPAY
settle_merchant_no结算商户号CString(32)拉卡拉分配的商户号
settle_term_no结算终端号CString(32)拉卡拉分配的业务终端号
trade_status交易状态MString(16)INIT-初始化 CREATE-下单成功 SUCCESS-交易成功 FAIL-交易失败 DEAL-交易处理中 UNKNOWN-未知状态 CLOSE-订单关闭 PART_REFUND-部分退款 REFUND-全部退款 REVOKED-订单撤销
total_amount订单金额MString(12)单位分,整数数字型字符
payer_amount付款人实付金额CString(12)付款人实付金额,单位分
acc_settle_amount账户端结算金额CString(12)账户端应结订单金额,单位分 ,账户端应结订单金额=付款人实际发生金额+账户端优惠金额
acc_mdiscount_amount商户侧优惠金额(账户端)CString(12)商户优惠金额,单位分
acc_discount_amount账户端优惠金额CString(12)账户端优惠金额,单位分
acc_other_discount_amount账户端其它优惠金额CString(12)账户端返回账户端其它优惠金额,单位分
trade_time交易完成时间CString(14)实际支付时间。yyyyMMddHHmmss
user_id1用户标识1CString(128)微信sub_open_id, 支付宝buyer_logon_id(买家支付宝账号)
user_id2用户标识2CString(128)微信openId,支付宝buyer_user_id,银联user_id
acc_activity_id活动 IDCString(32)在账户端商户后台配置的批次 ID
bank_type付款银行CString(128)付款银行
card_type银行卡类型CString(16)00:借记 01:贷记 02:微信零钱 03:支付宝花呗 04:支付宝其他 05:数字货币 06:拉卡拉支付账户 99:未知 sha
remark备注CString(128)
hb_fq_pay_info花呗分期支付信息CObject
sub_mch_id子商户号CString(20)账户端子商户号
out_split_rsp_infos合单信息CList<>

discount_goods_detail单品券优惠的商品优惠信息CString(1024)

花呗分期支付信息hb_fq_pay_info内容

字段名中文名称是否必填类型说明
fq_amount分期金额MString(12)单位分,整数数字型字符
user_install_num分期期数MString(12)分期期数,整数数字型字符

合单信息out_split_rsp_infos内容

字段名中文名称是否必填类型说明
sub_trade_no子单拉卡拉流水号MString(32)
sub_log_no子单对账流水号MString(12)
out_sub_trade_no子单外部流水号MString(32)
merchant_no子单商户号MString(32)
term_no子单终端号MString(8)
amount子单金额MString(12)单位:分

discount_goods_detail字段内容

字段名中文名称是否必填类型说明
goods_id商品idMString
goods_name商品名称CString
discount_amount优惠金额CString
voucher_id优惠idCString

请求报文

{
    "out_trade_no": "202203151637334864280014",
    "trade_no": "2022031566210203291925",
    "log_no": "66210203291925",
    "acc_trade_no": "2022031522001483661454130929 ",
    "trade_status": "SUCCESS",
    "trade_state": "SUCCESS",
    "total_amount": "1",
    "payer_amount": "1",
    "acc_settle_amount": "1",
    "trade_time": "20220315163808",
    "user_id1": "app***@163.com",
    "user_id2": "2088432881453660",
    "notify_url": "https://www.baidu.com",
    "account_type": "ALIPAY",
    "card_type": "99"
}复制

响应报文参考

{
    "code": "SUCCESS",
    "message": "执行成功"
}


The End