描述
消费者支付成功之后,街口支付将会以 HTTT POST方式来请求页面跳转同步通知(return_url="page_url") 和 服务器底层异步通知(notify_url="server_url")到商户的指定网站地址,即商户支付订单时提交的 return_url 和 notify_url,只有订单支付成功才会发送通知。
通知依赖于"notice_type"参数,对于未设置页面跳转同步通知或者某些支付场景无条件的情况下将无法通知。
通知接口参数定义
商户接收街口支付支付成功通知处理,页面同步跳转和异步底层通知参数和签名算法相同,接收参数必须遵循以下规则:
参数 | 格式 | 必传 | 说明 |
---|---|---|---|
merchant_code | String(15) | | 商家号,商户签约时分配给商家的唯一身份标识。 |
interface_version | String(5) | | 接口版本,固定值:V1.0(大写) |
order_no | String(30) | | 商家网站生成的订单号,由商户保证其唯一性,由字母、数字、下划线组成。 |
trade_no | String(30) | | 街口支付平台的支付订单号。 |
order_amount | Number | | 商家订单金额,以元为单位,精确到小数点后两位.例如:12.01。 |
product_number | Number | | 商品数量,必须是整型数字。 |
order_success_time | Date | | 订单支付成功时间,时间格式:yyyy-MM-dd HH:mm:ss。 |
order_time | Date | | 商家订单时间,时间格式:yyyy-MM-dd HH:mm:ss。 |
order_status | String(7) | | 订单支付状态,固定值:支付成功(success)、取消支付或成功延迟(waiting)。 |
bank_code | String(8) | | 消费者支付渠道编码。 |
sign_type | String(3) | | 签名类型,固定值:MD5或RSA(大写)。 |
bank_name | String(20) | | 消费者支付渠道名称。 |
product_name | String(100) | ဆ | 商品名称,商户非必填情况传的空字符串。 |
order_userid | String(30) | ဆ | 商户平台支付会员账号,商户非必填情况传的空字符串。 |
order_info | String(100) | ဆ | 商品附加信息,商户非必填情况传的空字符串。 |
sign | String | |
MD5或RSA签名,签名要求使用异步通知签名规范,请参考签名规范。 商户签名模型为MD5请参考MD5签名说明。 |
po_extend1 | String(200) | ဆ | 扩展参数1:只有异步通知有此参数且只有支付宝渠道有效(买家在支付宝中唯一的用户标识号ID。以2088开头的纯16位数字),其他情况空值 |
po_extend2 | String(200) | ဆ | 扩展参数2:只有异步通知有此参数且只有支付宝渠道有效(买家在支付宝中的用户账号,官方支付宝由于安全隐私带*。895***@qq.com),其他情况空值 |
po_extend3 | String(200) | ဆ | 扩展参数3:消费者支付成功在哪个固定渠道ID上, 仅异步通知有此参数。(用户中心--与门店管理列表对应) |
po_extend4 | String(600) | ဆ | 扩展参数4:支付宝渠道其他消费资金详情,可忽略。 |