文档中心 > API类目 > 零售终端API

qimen.tmall.nrt.payorder.synchronize (支付单同步)

将线下零售上pos机产生的支付订单同步给线下零售商家隐藏淘系数据

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
trade_id	String	必须	207132765603		门店订单id
pay_id	String	必须	2000003504337667		主支付单Id
tid	String	必须	570649153886798626		淘系主订单Id
store_id	String	必须	207752179		阿里商户中心门店ID
status	Number	必须	6		主支付单状态（2：支付中，6：支付成功）
pay_fee	String	必须	6.00		主支付单应付额，元
sub_pay_order	SubPayOrderDTO []	必须		最大列表长度：10000	子支付单
pay_detail PayDetailDTO [] 必须支付明细 └ status Number 必须 6 支付明细支付状态（6：支付成功） └ pay_type String 必须 pay 交易类型（写死） └ end_time String 必须 2019-08-13 10:00:02 支付完成时间 └ pay_time String 必须 2019-08-13 10:00:01 支付发起时间 └ device_id String 必须 3461c13fad6b135156f9e05f POS机序列号 └ transaction_id String 可选 4390921562236730128 支付宝交易号 └ pay_account String 可选 123123213***123123 交易账号，脱敏银行卡或支付宝账号（废弃） └ pay_fee String 必须 6.00 支付明细付款金额，元 └ pay_tool String 必须 ALIPAY_FACE_PAY 支付工具：CASH：现金 ALIPAY_FACE_PAY：支付宝-当面付 BANK_CARD：银行卡 ALIPAY_SECURITY：线上担保交易 CHINAUMS_WECHAT：微信支付 BANK_CARD_SUPPLEMENTARY：银行卡补录 CARD：储值卡 TEL_PAY：电汇 CHECK：支票 EBC_CARD：EBC卡 LINK_CARD：连心卡 OSCAR_CARD：奥斯卡 FU_CARD：福卡 BUSINESS_CARD：商通卡 WORLD_CARD：世通卡 ZHONGXIN_CARD：中欣卡 EE_CARD：新E&E联名卡 YANSHA_CARD：金源新燕莎MALL结算卡 EASYTON_CARD：易事通卡 ETON_CARD：1039易通卡 EE_JOINT_CARD：E&E联名卡 SMART_CARD：智惠卡 TEXAS_CARD：得仕卡 JURAN_CONSUME_LOANS：居然消费贷 └ pay_detail_id String 必须 2000003504337669 支付明细Id └ attributes String 可选 {"key":"value"} 拓展字段 └ center Boolean 必须 false 是否中央收银 └ status Number 必须 6 子支付单支付状态（2：支付中，6：支付成功） └ pay_seq Number 必须 1 支付批次（1，2，3，4，最大为10） └ pay_fee String 必须 6.00 子支付单应付额，元 └ payee_name String 可选张三收银员名称 └ payee_id String 可选 4219010931 收银员ID └ sub_pay_id String 必须 2000003504337668 子支付单ID

响应参数

名称	类型	示例值	描述
result	TopResultDO		返回结果
└ success Boolean false 操作是否成功 └ err_code String sys_err 错误码 └ err_msg String 系统错误错误信息

请求示例

{"store_id":"207752179","trade_id":"207132765603","sub_pay_order":[{"sub_pay_id":"2000003504337668","payee_name":"张三","pay_fee":"6.00","payee_id":"4219010931","pay_seq":1,"pay_detail":[{"transaction_id":"4390921562236730128","pay_detail_id":"2000003504337669","device_id":"3461c13fad6b135156f9e05f","pay_tool":"ALIPAY_FACE_PAY","center":false,"end_time":"2019-08-13 10:00:02","pay_type":"pay","pay_fee":"6.00","attributes":"{\"key\":\"value\"}","pay_account":"123123213***123123","status":6,"pay_time":"2019-08-13 10:00:01"}],"status":6}],"pay_fee":"6.00","pay_id":"2000003504337667","request_id":"","tid":"570649153886798626","status":6}

响应示例

{
    "result":{
        "success":false,
        "err_code":"sys_err",
        "err_msg":"系统错误"
    }
}

验签示例

{"result":{"success":"false","err_msg":"Illegal request","err_code":"sign-check-failure"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

零售终端API

qimen.tmall.nrt.payorder.synchronize (支付单同步)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