描述
商户网站将所有的支付接口参数都初始化之后,并且以Http Post的方式提交到街口支付API支付网关,选择性的跳转到支付网关收银台选择界面、
直接跳转到指定支付通道页面 或者 获取二维码及支付地址显示到商户网站上的方式。
支付接口参数定义
商户接入街口支付支付网关,调用API必须遵循以下参数规则:
参数 | 格式 | 必填 | 说明 |
---|---|---|---|
service_type | String(20) | |
请求支付服务类型,包含了三种对接应用场景模式,默认收银台。
connect_service:直连模式,根据商户传入的指定渠道编码直接跳转,依赖"bank_code"参数。 local_service:本地模式,扫码支付有效,将二维码信息或支付链接返回给商户自行处理。 |
merchant_code | String(15) | | 商家号,商户签约时分配给商家的唯一身份标识。 |
interface_version | String(5) | | 接口版本,门店聚合商户固定值:V2.0(大写),清算聚合商户固定值:V1.0(大写)。注意 |
sign_type | String(3) | | 签名类型,固定值:MD5或RSA(大写) |
order_no | String(30) | | 商家网站生成的订单号,由商户保证其唯一性,由字母、数字、下划线组成。 |
order_time | Date | | 商家订单时间,时间格式:yyyy-MM-dd HH:mm:ss |
order_amount | Number | | 商家订单金额,以元为单位,精确到小数点后两位.例如:12.01 |
product_number | Number | | 商品数量,必须是整型数字 |
notify_url | String(200) | | 服务器异步通知网址,支付成功后,网关会主动发送通知给商户,商户必须指定此通知地址 |
return_url | String(200) | ဆ | 页面跳转同步通知地址,支付成功无法前台跳转的场景下不会跳转,如取回二维码到商户网站上时,无法跳转。没有值必须传空字符串 |
bank_code | String(8) | ဆ | 网关支付渠道编码,收银台模式必须是"空字符串"。编码列表明细请参考 支付渠道编码。 |
product_name | String(100) | ဆ | 商品名称,非必填情况必须传空字符串。 |
order_userid | String(30) | ဆ | 商户平台支付会员账号,非必填情况必须传空字符串。 |
order_info | String(100) | ဆ | 商品附加信息,非必填情况必须传空字符串。 |
notice_type | Number | |
通知类型,固定值:0 或 1。 1: 需要前台跳转和异步通知,某些无法前台跳转场景既设置也无效。 0: 只需要底层异步通知。 |
sign | String | |
MD5或RSA签名,签名要求说明请参考签名规范。 商户签名模型为MD5请参考MD5签名说明。 |
pay_model | String(12) | |
支付请求模型,固定值(H5,PC,SCODE,APP,GONGZONGHAO,OFFLINE),请传入自己支付场景,商户中心查看对应场景下是否开通,必须正确的结合service_type参数。 H5: 手机游览器H5或WAP支付(微信、支付宝、QQ钱包、借记卡快捷支付)。 PC: 电脑端网页渠道支付。如网上银行支付,支付宝官网。微信不支持电脑端官网支付。 SCODE: 扫码支付(支持微信扫码、支付宝扫码、QQ钱包扫码、京东扫码)。 GONGZONGHAO: 微信公众号支付,微信软件内部发起的支付。 APP: 手机原生APP应用内调用支付宝、微信、银联发起的支付。 OFFLINE: 线下收款业务,如支付宝、微信刷卡支付。 |
gateway_id | Number | ဆ |
固定渠道ID: 商户可指定固定聚合门店渠道让消费者支付,获取方式在(用户中心--门店管理列表) 不必填,该参数不参与各类签名和验签。 如果指定了该参数 : 需要和bank_code参数对称, 例如gateway_id是支付宝类型,那么bank_code应该传支付宝编码。 如果指定了该参数 : 需要和pay_model参数对称, 例如gateway_id是支付宝H5渠道,那么pay_model应该传H5。 |