开发者(线下支付)新手入门

线下支付业务概述 

**
蚂蚁金服开放平台线下收单服务商(简称开发者(线下支付)),可将开放平台提供的支付宝当面付及配套接口集成于服务商自有系统,为线下商户提供收银及其他增值服务。
开发者(线下支付)需具备以下能力:收银系统技术开发能力、支付宝API调用能力、商户管理系统开发能力、商户拓展及运营能力等。
点击了解线下支付服务商优秀案例

线下支付业务介绍

商户准入条件及行业

商户准入及类目详见:商家准入规则

业务协作激励政策

业务协作费:服务商通过其产品或服务拓展线下商户使用“支付宝当面付”或“支付宝收款”产品(不含商户自助签约情况),可按公告规则获得协作返佣收入。

服务商业务协作费计算方式
业务协作费=业务协作费费率*有效交易金额
业务协作费费率=约定费率—基准费率(如约定费率减去基准费率小于0.05%的,则业务协作费费率按照0.05%计算)
详见《口碑系统服务商基础业务协作费结算规范》《支付宝服务商业务协作费公告》

线下支付合作流程

开放平台入驻

**
使用支付宝账户登录蚂蚁金服开放平台(open.alipay.com),进入开发者中心创建支付应用,具体步骤可以参考创建应用

完善应用信息

image.png

  • 应用名称:应尽量能够体现服务商的真实身份及应用的主要功能,例如:公司移动收银台;
  • 应用图标:服务商通过二维码或 URL 链接获取商户对支付应用的授权时,商户将会看到该应用的图标,建议服务商使用带有公司 logo 能够代表应用场景的图片展示(应用图标上传后可以修改,修改限制为30天一次);
  • 应用简介:说明文档应涵盖该应用的目标商户类型,应用的适用场景及实现的主要功能等内容。

添加应用功能

点击 添加功能 进入应用功能选择界面,从列表内选中以下收单业务常用功能:

  • 当面付功能(必选),支付宝线下收单业务的基础接口,实现支付交易订单的发起、撤销、查询、对账等功能;
  • 第三方应用授权(必选,建议优先完成此接口开发),使用该接口服务商取得商户对于支付应用的授权后,服务商可代商户发起线下支付交易;

线下支付业务实现推荐添加的各项能力见下图:
image.png
此外为应用添加更多辅助功能(如支付宝卡券、服务窗、商家详情页广告、营销活动)后,服务商应用可为商户实现各类营销管理功能,各项功能的详细说明可在列表内点击功能名称查阅。

说明
商家签约服务是指为商户代理注册支付宝账户。


 

配置应用环境

  1. 应用网关地址:服务商网络地址,用于接收支付宝异步通知;
  2. 授权回调地址:服务商网络地址,第三方授权或用户信息授权后的回调地址;
  3. 应用公钥:支付宝用于解密服务商应用发送的加密数据,保证数据交互的安全性。

具体操作说明详见《配置应用环境》
 

技术开发

蚂蚁沙箱环境是协助开发者进行接口功能开发及主要功能联调的辅助环境。沙箱环境模拟了开放平台部分产品的主要功能和主要逻辑。在开发者应用上线审核前,开发者可以根据自身需求,先在沙箱环境中了解、组合和调试各种开放接口,进行开发调通工作,从而帮助开发者在应用上线审核完成后,能更快速、更顺利的进行线上调试和验收工作。
如何使用和配置沙箱环境请参考《沙箱环境使用说明》

应用上线(签约)

应用开发完成后,请开发者自行进行验收并完成安全性检查(安全性检查可参考《开放平台第三方应用安全开发指南》),验收检查完成后,可“提交审核”。应用上线成功后,状态变为已上线,该状态下的应用能够调用生产环境的接口。
应用上线后,开发者可以进入应用详情页,进行新增功能、签约功能和删除功能等操作,操作后实时生效,如下图所示。删除功能时请谨慎操作,如果线上已经有用户使用此功能,删除功能后会导致无法使用。
image.png

线下支付业务服务商协作费管理

1)返佣协议查询:登录开放平台(open.alipay.com),在营销管理-协作费管理-协作协议信息内查看协议生效情况及详细内容。
2)技术方面如何做才能拿到返佣?(非常重要)
服务商返佣,是按照上传交易数据中的 sys_service_provider_id 字段内容计算的,这个字段要求服务商上传自己的支付宝PID;如果服务商存在多个支付宝 PID,要确保上传的 PID是已经在开放平台签署过返佣协议的那个,若错误上传了未签署返佣协议的 PID 一样无法计算返佣;请务必注意,服务商不要漏传 system_service_provider_id,或是错误上传交易商户的 PID。因服务商交易上传参数错误导致无法计算返佣,是不允许服务商申诉的。详阅《支付宝ISV入驻以及返佣必读》,必读、必读、必读。

协作费查询及管理

服务商协作费管理平台,提供返佣账单下载、协作费发票管理、KA 商户查询等重要功能,如何操作请查阅《开放平台协作费管理操作手册》

物料设计规范

详见《支付宝口碑ISV物料设计规范PDF》

onlineServer