厂商在泊链后台配置统一下单回调地址(通用支付回调地址),支付成功后,推送数据到此地址,需要对 data 数据进行签名,并与返回的 sign 比对,一致时为合法数据。
数据不能保证是一次推送,如果不返回时,会继续按一定时间间隔发送。
trade_no 是下单时传入的订单号,是支付数据的唯一凭证,在处理业务时,如果已处理,应该抛弃,防止重复处理。
回调 json 数据中有两个字段,sign 和 data,data 为 josn 对象,包含字段列表中在它以下的所有字段。
回调数据:json 字符串
字段名称 | 类型 | 说明 | 是否必传 | 示例 |
---|---|---|---|---|
sign | String | 数据 data 的签名值,32 位 | 是 | |
data | json | 包含下面的所有字段的 json 对象 | 是 | {“state”:1””ammount”:”0.01”...} |
park_id | String | 车场编号 | 是 | 21888 |
service_name | String | 固定填写 | 否,配置统一一个回调地址时必传 | plat_unified_order |
state | Number | 状态 | 是 | 0 支付失败,1 支付成功 |
amount | String | 用户支付金额,单位是元,保留两位小数 | 是 | 0.01 |
receipt_amount | String | 到账金额,保留 5 位小数 | 是 | 0.00994 |
pay_platform_fee | String | 支付平台手续费,保留 5 位小数 | 是 | 0.00006 |
trade_no | String | 下单时的交易流水号 | 是 | 20170921336510038 |
pay_channel | Number | 支付通道 | 否 | 0 微信 1 支付宝 |
pay_time | Number(unix 时间戳格式,长整型) | 支付时间 | 是 | 1490876000 |
openid | String | 用户 openid | 否 | ouc2o0zprlFsy5pKdqxSYwqzos5Y |
description | String | 附加数据,在支付通知中原样返回,该字段主要用于商户携带订单的自定义数据,32 位以内 | 否,下单时为空或不传时,返回为空 | orderid=10&time=20170923141950 |
out_trade_no | String | 第三方交易流水号 | 是 | M617FBS0NRTBZLPGHUC |
pay_company | Number | 支付公司 ,0:微信,1:支付宝 | 否 | 0 |
pay_account | Number | 是否支持清算 , 0:不支持清算,1:支持清算 | 否 | 0 |
例:
{"sign":"B5A9D049747B76C8428E72514E274DB4","data":{"amount":0.01,"trade_no":"20170921336510038","pay_time":1490876000,"park_id":"21781","out_trade_no":"M617FBS0NRTBZLPGHUC","openid":"ouc2o0zprlFsy5pKdqxSYwqzos5Y","pay_platform_fee":"0.00006","state":1,"receipt_amount":"0.00994"}}
同步返回:json 字符串
字段名称 | 类型 | 说明 | 是否必传 | 示例 |
---|---|---|---|---|
state | Number | 状态 | 是 | 0 处理失败,1 处理成功 |
trade_no | String | 下单时的交易流水号 | 是 | 20170921336435142 |
{"state":1,"trade_no":"20170921336510038"} |