退款同步接口

提示

通常不需要调用这个主动调用接口这个接口，系统中已经有回调处理和定时同步任务进行处理。通常只用在发起支付退款后，退款状态为退款中，且一段时间内也没有发生状态变更，可以通过手动进行触发同步，并根据状态的流转进行处理。

接口说明

参数	说明
请求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

业务参数

字段名	变量名	必填	类型	长度	示例值	描述
退款号	refundNo	否	String	32	R00123	退款号和商户退款号不能同时为空，同时传输时以退款号为准
商户退款号	bizRefundNo	否	String	100	DEVR24051019590563000001	退款号和商户退款号不能同时为空，同时传输时以退款号为准

响应结果

通用响应参数

WARNING

状态码返回0只代表受理业务成功，业务是否成功需要看具体业务的返回信息，不为0表示受理失败，具体响应吗可以参考返回状态码

名称	字段	类型	示例值	描述
状态码	code	Integer	0	默认是0，非0表明请求失败，例如签名错误等
提示信息	msg	String		发生错误时会有数据返回
业务数据	data	Json字符串		json格式数据，不同的接口返回结构不同，可以参考业务公共响应参数
签名	sign	String	sIV4zJVhZ4Uz	返回数据的签名值
响应时间	resTime	String	2024-08-08 12:12:12	数据响应的时间, 如果时间与请求时间相差5分钟以上，请排查网络和安全问题
追踪ID	traceId	String	sIV4zJVhZ4Uz	用于查询日志排查问题时进行快速定位

业务响应参数

提示

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

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

HTTP请求示例

请求参数

响应参数(成功)

响应参数(失败)

SDK请求示例

提示

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