无忧支付网首页
站内搜索
您当前的位置:主页 > 支付接口申请介绍 >

聚合支付平台系统的相关接口设计

添加时间:2022-10-18

  聚合支付平台需要设计与商户平台和银行或第三方支付机构的对接接口,接口按功能用途、调用方和服务提供方分为支付类接口、退款类接口、通知类接口和商户类接口。接口协议统一采用 HTTPS,报文数据使用 JSON 结构,统一在 BODY 报文中进行封装,所有数据编码均采用 UTF-8 编码,并且数据前后不能有空格,接口 URL 均需要进行 UrlEncode 编码。

  接口安全方面,所有的加密算法必须在服务端进行,不可在浏览器端进行任何的加解密操作。请求方需截取报文数据字段中的内容进行 MD5 摘要后签名,在请求的 URL 参数中带上签名字段,签名字段和字段值均采用原始值,不进行 URLEncode;服务提供方需对签名进行验签操作,通过之后才可提供服务。

聚合支付

  1、支付类接口

  支付类接口是聚合支付平台提供给商户平台进行支付操作的相关服务接口,调用方均为商户平台,其中包括支付发起(纯网关)、支付发起(免登录收银台)、支付撤销、获取可支付方式列表和支付工单查询接口。

  1.支付发起(纯网关)接口

  商户平台通过该接口完成后台支付操作,即支付的请求和响应动作均发生在后台。商户平台调用该接口向支付平台发发送需要支付的商品信息(名称、价格和数量等)、支付信息(支付账号、支付模式、支付优惠、支付金额等)、订单信息(订单号、客户信息等),支付平台进行一定校验和处理之后,获得支付机构的支付订单后,在后台向商户平台返回支付订单信息,由商户平台自行完成后续支付流程。

  2. 支付发起(免登录收银台)接口

  请求内容在 1 接口的基础上增加了支付后返回和通知商户的 URL 地址,支付平台在调用支付机构获得支付订单后,会显示收银台 web 页面,用户在该页面完成付款操作,之后页面即会跳转到商户平台请求中的返回 URL 地址,同时支付平台后台会向商户的通知 URL 地址发送付款操作的结果。

  3.支付撤销接口

  商户平台向支付平台申请撤销之前向支付发起(纯网关)接口发起的支付请求,需提供接口 1 返回的支付工单标识。

  4.获取可支付方式列表接口

  商户平台向支付平台查询本商户支持的支付方式,需提供商户标识、接入方式、地市编码等信息,支付平台以列表的方式返回该商户支持的支付模式、支付机构及其对应的优惠折扣。

  5.支付工单查询接口

  商户平台可主动向支付平台查询之前向支付发起(纯网关)接口发起的支付工单详情,通过支付工单标识、商户标识查询支付工单中的商品信息、支付信息等。

  2、退款类接口

  退款类接口是支付平台提供给商户平台,对已经成功完成了支付的工单进行退款操作相关的服务接口,调用方均为商户平台,其中包括支付退款交易、支付冲正交易和支付退款查询接口。

  1.支付退款交易接口

  商户平台向支付平台申请对已经成功完成支付的工单操作退款,请求内容包括退款的商品信息清单、支付信息(支付账号、支付机构、支付模式和支付金额)、退款金额(支持部分退款)和退款结果通知商户的 URL 地址。

  聚合支付平台收到退款请求后会先向商户平台返回应答,但不会立即告知退款结果,而是等待向支付机构申请的该笔支付工单的退款完成后,再向商户平台发起请求时携带的退款通知URL 地址发送最终结果。

支付渠道

  2.支付冲正交易接口

  与退款交易类似,但一般是用于商户在对账不平时,统一向支付平台申请退款的接口。

  3.支付退款查询接口

  提供给商户平台主动查询支付退款交易结果的服务接口。商户平台无可用于接收支付平台退款结果通知的接口时,或长时间未收到退款结果通知时,可主动向该接口发起查询请求,需提供原支付工单和支付退款交易工单。

  3、商户类接口

  商户类接口是聚合支付平台提供给商户平台进行注册操作相关的服务接口,调用方均为商户平台,其中包括商户注册、批量文件上传接口和商户注册审核状态通知接口。

  1.商户注册接口

  商户平台向支付平台发起注册请求,提供商户相关注册信息和注册审核结果通知的接口 URL 地址,审核结果不在此接口的响应报文中提供。

  2.文件批量上传接口

  商户平台向支付平台批量上传营业执照照片、法人身份证照片文件等内容,用于支付平台审核商户的注册资格。

  3.商户注册审核状态通知接口

  聚合支付平台向商户平台申请时预留的接口 URL 地址发送商户注册的审核状态。

  4、支付机构类接口

  支付机构类接口是聚合支付平台调用银行和其他第三方支付机构完成支付操作的各个接口,主要包括支付、退款、冲正和对账等接口,具体接口各支付机构各不相同,一般均提供详细的接口说明或者 API,此处不再赘述。

关闭

1.点击下面按钮复制微信号

***********

2.打开微信→查找微信号

加为好友 开始支付接入