使用场景

智能小程序订单支付成功后，百度收银台会主动调用小程序开发者的支付回调地址（在开发者平台开通支付时注册的支付回调地址），通知开发者该订单支付成功。

接口注意事项

1. 幂等性：开发者接口需要具备幂等性平台技术术语---幂等性；
2. 超时时间：开发者接口的耗时要求小于 2s（超过 2s 会触发平台的超时重试，每 2 分钟/次，共计 200 次，回调失败订单会保持“已付款”状态，无法核销，导致订单金额无法顺利进入企业资产）；
3. 返回值判断：errno 为 0 表示开发者已经成功收到支付信息，并妥善处理，errno 不为 0 将认为是同步支付信息失败，当同步支付信息失败时，平台会发起重试，每 2 分钟/次，共计 200 次，订单会锁定“已付款”状态，无法核销，导致订单金额无法顺利进入企业资产；
4. 回调地址服务器部署：如果回调接口部署在阿里云或有网关准入限制，请参考文档阿里云安全组设置中的 IP 地址设置白名单。

• 回调地址配置后要确认服务审核是“审核通过”状态，审核中会导致无法收到回调地址，详见服务审核注意事项。
• 服务器调用开发者回调接口不成功或开发者返回参数有误，平台会发起重试，每 2 分钟/次，共计 200 次，如重试后仍旧无法回调，订单会锁定“已付款”状态，无法核销，导致订单金额无法顺利进入企业资产。还请开发者仔细根据文档操作。如有无法核销的“已付款订单，请开发者提供 appId、orderId、服务名称、公司名称、问题描述发送至问题反馈邮箱：jiaoyi-ask@baidu.com。

通知参数说明

参数	参数名称	类型	说明	示例
userId	用户 ID	Long	百度收银台用户 ID	149235070
orderId	订单 ID	Long	百度平台订单 ID【幂等性标识参数】(用于重入判断)	800020199
unitPrice	单价	Integer	单位：分	800
count	数量	Integer	数量	2
totalMoney	总金额	Integer	订单的实际金额，单位：分。	1600
payMoney	实付金额	Integer	扣除各种优惠后用户还需要支付的金额，单位：分	1200
promoMoney	营销金额	Integer	营销优惠金额	100
hbMoney	红包支付金额	Integer	红包支付金额	100
hbBalanceMoney	余额支付金额	Integer	余额支付金额	100
giftCardMoney	抵用券金额	Integer	抵用券金额	100
dealId	百度收银台凭证	Long	百度收银台的财务结算凭证	7423328
payTime	支付时间	Integer	支付完成时间，时间戳。	1463037529
promoDetail	促销详情	Object	订单参与的促销优惠的详细信息
payType	支付渠道	Integer	支付渠道值	9101
partnerId	支付平台	Integer	支付平台标识值	1000000003
status	订单支付状态	Integer	1：未支付；2：已支付；-1：订单取消。	2
tpOrderId	开发者订单ID	String	开发者系统中创建的唯一订单号	33330020199
returnData	开发者透传数据	Object	开发者下单时传入的数据
rsaSign	rsa 签名	String	rsa 签名字符串	全部参数参与签名，详见签名与验签。

这里对全部参数签名是对收到的【通知支付状态】平台回调的所有 POST 参数进行签名（这里所指的参数不包含 rsasign ，故不需要参与签名），空值参数同样需要参与签名，建议格式：key=&key2=value2 ，如没有对回调中收到的所有参数签名，会导致验签不通过，如果开发者 URL 里包含 GET 类型参数，不会参与签名。注意：验签需要使用正确的平台公钥，可以在服务详情中查询，详见签名与验签第 8 项内容。

返回参数说明

名称	类型	是否必须	示例值	描述
errno	Integer	是	0	返回码
msg	String	是	success	返回信息
data	Object	是	{"isConsumed":2}	返回数据

data 字段为 JSON 格式，参数如下：

