产品简介互联网平台直付通产品是支付宝面向电商、数娱等互联网平台(以下简称平台)专属打造的集支付、结算、分账等功能为一体的资金解决方案。该方案致力于帮助平台通过合规的资金清算模式,完成平台上各商家的交易资金处理。平台上的二级商户入驻支付宝成为支付宝的商家,买家在该平台的订单支付成功(支持多个商家的订单合并支付)后,支付宝记录对应商家待结算资金,待平台确认可结算时,支付宝将资金直接结算至商家指定的收款账号。同时支持平台按订单灵活抽取佣金。
典型场景目前部分电商、互娱平台都在不同程度上存在着资金清算的合规问题,并已有多家电商平台被点名整改,此类平台商可通过小微商家录入模式接入,根据业务订单不同的状态由服务商为商家发起资金结算操作。
典型商家:蘑菇街、盒马等。
解决的问题
典型案例小微商家云上美妆有限公司在某直播平台开店云上美妆店铺,上架一款护手霜商品直播出售。直播平台将商家信息进件到支付宝,成为直播平台的二级商户。商家使用签约支付宝账号登录支付宝,完成支付宝收单结算协议签署。买家下单购买护手霜之后,支付宝记录二级商户云上美妆店铺的待结算资金。二级商户发货,买家确认收货后,平台发起确认结算请求,交易资金结算到云上美妆店铺的结算账户中。平台通过分账能力,从云上美妆店铺结算账户中抽取一定佣金到平台账户。申请条件目前只针对满足以下条件的平台型商户定向开放,审核通过后可使用。拥有实名认证的支付宝企业账号。拥有主体一致的 ICP 许可证。商户的注册资本需大于等于500万、商户营业执照的注册天数需大于180天。签约账号的主体必须与已上架(上线) 的应用(APP/网站/小程序)归属主体保持一致(不支持不同主体间授权)。说明:商家 APP 在应用市场已上架(上线),网站应用可以通过浏览器正常访问,小程序可以正常访问。满足法律法规及监管规定的其它资质要求。
费率按商家签约的支付产品进行收费,直付通模式目前不额外收费。服务费从平台签约支付宝账号收取,请务必保证账号余额充足,如发生欠费将暂停结算。解决方案实际计费以方案开通时,签约的基础产品费率为准,可进入商家平台>账号中心>签约管理查看产品签约费率详情。
产品类型 |
---|
基础产品 |
基础产品 |
基础产品 |
基础产品 |
基础产品 |
基础产品 |
基础产品 |
本文主要介绍 互联网平台直付通 的接入准备工作。
互联网直付通本身适用于平台商接入使用,通过平台商自调用收款到二级商户账户的场景。
互联网平台直付通目前暂不支持第三方应用调用接口,仅支持自研商家方式 接入。
接入主流程
登录支付宝开放平台创建 网页&移动应用/小程序应用。
说明:生成的应用唯一标识 APPID 可用于调用开放产品接口。
在 开发 > 开发设置 中配置应用信息。
必填。用于防止数据篡改,保障应用和支付宝交互的安全性,可查看 接口加签方式。
说明:若产品涉及 资金支出的接口 必须 设置证书加签方式。
选填。用于提高应用访问开放平台的安全性,避免因应用私钥泄漏等原因导致业务受损,保障用户资金安全,可查看 服务器 IP 白名单。
必填。用于接收支付宝异步通知消息,需要传入 http(s) 公网可访问网页地址,可查看 应用网关。
选填。用于加 / 解密 OpenAPI bizContent 报文内容,可大幅提升接口内容传输的安全性。可查看 接口内容加密方式。
选填。网页/移动应用 指定的回调页面 URL,用户信息授权 成功后,将在该 URL 后携带授权码等信息并跳转至该页面。
说明:授权链接中配置的 redirect_uri 的值必须与此回调地址保持一致 (如:https://www.alipay.com) 。
选填。异步消息通知,用于提高应用 API 的调用效率。详情可查看 主动推送服务(From 蚂蚁)和 消息回流服务(To 蚂蚁)。
创建应用后,还需要开通 互联网平台直付通 才能使用。请平台商登录 支付宝商家平台 >进入 产品中心 > 产品详情页面> 点击 立即开通。填写并提交相关信息,开通互联网平台直付通解决方案。可查看 直付通开通。
注意:开通时填写的应用应为实际调用产品的应用,填写应用后,会自动完成相关产品的产品绑定。JSAPI支付支持小程序应用的绑定,APP支付支持移动应用的绑定,手机网站支付/电脑网站支付支持网页应用的绑定。
注意:开通互联网直付通需要使用没有签约过支付宝收单产品的账号,建议平台商新开支付宝账户并完成实名认证,再进行开通。详细流程可查看 支付宝企业账号注册及实名认证 。
小程序应用:审核通过后自动上线。
网页/移动应用:需要手动上线。提交审核后,预计 1 个工作日的审核时间,请耐心等待,详细步骤可查看 上线应用。应用上线后,还需要完成签约开通才能在线上环境(生产环境)使用产品。
服务端 SDK 需要商家或服务商集成在服务端系统中,用于后续的服务端接口调用。
为了帮助开发者调用开放接口,支付宝提供了开放平台服务端 SDK,包含 Java、PHP、NodeJS、Python 和 .NET 五种语言,封装了签名与验签、HTTP 接口请求等基础功能。
说明:请先下载对应语言版本的最新版 服务端 SDK 并引入开发工程。
在 SDK 调用具体的接口前需要进行 alipayClient 对象初始化。alipayClient 对象只需要初始化一次,后续调用不同的接口都可以使用同一个 alipayClient 对象。
接口加签方式为 公钥 模式加签时 alipayClient 对象初始化的 Java 语言示例代码:
AlipayConfig alipayConfig = new AlipayConfig(); alipayConfig.setServerUrl(URL); alipayConfig.setAppId(APP_ID); alipayConfig.setPrivateKey(PRIVATE_KEY); alipayConfig.setFormat("json"); alipayConfig.setCharset(CHARSET); alipayConfig.setAlipayPublicKey(ALIPAY_PUBLIC_KEY); alipayConfig.setSignType(SIGN_TYPE); //构造client AlipayClient alipayClient = new DefaultAlipayClient(alipayConfig);
配置参数 | 示例值解释 | 获取方式/示例值 |
URL | 支付宝网关(固定)。 | https://openapi.alipay.com/gateway.do |
APPID | APPID 即创建应用后生成。 | 获取可查看 获取 APPID。 |
PRIVATE_KEY | 开发者私钥,由开发者自己生成。 | 获取可查看 接口加签方式。 |
FORMAT | 参数返回格式,只支持 JSON(固定)。 | JSON |
CHARSET | 编码集,支持 GBK/UTF-8。 | 开发者根据实际工程编码配置。 |
ALIPAY_PUBLIC_KEY | 支付宝公钥,由支付宝生成。 | 获取详情可查看 接口加签方式。 |
SIGN_TYPE | 生成签名字符串所使用的签名算法类型,目前支持 RSA2 算法。 | RSA2 |
接口加签方式为 公钥证书 模式加签时,alipayClient 对象初始化的 Java 语言示例代码如下:
注意:若使用 公钥证书 模式进行加签,需额外引入如下 JAR 包:
bcprov-jdk15on
commons-logging
fastjson
CertAlipayRequest certAlipayRequest = new CertAlipayRequest(); certAlipayRequest.setServerUrl(URL); certAlipayRequest.setAppId(APPID); certAlipayRequest.setPrivateKey(PRIVATE_KEY); certAlipayRequest.setFormat("json"); certAlipayRequest.setCharset(CHARSET); certAlipayRequest.setSignType(SIGN_TYPE); certAlipayRequest.setCertPath(app_cert_pathAPP_CERT_PATH); certAlipayRequest.setAlipayPublicCertPath(alipay_cert_path); certAlipayRequest.setRootCertPath(alipay_root_cert_path ); DefaultAlipayClient alipayClient = new DefaultAlipayClient(certAlipayRequest); // 提交数据至支付宝时请使用 alipayClient.certificateExecute(request);
配置参数 | 示例值解释 | 获取方式/示例值 |
URL | 支付宝网关(固定)。 | https://openapi.alipay.com/gateway.do |
APPID | APPID 即创建应用后生成。 | 获取可查看 获取 APPID。 |
PRIVATE_KEY | 开发者私钥,由开发者自己生成。 | 获取可查看 接口加签方式。 |
FORMAT | 参数返回格式,只支持 JSON(固定)。 | JSON |
CHARSET | 编码集,支持 GBK/UTF-8。 | 开发者根据实际工程编码配置。 |
SIGN_TYPE | 生成签名字符串所使用的签名算法类型,目前支持 RSA2 算法。 | RSA2 |
app_cert_path | 应用公钥证书文件本地路径。 | 获取详情可查看 接口加签方式。 |
alipay_cert_path | 支付宝公钥证书文件本地路径。 | 获取详情可查看 接口加签方式。 |
alipay_root_cert_path | 支付宝根证书文件本地路径。 | 获取详情可查看 接口加签方式。 |