支付通知接口

当订单支付成功时，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。

注意

该接口是通过创建订单接口的notifyUrl参数提交的，如果无法访问该接口，商户系统将无法接收到支付系统的通知。

请求说明

• 请求方式：POST
• 请求类型：application/json 或者 application/x-www-form-urlencoded

通知参数

名称	参数	类型	必填	示例值	描述
商户号	mchNo	String	是	M1621873433953	商户号
应用ID	app_id	String	是	60cc09bce4b0f1c0b83761c9	应用ID
网站ID	app_id	int	是	10010	网站ID
商户订单号	mch_order_no	String	是	20160427210604000490	商户侧订单号
支付订单号	pay_order_id	String	是	P12021022311124442600	支付系统订单号
支付金额	amount	int	是	12000	支付金额，单位分
货币代码	currency	String	是	USD	三位币种编码
订单状态	state	int	是	2	支付订单状态 0-订单生成 1-支付中 2-支付成功 3-支付失败 4-已撤销 5-已退款 6-订单关闭
支付接口	if_code	String	是	wxpay	支付接口编码
支付方式	way_code	String	是	WX_LITE	支付方式
客户端IP	client_ip	String	否	210.73.10.148	客户端IPV4地
扩展参数	ext_param	String	否	134586944573118714	商户扩展参数
支付成功时间	success_time	long	否	1622016572190	订单支付成功时间
创建时间	created_at	long	是	1622016572190	订单创建时间
通知请求时间	req_time	long	是	1622016572190	通知请求时间
收货地址	shipping	object	否	详见 收货地址信息	收货地址信息
商品信息	shipping	object[]	否	详见 商品信息	商品信息
签名	sign	String	是	C380BEC2BFD727A4B6845133519F3AD6	签名值

收货地址信息

名称	参数	类型	必填	示例值	描述
收件人姓名	name	String	是	张三	收件人姓名
收件人手机号	phone	String	是	13800138000	收件人联系电话
详细地址	address	String	是	123 Main St	街道及门牌等详细地址
国家	country	String	是	CN	国家代码
省 / 州	state	String	否	Beijing	省份或州
城市	city	String	否	Beijing	城市
邮编	postal_code	String	否	100000	邮政编码
邮箱	email	String	否	carlos@rock-legends.com	收件人邮箱地址
传真号码	fax	String	否	13800138001	收件人传真号码
公司名称	company_name	String	否	Sui Generis	公司或组织名称

商品信息

名称	参数	类型	必填	示例值	描述
商品名称	name	String	是	篮球鞋	商品名称
商品编码	sku	String	否	1234567890	商品唯一编码（SKU）
商品数量	quantity	integer	是	1	商品数量
商品单价	unit_price	integer	是	12000	商品单价，单位为分
币种	currency	String	否	USD	ISO 4217 标准币种代码，默认与订单币种一致
扩展信息	metadata	object	否	{}	商品自定义扩展信息

通知返回

业务系统处理后同步返回给支付平台。

返回格式：String，success表示成功，其他字符串表示失败。

说明

如果返回的字符串不是success，支付平台会认为通知失败，并进行重试。
通知重试间隔时间为0/30/60/90/120/150，单位：秒。