名称	类型	是否必须	示例值	描述
isConsumed	Integer	是	2	是否标记核销
isErrorOrder	Integer	否	1	是否异常订单（如需主动发起异常退款，需将此字段设置为 1）

isConsumed 字段参数枚举值如下：

取值	描述
1	未消费
2	已消费

isConsumed 重要性

为必传参数（不传会触发异常退款），用来标记该订单是否已消费。

小程序接入为支付成功即消费场景，该字段需设置为 2 。（字段不设置为 2 订单不会变更为“已消费”）如 isConsumed 值不返回 2 ，“已付款”状态的订单金额不能顺利进入企业余额。

通知触发条件

用户支付成功，通过了各项支付后校验之后，会调用此接口，将支付信息同步给开发者。

如未收到回调请求，请检查服务器网关是否有准入限制，如有限制参照阿里云安全组设置中的 IP 地址设置白名单；开发者接口的耗时要求小于 2s 。（超过 2s 会触发平台的超时重试，每 2 分钟/次，共计 200 次，回调失败订单会保持“已付款”状态，无法核销，导致订单金额无法顺利进入企业资产）。

开发者服务器通知参数获取

1. 百度收银台是用 POST 方式发送通知信息，参数以 URL param 的方式返回。
   PHP 服务推荐参数获取方式：$_POST['xxx']。
   Java 服务推荐参数获取方式：@RequestParam(value="xxx")。
2. 百度收银台主动发起通知，该方式才会被启用。
3. 程序执行完后须同步返回符合要求的 JSON 字符串。如果开发者返回给百度收银台的字符不是合法 JSON 或者解析出来的 errno 不为 0，会对订单发起异常退款（所付款项及资产将全数退还给用户）。

开发者通知参数合法性验证

当百度收银台通过调用接口同步支付信息给开发者开发者时，开发者获得这些数据时，必须进行如下处理：

1. 验证签名
   首先必需验证签名，然后验证是否是百度收银台发来的通知，请参见签名与验签。
2. 业务数据处理注意事项
   开发者需要验证该通知数据中的 tpOrderId 是否为开发者系统中创建的订单号，并判断 totalMoney 是否确实为该订单的实际金额（即开发者订单创建时的金额），上述有任何一个验证不通过，则表明本次通知是异常通知，务必忽略。在上述验证通过后开发者必须根据百度收银台不同类型的业务通知，正确的进行不同的业务处理，并且过滤重复的通知结果数据。如果开发者需要对同步返回的数据做验签，必须通过服务端的签名验签代码逻辑来实现。如果开发者未正确处理业务通知，存在潜在的风险，开发者自行承担因此而产生的所有损失。

DEMO

• 入参(REQUEST) DEMO：

https://xxx.tpbusiness.xxx/SyncPayInfo?userId=149235070&orderId=800020199&unitPrice=800&count=2&totalMoney=1600&payMoney=1200&promoMoney=100&hbMoney=100&hbBalanceMoney=100&giftCardMoney=100&dealId=7423328&payTime=1463037529&promoDetail=&payType=9101&partnerId=1000000003&status=2&tpOrderId=33330020199&returnData=&rsaSign=Gzu1RT2toJSDthcLPG1ZWROI3jzvxFtO7yCPUqMT3L7cmnARncm5IIIQ6x+7S/02zWxr5FC9945WFSurO9kepVbU7YS6Lh9SEVQhvTO0YKG7TlLFTpH3Ik7JeHQalAKXYe/jNREDpHmTF9Jrq/wABeZGYXJn1M75A37h9zUt+kw=

• 返回(RESPONSE) DEMO:

{"errno": 0, "msg": "success", "data": {"isConsumed": 2}}

如处理支付回调的过程中开发者端参数异常、其他异常，返回以下参数进行异常退款:

{"errno": 0, "msg": "success", "data": {"isErrorOrder": 1, "isConsumed": 2}

小程序场景 isConsumed 返回值一定要为 2 ，（字段不设置为 2 订单不会变更为“已消费”）不按照要求值返回参数，用户已付款金额不能顺利进入企业余额。