支付同步接口

提示

通常不需要调用这个主动调用接口这个接口，系统中已经有回调处理和定时同步任务进行处理，用于支付订单创建后，状态一直为支付中时，且一段时间内也没有发生状态变更， 可以通过手动进行触发同步，并根据状态的流转进行处理。注意：如果订单状态涉及到退款相关的情况，受第三方支付网关的限制，并不能进行很好的处理，可以借助退款同步接口进行处理

接口说明

参数	说明
请求URL	/unipay/sync/pay
请求方式	POST
请求类型	application/json

请求参数

公共参数

字段名	变量名	必填	类型	长度	示例值	描述
应用号	appId	否	String	32	A112544225541	此次操作所要使用的支付应用号
用户IP	clientIp	否	String	64	127.0.0.1	支持V4和V6，部分支付方式要求必填，如调用微信支付方式时
随机数值	nonceStr	否	String	32	d112892e382a7093
签名值	sign	否	String	64	072695d112892e382a7093b81e6a52af
请求时间	reqTime	是	String		2024-10-24 12:00:00	请求时间和当前时间误差不要超过五分钟，时间格式 yyyy-MM-dd HH:mm:ss

业务参数

字段名	变量名	必填	类型	长度	示例值	描述
订单号	orderNo	否	String	32	1753370980523384832	订单号与商户订单号不可以同时为空，同时传输是以订单号为准
商户订单号	bizOrderNo	否	String	100	P0001	订单号与商户订单号不可以同时为空，同时传输是以订单号为准

响应结果

提示

业务数据包裹在公共响应参数中的data字段，在code为0时才会有返回数据。

字段名	变量名	必传	类型	示例值	描述
支付状态	orderStatus	是	String	success	见支付状态说明
是否触发了调整	adjust	是	Boolean	R00123	同步时是否触发了支付状态的调整

HTTP请求示例

请求参数

响应参数(成功)

响应参数(失败)

SDK请求示例

提示

使用SDK可以简化接入支付的速度