支付宝接口文档
支付宝接口文档
Leslie支持的账号类型 ：个体工商户 企业
支持的账号类型 ：小程序、生活号、第三方应用、网页应用、移动应用、基础应用
Demo支持语言：JAVA JAVAPHP .NET
支持的接入模式：自研、代开发
功能介绍
当面付是指商家扫用户付款码收款或用户扫商家收款二维码付款的一种支付产品。包括付款码支付和扫码支付两种方式，主要适用于线下场所面对面收银的场景，例如：便利店、商超综合体、餐饮、医院、学校、电影院、旅游景区等具有明确经营地址的实体场所。
使用示例
第一种：付款码支付（商家扫用户付款码）
商家使用扫码枪或其它扫码机具扫描用户出示的付款码，来实现收款。
第二种：扫码支付（用户扫商家二维码）
商家提供收款二维码，由用户通过支付宝扫码支付，来实现收款。
API列表
| API名称 | API类型 | API描述 |
|---|---|---|
| 收单退款冲退完成通知 | MsgAPI | 退款存在退到银行卡场景时，收单会根据银行回执消息发送退款完成信息。仅当退款发起时，在query_options中传入：deposit_back_info时会发送。 |
| 创建聚合收钱单 | SPI | 用于创建聚合收钱码订单 |
| 聚合收钱码商户信息查询 | SPI | 查询聚合收钱码的基础商户信息 |
| 统一收单交易撤销接口 | OpenAPI | 支付交易返回失败或支付系统超时，调用该接口撤销交易。如果此订单用户支付失败，支付宝系统会将此订单关闭；如果用户支付成功，支付宝系统会将此订单资金退还给用户。 |
| 统一收单线下交易预创建 | OpenAPI | 收银员通过收银台或商户后台调用支付宝接口，生成二维码后，展示给用户，由用户扫描二维码完成订单支付。 |
| 查询对账单下载地址 | OpenAPI | 为方便商户快速查账，支持商户通过本接口获取商户离线账单下载地址 |
| 统一收单交易支付接口 | OpenAPI | 收银员使用扫码设备读取用户手机支付宝“付款码”获取设备（如扫码枪）读取用户手机支付宝的付款码信息后，将二维码或条码信息通过本接口上送至支付宝发起支付 |
| 统一收单交易创建接口 | OpenAPI | 商户通过该接口进行交易的创建下单 |
| 统一收单交易退款查询 | OpenAPI | 商户可使用该接口查询自已通过alipay.trade.refund提交的退款请求是否执行成功。 |
| 统一收单交易关闭接口 | OpenAPI | 用于交易创建后，用户在一定时间内未进行支付，可调用该接口直接将未付款的交易进行关闭。 |
| 统一收单交易查询 | OpenAPI | 该接口提供所有支付宝支付订单的查询，商户可以通过该接口主动查询订单状态，完成下一步的业务逻辑。 需要调用查询接口的情况： 当商户后台、网络、服务器等出现异常，商户系统最终未 |
| 统一收单交易退款接口 | OpenAPI | 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，支付宝将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家帐号上。 交易超过约定时间（签约时设置的可退款时间）的订单无法进行退款。 支付宝退款支持单笔交易分多次退款，多次退款需要提交原支付订单的订单号和设置不同的退款请求号。一笔退款失败后重新提交，要保证重试时退款请求号不能变更，防止该笔交易重复退款。 同一笔交易累计提交的退款金额不能超过原始交易总金额。 |
支持的账号类型 ：个人 个体工商户 企业
支持的账号类型 ：小程序、生活号、第三方应用、网页应用、移动应用、基础应用
Demo支持语言：JAVA JAVAPHP .NET
支持的接入模式：自研、代开发
功能介绍
APP支付是指商家在商家移动端APP中集成支付宝SDK，调起支付宝来完成付款的一种支付产品，适用于在商家移动端APP内使用支付宝支付功能的场景。该产品在签约完成后，需要技术集成完成后方可使用。
使用示例
App 支付是指商家在移动应用 App 中集成 SDK，调起支付宝来完成付款的一种支付产品。该产品在签约完成后，需要技术集成方可使用。
API列表
| API名称 | API类型 | API描述 |
|---|---|---|
| 收单退款冲退完成通知 | MsgAPI | 退款存在退到银行卡场景时，收单会根据银行回执消息发送退款完成信息。仅当退款发起时，在query_options中传入：deposit_back_info时会发送。 |
| 统一收单交易退款查询 | OpenAPI | 商户可使用该接口查询自已通过alipay.trade.refund提交的退款请求是否执行成功。 |
| 统一收单交易关闭接口 | OpenAPI | 用于交易创建后，用户在一定时间内未进行支付，可调用该接口直接将未付款的交易进行关闭。 |
| 统一收单交易查询 | OpenAPI | 该接口提供所有支付宝支付订单的查询，商户可以通过该接口主动查询订单状态，完成下一步的业务逻辑。 需要调用查询接口的情况： 当商户后台、网络、服务器等出现异常，商户系统最终 |
| 统一收单交易退款接口 | OpenAPI | 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，支付宝将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路 |
| 查询对账单下载地址 | OpenAPI | 为方便商户快速查账，支持商户通过本接口获取商户离线账单下载地址 |
| app支付接口2.0 | OpenAPI | 外部商户APP唤起快捷SDK创建订单并支付 |
支持的账号类型 ：个人 企业
支持的账号类型 ：第三方应用、网页应用、移动应用、基础应用
Demo支持语言：JAVA JAVAPHP .NET
支持的接入模式：自研、代开发
功能介绍
手机网站支付是指商户在移动端网页展示商品或服务，用户在商户页面确认使用支付宝支付时，浏览器自动跳转支付宝 App 或支付宝网页完成付款的支付产品。该产品在签约完成后，需要技术集成方可使用。
使用示例
API列表
| API名称 | API类型 | API描述 |
|---|---|---|
| 收单退款冲退完成通知 | MsgAPI | 退款存在退到银行卡场景时，收单会根据银行回执消息发送退款完成信息。仅当退款发起时，在query_options中传入：deposit_back_info时会发送。 |
| 手机网站支付接口2.0 | OpenAPI | 外部商户创建订单并支付 |
| 统一收单交易关闭接口 | OpenAPI | 用于交易创建后，用户在一定时间内未进行支付，可调用该接口直接将未付款的交易进行关闭。 |
| 统一收单交易查询 | OpenAPI | 该接口提供所有支付宝支付订单的查询，商户可以通过该接口主动查询订单状态，完成下一步的业务逻辑。 需要调用查询接口的情况： 当商户后台、网络、服务器等出现异常，商户系统最终 |
| 统一收单交易退款接口 | OpenAPI | 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，支付宝将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路 |
| 查询对账单下载地址 | OpenAPI | 为方便商户快速查账，支持商户通过本接口获取商户离线账单下载地址 |
支持的账号类型 ：个人 个体工商户 企业
支持的账号类型 ：第三方应用、网页应用、移动应用、基础应用
Demo支持语言：JAVA JAVAPHP .NET
支持的接入模式：自研、代开发
功能介绍
电脑网站支付是指商户在电脑网页展示商品或服务，用户在商户页面确认使用支付宝支付时，浏览器自动跳转支付宝电脑网页完成付款的支付产品。该产品在签约完成后，需要技术集成方可使用。
使用示例
1在支付宝页面扫码支付
2在支付宝页面登录账户支付
3在商家页面扫码支付
API列表
| API名称 | API类型 | API描述 |
|---|---|---|
| 收单退款冲退完成通知 | MsgAPI | 退款存在退到银行卡场景时，收单会根据银行回执消息发送退款完成信息。仅当退款发起时，在query_options中传入：deposit_back_info时会发送。 |
| 统一收单下单并支付页面接口 | OpenAPI | PC场景下单并支付 |
| 统一收单交易关闭接口 | OpenAPI | 用于交易创建后，用户在一定时间内未进行支付，可调用该接口直接将未付款的交易进行关闭。 |
| 统一收单交易退款查询 | OpenAPI | 商户可使用该接口查询自已通过alipay.trade.refund提交的退款请求是否执行成功。 |
| 统一收单交易查询 | OpenAPI | 该接口提供所有支付宝支付订单的查询，商户可以通过该接口主动查询订单状态，完成下一步的业务逻辑。 需要调用查询接口的情况： 当商户后台、网络、服务器等出现异常，商户系统最终 |
| 统一收单交易退款接口 | OpenAPI | 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，支付宝将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路 |
| 查询对账单下载地址 | OpenAPI | 为方便商户快速查账，支持商户通过本接口获取商户离线账单下载地址 |
支持的账号类型 ：个人 企业
支持的账号类型 ：小程序、生活号、第三方应用、网页应用、移动应用、基础应用
Demo支持语言：JAVA
支持的接入模式：自研、代开发
功能介绍
支付宝刷脸付是基于人工智能、生物识别、3D传感、大数据风控技术，最新实现的新型支付方式。用户在无需打开手机的情况下，凭借 刷脸 完成支付。刷脸付的使用，有效提升用户的消费体验，提高了商家的收银效率。
能力特色
应用场景
1:1人脸比对－用户提供支付宝实名账号绑定的手机号
用户提供支付宝实名账号绑定的手机号
1:1人脸比对－用户提供姓名和身份证号
1:1人脸比对－用户在刷脸前提供手机号
API列表
| API名称 | API类型 | |
|---|---|---|
| 刷脸支付初始化 | OpenAPI | 通过该接口获取刷脸支付服务的初始化信息，详细字段描述请参考产品说明文档 |
| 人脸ftoken查询消费接口 | OpenAPI | 人脸ftoken查询消费接口 |
功能介绍
JSAPI支付 是指商家在支付宝 App 中，通过调用支付宝提供的 JSAPI 接口，在支付场景中唤起支付宝收银台完成收款的一款支付产品。
可选择接入 商家分账 产品，资金在到达商家的支付宝账号后，支付宝根据商家传入的分账规则，将相应的资金从商家的支付宝账号划转至分账对象的支付宝账号。
典型场景
小程序支付场景：
- 用户通过分享、扫描二维码或搜索进入商家小程序，选择购买商品，完成选购流程。
- 唤起支付宝收银台，用户输入支付密码，完成支付。
权限集列表
| 权限集名称 | 权限集介绍 |
|---|---|
| JSAPI支付 | 商家在支付宝App中，调用支付宝提供的JSAPI接口，调起支付宝收银台完成收款 |
| 商家分账 | 商家分账帮助商家完成交易收款资金的再分配，可按照指定金额分账至其它合作伙伴的支付宝账号 |
功能介绍
用户消费前，商户会先冻结用户的一部分资金/信用额度作为预付款，也叫做“押金”。在用户消费完以后，商户再根据实际消费，向支付宝请求从用户账户扣除实际消费金额。
产品特色
- 预授权支付 指用户产生实际消费前，商家可以提前冻结用户一定资金作为押金，后续按实际消费金额从用户冻结资金中扣除给商家，剩余金额解冻返还用户的一种支付产品。
- 说明：预授权支付 是 支付宝预授权 的升级产品，如果您是接入支付宝预授权的商家，可查看 支付宝预授权。
典型场景
覆盖押金、预存场景，如住宿（民宿/酒店）、出行（传统租车/分时租赁/单车）、租物（3C 数码/充电宝/雨伞/手机/相机）等多个行业品类。
- 用户在商家页面下单。
- 用户在下单页面确认授权。
- 用户同意协议并授权。
- 页面返回授权结果。
关联产品
同时可选择接入 商家分账 产品，资金在到达商家的支付宝账号后，支付宝根据商家传入的分账规则，将相应的资金从商家的支付宝账号划转至分账对象的支付宝账号。
权限集列表
| 权限集名称 | 权限集介绍 |
|---|---|
| JSAPI支付 | 提前冻结用户资金/额度，交易完成后再支付。 |
| 商家分账 | 商家分账帮助商家完成交易收款资金的再分配，可按照指定金额分账至其它合作伙伴的支付宝账号 |
