发起支付请求

描述

    商户网站将所有的支付接口参数都初始化之后,并且以Http Post的方式提交到街口支付API支付网关,选择性的跳转到支付网关收银台选择界面、
直接跳转到指定支付通道页面 或者 获取二维码及支付地址显示到商户网站上的方式。

 

支付接口参数定义

商户接入街口支付支付网关,调用API必须遵循以下参数规则:

参数 格式 必填 说明
service_type String(20)

请求支付服务类型,包含了三种对接应用场景模式,默认收银台。
可选固定值:checkstand_service、connect_service、local_service

checkstand_service:收银台模式,跳转到街口支付收银台由用户选择渠道进行支付。(废弃)

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签名说明

商户签名模型为RSA请参考RSA密钥对生成,签名操作请参考RSA签名

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。