支付宝
  1. 支付宝加油
支付宝
  • 支付
    • 当面付
      • 产品介绍
      • 接入准备
      • 接入指南
        • 基础功能
          • 付款码支付快速接入
          • 扫码支付快速接入
          • 当面付接入注意事项
          • 异步通知说明
        • 扩展功能
          • 当面付扩展功能
          • 对账说明
          • 商户风险联防指引
          • 用户下单 IP 获取指引
        • 集成工具
          • 沙箱环境联调
          • SDK & Demo 获取
      • API 列表
        • 常见问题
        • 付款码支付
          • 收单退款冲退完成通知接口
          • 统一收单交易支付接口
          • 统一收单交易查询
          • 统一收单交易退款接口
          • 统一收单交易退款查询
          • 统一收单交易撤销接口
          • 统一收单交易关闭接口
          • 查询对账单下载地址
        • 扫码支付
          • 收单退款冲退完成通知
          • 统一收单线下交易预创建
          • 统一收单交易创建接口
    • APP 支付
      • 产品介绍
      • 接入准备
      • 常见问题
      • 接入指南
        • 基础功能
          • 界面规范
          • APP 支付快速接入
          • iOS 集成流程
          • Android 集成流程
          • 鸿蒙 SDK 接入说明
          • 同步通知说明
          • 异步通知说明
        • 扩展功能
          • 手机网站支付转 APP 支付
          • APP 支付接入花呗分期
          • 花呗单通道支付界面规范
          • 对账说明
          • 商户风险联防指引
          • 用户下单 IP 获取指引
        • 集成工具
          • 沙箱环境联调
          • App 支付客户端 DEMO&SDK
      • API 列表
        • 收单退款冲退完成通知
        • 交易
          • 统一收单交易退款接口
          • 统一收单交易关闭接口
          • 统一收单交易退款查询
          • 统一收单交易查询
        • 账单
          • app支付接口2.0
    • 手机网站支付
      • 产品介绍
      • 接入准备
      • 常见问题
      • 接入指南
        • 基础功能
          • 界面规范
          • 手机网站支付快速接入
          • 异步通知说明
        • 扩展功能
          • 手机网站支付转Native支付(推荐)
          • 手机网站支付通过alipays协议唤起支付宝APP
          • 旧版手机网站支付升级为新版指南
          • 对账说明
          • 商户风险联防指引
          • 用户下单 IP 获取指引
        • 集成工具
          • 沙箱环境联调
          • SDK & Demo 获取
      • API 列表
        • 收单退款冲退完成通知
        • 交易
          • 统一收单交易退款接口
          • 统一收单交易关闭接口
          • 统一收单交易退款查询
          • 统一收单交易查询
        • 账单
          • 手机网站支付接口2.0
    • 电脑网站支付
      • 产品介绍
      • 接入准备
      • 接入指南
        • 基础功能
          • 界面规范
          • 电脑网站支付快速接入
          • 异步通知说明
        • 扩展功能
          • 花呗分期接入
          • 对账说明
          • 商户风险联防指引
          • 用户下单 IP 获取指引
        • 集成工具
          • 沙箱环境联调
          • SDK & Demo 获取
        • API 列表
          • 收单退款冲退完成通知
          • 常见问题
          • 交易
          • 账单
    • 商家扣款
      • 产品介绍
      • 权限集列表
        • 商家扣款(必选)
          • 产品介绍
          • 接入准备
          • 常见问题
          • 接入指南
            • 异步通知说明
            • 沙箱调试说明
          • API 列表
            • 签约
              • 小程序独立签约接口
              • 支付宝个人代扣协议查询接口
              • 支付宝个人代扣协议解约接口
              • 支付宝个人协议页面签约接口
            • 支付
              • app支付接口2.0
              • 统一收单交易支付接口
              • 统一收单交易查询
              • 统一收单交易退款接口
              • 统一收单交易关闭接口
              • 统一收单交易撤销接口
            • 对账
              • 查询对账单下载地址
          • 相关资料
            • 支付界面规范
            • 代扣产品常见场景值
        • 商家分账(可选)
          • 产品介绍
          • 接入准备
          • 接入指南
          • 常见问题
          • API 列表
            • 分账关系维护
              • 分账关系绑定
              • 分账关系解绑
              • 分账关系查询
            • 分账请求
              • 统一收单交易结算接口
            • 分账查询
              • 分账比例查询
              • 分账剩余金额查询
              • 交易分账查询接口
            • 消息通知
              • 交易分账结果通知
          • 相关资料
            • 沙箱调试说明
    • 周期扣款
      • 产品介绍
      • 接入准备
      • 常见问题
      • 接入指南
        • 异步通知说明
      • API 列表
        • 签约
          • 支付宝个人协议页面签约接口
          • 支付宝个人代扣协议查询接口
          • 支付宝个人代扣协议解约接口
        • 支付
          • app支付接口2.0
          • 统一收单交易支付接口
          • 统一收单交易查询
          • 统一收单交易退款接口
          • 统一收单交易退款查询
          • 统一收单交易撤销接口
          • 统一收单交易关闭接口
        • 对账
          • 查询对账单下载地址
      • 相关资料
        • 支付界面规范
        • 代扣产品常见场景值
    • 刷脸付
      • 产品介绍
      • 接入准备
      • 接入指南
      • 常见问题
      • API 列表
        • 刷脸支付初始化
        • 人脸ftoken查询消费接口
      • 相关资料
        • 异步通知说明
    • 预授权支付
      • 预授权支付产品介绍
      • 权限集列表
        • 预授权支付(必选)
          • 产品介绍
          • 接入准备
          • 常见问题
          • 接入指南
            • 快速接入
            • iOS 集成流程
            • Android 集成流程
          • API 列表
            • 预授权
              • my.tradePay
            • 交易
              • 统一收单交易支付接口
              • 统一收单交易关闭接口
              • 统一收单交易退款查询
              • 统一收单交易查询
              • 统一收单交易退款接口
            • 账单
              • 查询对账单下载地址
          • 相关资料
            • 对账说明
            • 异步通知说明
            • 支付渠道说明
            • 沙箱调试说明
        • 商家分账(可选)
          • 产品介绍
          • 接入准备
          • 接入指南
          • 常见问题
          • API 列表
            • 分账关系绑定接口
              • 分账关系绑定
              • 分账关系解绑
              • 分账关系查询
            • 分账请求
              • 统一收单交易结算接口
            • 分账查询
              • 分账比例查询
              • 分账剩余金额查询
              • 交易分账查询接口
            • 消息通知
              • 交易分账结果通知
          • 相关资料
            • 沙箱调试说明
    • 支付宝预授权
      • 产品介绍
      • 接入准备
      • 常见问题
      • 接入指南
        • 支付宝预授权快速接入
        • 异步通知说明
      • API 列表
        • 预授权
          • 线上资金授权冻结接口
          • 资金授权解冻接口
          • 资金授权操作查询接口
        • 支付
          • 统一收单交易支付接口
          • 统一收单交易退款接口
          • 统一收单交易查询
          • 支付宝订单信息同步接口
          • 统一收单交易退款查询
          • 统一收单交易关闭接口
        • 对账
          • 查询对账单下载地址
    • JSAPI 支付
      • JSAPI 支付产品介绍
      • 权限集列表
        • 支付(必选)
          • 产品介绍
          • 接入准备
          • 常见问题
          • 接入指南
          • API 列表
            • my.tradePay
            • 收单退款冲退完成通知
            • 统一收单交易创建接口
            • 统一收单交易撤销接口
            • 统一收单交易查询
            • 统一收单交易退款接口
            • 统一收单交易退款查询
            • 查询对账单下载地址
            • 统一收单交易关闭接口
          • 相关资料
            • 异步通知说明
            • 沙箱调试说明
            • 小程序细分业务场景
        • 分账(可选)
          • 产品介绍
          • 接入准备
          • 接入指南
          • 常见问题
          • API 列表
            • 分账关系维护
              • 分账关系绑定
              • 分账关系解绑
              • 分账关系查询
            • 分账请求
              • 统一收单交易结算接口
            • 分账查询
              • 交易分账查询接口
              • 分账比例查询
              • 分账剩余金额查询
            • 消息通知
              • 交易分账结果通知
          • 相关资料
            • 沙箱调试说明
  • 私域
    • 小程序产品
      • 小程序产品介绍
      • 集成说明
      • 权限集列表
        • 搜索关键词
          • 权限集介绍
          • 接入准备
          • 常见问题
          • 接入指南
            • 快速接入
            • 沙箱调试
          • API 列表
            • 申请搜索关键词
              • 提报搜索关键词
              • 查询小程序搜索关键词的审核工单的状态
              • 查询小程序可配置关键词数
              • 查询小程序已配置关键词
              • 删除搜索关键词
            • 申请服务关键词(服务推广)
              • 提报服务关键词
              • 查询小程序服务关键词的审核工单的状态
              • 服务关键词批量查询接口
              • 删除服务关键词
            • 审核进度通知
              • 小程序关键词审核进度消息通知
            • 申请搜索关键词(旧)
              • 搜索运营服务查询接口
              • 搜索运营提报基础信息工单
              • 查询搜索服务工单的详细信息
        • 搜索直达
          • 权限集介绍
          • 接入准备
          • 接入指南
          • 沙箱调试
          • 常见问题
          • region 取值说明
          • API 列表
            • 认证品牌
              • 小程序品牌提交认证时上传用户资质以及身份信息
              • 小程序品牌提交认证
              • 小程序品牌提交认证后查询品牌审核结果以及商户已有品牌
              • 小程序品牌提交认证后取消品牌认证
            • 配置搜索直达
              • 搜索直达审核进度消息通知
              • 搜索直达创建预校验
              • 申请创建搜索直达配置
              • 修改搜索直达配置
              • 下架搜索直达
              • 上架搜索直达
              • 批量查询搜索直达配置列表
              • 查询搜索直达配置详情
              • 查询可绑定的商圈查询
            • 运营搜索直达活动
              • 申请创建搜索直达活动配置
              • 修改搜索直达活动配置
              • 查询搜索直达活动配置详情
              • 批量查询搜索直达活动配置
              • 下架搜索直达活动
            • 支付宝文件
              • 支付宝文件上传接口
            • 升级/降级
              • 直达降级准入
              • 搜索直达降级
              • 搜索直达升级准入
              • 小程序升级成品牌直达
        • 收藏
          • 权限集介绍
          • 接入准备
          • 接入指南
          • 沙箱调试
          • 常见问题
          • API 列表
            • 小程序收藏引导投放活动配置创建
            • 小程序收藏引导投放活动修改
            • 小程序收藏引导投放活动详情查询
            • 小程序收藏引导投放活动配置批量查询
            • 小程序收藏引导汇总数据查询
        • 消息
          • 权限集介绍
          • 接入准备
          • 常见问题
          • 接入指南
            • 商家接入指南
            • 消息运营计划接入指南
            • 沙箱调试
          • API 列表
            • 订阅模板查询与领取
              • 消息母板批量查询接口
              • 消息子板批量查询接口
              • 消息模板申领接口
            • 订阅消息发送
              • 模板订阅关系查询
              • 小程序发送模板消息
            • 小程序内支付消息确认
              • 小程序支付消息确认接口
            • 非小程序支付消息关联关系
              • 取消关联账号和小程序
              • 查询可关联APP的账号列表
              • 查询已关联指定APP的账号列表
              • 关联账号和小程序
            • 消息运营计划
              • 推广计划状态变更消息
              • 创建推广计划
              • 查询推广计划
              • 停止推广计划
        • 小程序码
          • 权限集介绍
          • 接入准备
          • 接入指南
          • 沙箱调试
          • 常见问题
          • API 列表
            • 小程序二维码
              • 小程序生成推广二维码接口
            • 创建关联普通二维码模式
        • 小程序服务
          • 权限集介绍
          • 接入准备
          • 沙箱调试
          • 常见问题
          • API 列表
            • 服务提供
              • 服务schema下发
              • 服务提报申请
              • 服务查询
              • 服务批量查询
              • 服务失效接口
            • 消息通知
              • 服务消息审核通知
          • 相关资料
            • Schema 规则介绍
            • 各个行业场景服务接入资料
        • 订单中心
          • 权限集介绍
          • 接入准备
          • 常见问题
          • 接入指南
            • 开发接入
            • 沙箱调试
            • 各行业订单同步/查询详情
              • 行业订单模版列表
          • API 列表
            • 商户订单实时信息查询
            • 商品文件上传接口
            • 订单数据同步接口
          • 相关资料
            • 物流查询插件
        • 小程序开发管理
          • 权限集介绍
          • 接入准备
          • 接入指南
          • 沙箱调试
          • API 列表
            • 常见问题
            • 小程序基础信息
              • 查询小程序基础信息
              • 小程序修改基础信息
              • 小程序设置客服方式
            • 小程序开发版本
              • 小程序审核通过通知
              • 小程序审核不可营销通知
              • 小程序审核驳回通知
              • 小程序退回开发
              • 小程序灰度上架
              • 小程序结束灰度
              • 小程序上架
              • 小程序下架
              • 小程序回滚
              • 小程序删除版本
              • 小程序取消体验版
              • 小程序提交审核
              • 小程序撤销审核
              • 小程序基于模板上传版本
              • 查询使用模板的小程序列表
              • 小程序查询版本构建状态
              • 小程序版本详情查询
              • 小程序版本列表查询
              • 小程序体验版状态查询接口
              • 小程序生成体验版
            • 小程序应用成员
              • 应用删除成员
              • 应用查询成员列表
              • 应用添加成员
            • 个体账户
              • 个人账户升级为个体工商户
            • 小程序类目
              • 小程序类目树查询
              • 查询类目所需资质信息
            • 小程序二维码
              • 关联普通二维码
              • 删除已关联普通二维码
            • 待创建小程序
              • 商户确认服务商代创建小程序结果通知
              • isv查询代商家创建小程序记录
              • isv服务商代商户创建小程序
            • 小程序域名
              • 小程序添加域白名单
              • 小程序删除域白名单
            • 违规记录
              • 违规与处罚消息通知
              • 违规记录列表查询
              • 违规记录详情查询
            • 插件管理
              • 插件版本升级
              • 插件版本撤销灰度
              • 全量插件使用端版本配置
              • 插件使用关系查询
        • 交易组件
          • 权限集介绍
          • 接入准备
          • 接入指南
            • 升级SOP
            • 接入概述
            • 基础功能
              • 数字零售场景开发接入
              • 数娱景旅场景开发接入
            • 扩展功能
              • 扩展组件介绍
              • 前置优惠组件接入文档
              • 商品详情页组件接入文档
              • 商品订单页组件接入文档
            • 调试与验收
              • 验收工具
          • API 列表
            • API 概述
            • 订单前置判断接口
            • 小程序交易组件订单
              • 订单结果通知
              • 结算消息通知
              • 订单发货
              • 订单确认收货
              • 查询订单
              • 订单创建
            • 查询小程序订单对账列表信息
          • 常见问题
            • 通用问题
          • 相关资料
            • 商品详情页获取优惠信息
            • 商品订单页获取优惠信息
            • 物流编码
        • 小程序商品
          • 权限集介绍
          • 接入准备
          • 常见问题
          • 接入指南
            • 沙箱调试说明
            • 普通商品产品接入指南
              • 普通商品产品接入流程
              • 普通商品快速接入
              • 履约信息管理
            • 本地生活商品接入指南
              • 本地生活商品产品接入流程
              • 本地生活商品快速接入
          • API 列表
            • 普通商品
              • 普通商品履约模版
                • 履约模板查询接口
                • 履约信息查询接口
                • 履约信息同步
              • 获取普通商品模板信息
              • 获取普通商品类目接口
              • 小程序商品创建接口
              • 小程序商品更新接口
              • 商品免审更新接口
              • 小程序商品分页查询接口
              • 小程序商品详情查询接口
            • 本地生活商品
              • 商品管理
                • 获取本地商品类目接口
                • 统一收单交易支付接口
                • 获取本地商品模板信息
                • 小程序本地商品创建
                • 小程序本地商品免审更新商品接口
                • 小程序本地商品修改接口
                • 小程序本地商品详情查询接口
                • 小程序本地商品分页查询接口
              • 凭证管理
                • 三方凭证发放
                • 小程序内凭证核销准备接口
                • 凭证消息通知
                • 凭证核销准备
                • 同步凭证核销状态
                • 撤销凭证核销状态
                • 订单退款前商户回复确认退款结果
                • 查询凭证信息
                • 条件查询用户凭证
              • 支付宝文件
                • 支付宝文件上传接口
              • 商品变更相关
                • 商品状态变更消息同步接口
                • 小程序商品移除接口
          • 相关资料
            • 相关资料汇总
            • 本地生活商品模版
    • 支付有礼
      • 产品介绍
      • 接入准备
      • 接入指南
      • 沙箱调试
      • 常见问题
      • API 列表
        • 推广计划
          • 推广计划状态变更消息
          • 停止推广计划
          • 查询推广计划
          • 创建推广计划
  • 公域
    • 经营推广
      • 产品介绍
      • 权限集列表
        • 引流转化
          • 权限集介绍
          • 接入准备
          • 常见问题
          • 接入指南
            • 开发接入
            • 沙箱调试
          • API 列表
            • 推广计划
              • 推广计划状态变更消息
              • 创建推广计划
              • 查询推广计划
              • 停止推广计划
            • 图片素材
              • 营销图片资源上传接口
        • 商品卖货
          • 权限集介绍
          • 接入准备
          • 接入指南
          • 常见问题
          • API 列表
            • 推广计划状态变更消息
            • 创建推广计划
            • 查询推广计划
            • 停止推广计划
  • 营销
    • 商家卷
      • 商家券产品介绍
      • 接入准备
      • 常见问题
      • 接入指南
        • 沙箱调试说明
        • 商家券测试指导方案
        • 开发接入
          • 上传自定义券码模式
          • 发券时指定券码模式
      • API 列表
        • 接口概述
        • 活动创建
          • 券活动创建通知
          • 创建商家券活动
          • 同步商家券券码
        • 活动修改
          • 券活动修改通知
          • 修改商家券活动基本信息
        • 活动停止
          • 券活动停止通知
          • 停止商家券活动
        • 预算增加
          • 券活动预算追加通知
          • 修改商家券活动发券数量上限
        • 活动发放
          • 领券组件插件接入流程
          • 活动领取咨询接口
        • 优惠卷核销
          • 同步券核销状态
          • 取消券核销状态
        • 活动查询
          • 卷活动查询
            • 查询商家券活动
            • 查询活动详情
            • 统计商家券券码数量
            • 条件查询活动列表
          • 用户卷查询
            • 条件查询用户券
            • 查询用户券详情
          • 券状态消息
            • 券领取通知
            • 券核销消息
            • 券过期消息
          • 可用范围查询
            • 查询活动可用小程序
            • 查询活动可用门店
            • 查询活动适用商品
        • 蚂蚁店铺
          • 店铺保存审核通过消息
          • 店铺保存拒绝消息
          • 蚂蚁店铺创建
          • 修改蚂蚁店铺
          • 商户申请单查询
          • 店铺分页查询接口
          • 店铺查询接口
          • 蚂蚁店铺关闭
    • 商家会员卡
      • 产品介绍
      • 接入准备
      • 商户动态发码
      • 接入指南
        • 基础功能
        • 辅助功能
        • 扩展功能
        • 沙箱调试
      • API 列表
        • 基础功能
          • 会员卡开通,获取会员卡信息
          • 会员卡开卡结果通知
          • 会员卡模板创建
          • 上传门店照片和视频接口
          • 会员卡开卡表单模板配置
        • 辅助功能
          • 会员卡模板修改
          • 会员卡模板查询接口
          • 会员卡查询
          • 会员卡更新
          • 会员卡删卡
          • 会员卡消息通知
      • 常见问题
        • 常见问题
        • 升级指南
          • 升级说明
          • 升级至 3.1 版本(极速版)
          • 升级至 3.0 版本
          • 联调问题排查
    • 现金红包
      • 产品介绍
      • 接入准备
      • 接入指南
      • 常见问题
      • API 列表
        • 资金转账页面支付接口
        • “C2C”现金红包
          • 资金单据状态变更通知
          • 资金退回成功通知
          • 单笔转账接口
          • 转账业务单据查询接口
          • 资金退回接口
        • “B2C”现金红包
          • 资金单据状态变更通知
          • 单笔转账接口
          • 转账业务单据查询接口
        • 现金红包无线支付接口
    • 棋盘密云
      • 产品介绍
      • 接入准备
      • 接入指南
      • 常见问题
      • 参考资料
      • API 列表
        • 接口上传人群
          • 上传创建人群
          • 人群中追加用户
          • 人群中删除用户
        • 查询圈选标签列表
          • 查询圈选标签列表
          • 标签圈选创建人群
          • 标签圈选预估人群规模
        • 管理人群
          • 查询人群列表
          • 查询人群详情
          • 修改人群
        • 数据洞察
          • 看板分析
          • 画像分析
          • 行为分析
          • 趋势分析
          • 常住省市查询
    • 支付卷
      • 产品介绍
      • 接入准备
      • 接入指南
      • API 列表
        • 支付卷
          • 营销图片资源上传接口
          • 创建支付券
          • 激活支付券
          • 查询支付券详情
          • 修改支付券基本信息
          • 追加支付券预算
          • 停止支付券
          • 券活动创建通知
          • 券活动修改通知
          • 券活动预算追加通知
          • 券活动停止通知
  • 资金
    • 商家分账
      • 产品介绍
      • 接入准备
      • 接入指南
      • 常见问题
      • 沙箱调试说明
      • API 列表
        • 分账关系维护
          • 分账关系绑定
          • 分账关系解绑
          • 分账关系查询
        • 分账请求
          • 统一收单交易结算接口
        • 分账查询
          • 分账比例查询
          • 分账剩余金额查询
          • 交易分账查询接口
        • 消息通知
          • 交易分账结果通知
    • 花呗分期
      • 花呗分期产品介绍
      • 花呗分期付款界面规范
      • 常见问题
      • 接入指南
        • 接入说明
        • 接口说明
        • 应用案例
        • 花呗分期服务商合作说明
      • API 列表
        • 手机网站支付接口2.0
        • app支付接口2.0
        • 统一收单交易支付接口
        • 统一收单线下交易预创建
    • 转账到支付宝账户
      • 产品介绍
      • 接入准备
      • 支付界面规范
      • 接入指南
        • 开发接入
        • 沙箱调试
      • API 列表
        • 资金
          • 资金单据状态变更通知
          • 单笔转账接口
          • 转账业务单据查询接口
        • 账单
          • 查询对账单下载地址
        • 支付宝资金账户资产查询接口
        • 申请电子回单(incubating)
        • 查询电子回单状态(incubating)
      • 常见问题
        • 单笔转账账单回单获取说明
        • 帮助中心
        • 常见问题
        • 云排查
  • 会员
    • 支付宝身份验证
      • 支付宝身份验证产品介绍
      • 接入准备
      • 接入指南
        • 接入方式概览
        • 小程序接入流程
        • 服务端 SDK 接入流程
      • API 列表
        • 身份认证开始认证
        • 身份认证记录查询
        • 身份认证初始化服务
    • APP 支付宝登录
      • APP支付宝登录产品介绍
      • APP支付宝登录界面规范
      • 接入准备
      • 联调问题排查
      • 接入指南
        • 极简版 SDK 调用方法
        • 极简版授权请求参数和返回
        • 完整版授权 SDK 调用方法
        • 完整版授权请求参数和返回
        • 服务端接入
      • API 列表
        • 用户登录授权
        • 换取授权访问令牌
        • 支付宝会员授权信息查询接口
    • 获取会员信息
      • 产品介绍
      • 接入准备
      • 常见问题
      • 接入指南
        • PC 网页内获取用户信息
        • 生活号/H5 内获取用户信息
        • 沙箱调试说明
      • API 列表
        • 用户信息
          • 支付宝会员授权信息查询接口
        • 用户授权
          • 用户授权取消消息
          • 用户授权关系查询
  • 信用
    • 芝麻先享
      • 产品介绍
      • 接入准备
      • 验收规范
      • 常见问题
      • 接入指南
        • 固定金额模式
        • 动态金额模式
        • 异步扣款通知
      • API 列表
        • 服务开通
          • 服务开通/授权状态变更通知
          • 信用服务开通/授权
          • 查询服务开通/授权信息
        • 信用下单
          • 芝麻先享信用服务下单(用户确认场景)
          • 芝麻先享信用服务订单状态变更通知
          • 换取授权访问令牌
          • 统一收单交易支付接口
          • 芝麻信用服务下单(免用户确认场景)
          • 信用服务订单查询
          • 结束信用服务订单
          • app支付接口2.0
        • 扣款
          • 统一收单交易订单支付接口
          • 统一收单交易查询
          • 统一收单交易退款接口
    • 芝麻免押
      • 芝麻免押产品介绍
      • 接入准备
      • 接入指南
      • 常见问题
      • API 列表
        • 预授权
          • 线上资金授权冻结接口
          • 资金授权解冻接口
          • 资金授权操作查询接口
        • 支付
          • 统一收单交易支付接口
          • 统一收单交易查询
          • 统一收单交易退款接口
          • 统一收单交易退款查询
          • 统一收单交易关闭接口
          • 支付宝订单信息同步接口
        • 对账
          • 查询对账单下载地址
      • 相关资料
        • 异步通知参数说明
        • 全场景逾期时间说明
        • 接入要求及体验规范
    • 芝麻工作证
      • 产品介绍
      • 接入准备
      • 接入指南
      • API 列表
        • 工作证身份验真消息通知
        • 职得身份认证查询接口
    • 芝麻 GO
      • 产品介绍
      • 接入准备
      • 常见问题
      • 接入指南
        • 芝麻 GO 普通版
          • 开通芝麻 GO 普通版
          • 任务数据回传&查询
          • 关闭芝麻 GO 普通版
          • 协议变更通知
          • 结算芝麻 GO 普通版
          • 芝麻 GO 普通版退款
          • 辅助功能接入
          • 查询芝麻 GO 普通版模板
          • 创建芝麻 GO 承诺模式模板
        • 周期扣版
          • 创建芝麻 GO 月月省(周期扣)模式模板
          • 关键系统交互
          • 开通芝麻 GO 周期扣版
          • 周期代扣
          • 关闭芝麻 GO 周期扣版
          • 协议变更通知
          • 结算芝麻 GO 周期扣版
          • 芝麻 GO 退款
          • 辅助功能说明
          • 查询芝麻 GO 周期扣版模板
        • 周期灵活扣 FOR 运营商场景
          • 开通芝麻 GO
          • 履约期周期灵活代扣(履约期按期扣费能力)
          • 优惠任务数据回传&查询
          • 关闭芝麻 GO 灵活扣版
          • 协议变更通知
          • 结算芝麻 GO
          • 结算发起后进行拆单支付
          • 芝麻 GO 退款
          • 创建芝麻 GO 模板
          • 其他辅助说明
          • 查询芝麻 GO 周期灵活扣版模板
        • 芝麻GO 轻研版
          • 前端组件接入
          • 轻研 API 接入
          • 其他辅助功能
      • API 列表
        • 芝麻GO业务签约变更商户通知
        • 芝麻GO业务协议变更商户通知
        • 芝麻GO业务结算变更商户通知
        • 芝麻GO签约预创单
        • 商家芝麻GO累计数据回传接口
        • 芝麻GO页面签约接口
        • 商家芝麻GO累计数据查询接口
        • 芝麻GO结算申请
        • 芝麻GO结算退款接口
        • 芝麻Go协议查询接口
        • 芝麻GO协议解约
        • 商户创建芝麻GO模板接口
        • 芝麻GO模板查询
  • 安全
    • 交易安全防护
      • 交易安全防护产品介绍
      • 接入准备
      • 接入指南
      • API 列表
        • 商户数据同步
        • 停车场信息查询
  • 其他
    • 车主平台停车在线缴费
      • 车主平台停车在线缴费产品介绍
      • 车主平台停车在线缴费界面规范
      • 接入准备
      • 接入指南
      • 常见问题
      • API 列表
        • 统一收单交易创建接口
        • 统一收单交易查询
        • 换取授权访问令牌
        • 停车ISV系统配置接口
        • ISV系统配置查询接口
        • 录入停车场信息
        • 修改停车场信息
        • 车辆驶入接口
        • 车辆驶出接口
        • 车牌查询接口
        • 订单同步接口
        • 订单更新接口
        • 停车场价格信息同步
        • 停车场车位信息同步
        • 停车支付模板消息配置
        • 停车离场消息模板配置
        • 停车入场模板消息配置
    • 第三那方应用授权
      • 第三方应用授权产品介绍
      • 全权委托授权代开发模式说明
      • 支持全权委托授权代开发的产品
      • 接入指南
      • API 列表
        • 第三方应用授权取消消息
        • 查询某个应用授权AppAuthToken的授权信息
        • 换取应用授权令牌
        • ISV向商户发起应用授权邀约
    • 中小学教育缴费
      • 中小学教育缴费产品介绍
      • 接入准备
      • 接入指南
      • API 列表
        • 缴费
          • 教育缴费学校信息录入接口
          • 教育缴费账单发送接口
          • 教育缴费账单状态同步接口
          • 缴费账单查询
        • 支付
          • 统一收单交易退款接口
          • 统一收单交易查询
    • 服务市场基础包
      • 服务市场基础产品介绍
      • 接入准备
      • 接入指南
      • API 列表
        • 服务市场订单状态变更消息通知
        • 续费订单主动通知
        • 服务市场商户确认订购通知
        • 订购插件订单明细查询
        • 服务商接单操作
        • 服务商拒绝接单
        • 服务订单明细实施项单项取消
        • 服务商完成订单内单个明细实施项
        • 服务商代商家确认实施完成
        • 门店插件上架操作
        • 门店插件下架操作
        • 服务商推广关系查询
        • 服务市场产品授权升级
    • 服务商代运营基础包
      • 服务商代运营基础产品介绍
      • 接入准备
      • 间连分级商户入驻接入指南
      • 接入指南
        • 代运营授权
        • 代商家报名返佣政策
        • 餐饮新蓝海&快消直通车 IoT 交易协作费代报名资质要求
        • IoT 设备绑定门店 API 对接指南
      • API 列表
        • 代运营授权
          • 向商户发起代运营操作
          • 查询代运营授权或者账号绑定二维码
          • 查询服务商代运营操作结果
        • 新蓝海活动报名
          • 服务商返佣活动申请单结果通知
          • 图片上传接口
          • 服务商返佣活动报名申请
          • 服务商返佣活动申请单修改
          • 服务商返佣活动申请单详情查询
        • IoT 三绑定
          • 服务商代运营操作结果通知接口
          • IoT设备绑定校验
          • IoT设备绑定门店
          • IoT设备绑定关系查询
          • 查询代运营授权或者账号绑定二维码
          • 向商户发起代运营操作
          • 查询服务商代运营操作结果
    • 支付宝广告投放
      • 支付宝广告投放产品介绍
      • 接入准备
      • 接入指南
        • 接入指南_自建页留资和转化管理
        • DSP 创意送审和创意状态查询
      • API 列表
        • 自建推广页列表批量查询
        • 自建推广页留资数据查询
        • 转化数据回传
        • 外部DSP创意送审接口
        • DSP广告状态查询接口
    • 支付宝加油
      • 产品介绍
      • 接入准备
      • 接入指南
      • API 列表
        • 门店管理
          • 店铺保存拒绝消息
          • 店铺保存审核通过消息
          • 店铺分页查询接口
          • 修改蚂蚁店铺
          • 图片上传
          • 商户申请单查询
          • 蚂蚁店铺创建
          • 蚂蚁店铺关闭
        • 商品管理
          • 商品删除接口
          • 商品查询接口
          • 商品创建接口
          • 商品状态修改接口
          • 商品修改接口
        • 支付
          • 统一收单交易创建接口
          • 统一收单交易查询
          • 统一收单交易撤销接口
          • 统一收单交易退款接口
          • 统一收单交易关闭接口
          • 查询对账单下载地址
    • 应用AES密钥管理
      • 应用 AES 密钥管理产品介绍
      • 接入准备
      • 接入指南
      • API 列表
        • 授权应用aes密钥查询
        • 授权应用aes密钥设置
    • 分享到支付宝
      • 分享到支付宝产品介绍
      • 接入准备
      • Android 快速接入
        • Android 接入指南
        • Android 功能开发说明
      • IOS 快速接入
        • iOS 接入指南
        • iOS 功能开发说明
    • 三方开发基础包
      • 三方开发基础产品介绍
      • 接入准备
      • 接入指南
      • API 列表
        • 隐私政策审批驳回通知
        • 小程序隐私政策审批通过通知
        • 申请用户信息
          • 用户信息申请记录审核通知
          • 查询应用可申请的接口出参敏感字段列表
          • 申请获取接口用户敏感信息字段
          • 查询接口字段使用场景
          • 用户信息申请记录查询
        • 应用用户标识(openid)信息
          • 应用信息修改接口
          • 应用信息查询接口
        • 代商家创建小程序
          • 商户确认服务商代创建小程序结果通知
          • isv服务商代商户创建小程序
          • isv查询代商家创建小程序记录
        • 代商家创建试用小程序
          • 商户确认服务商代创建试用小程序结果通知
          • 查询试用小程序
          • ISV代创建试用小程序
        • 小程序创建隐私协议
        • 小程序隐私字段查询
        • 小程序隐私政策审核状态查询
    • 代开发核心 API
      • 代开发核心 API 产品介绍
      • 接入准备
      • 接入指南
        • 查询商家产品开通状态
        • 开通即授权
        • 调用接口代商家发起开通当面付申请
        • 调用接口代商家发起开通 App 支付申请
        • 调用接口代商家发起开通通用流程
      • API 列表
        • ISV邀约即授权页面创建
        • 查询商户某个产品的签约状态
        • 开启代商户签约、创建应用事务
        • 代商户签约,提交信息确认接口
        • 代签约当面付产品
        • 代签约APP支付产品
        • 代签约产品通用接口
        • 查询申请单状态
        • 提交代商户签约、创建应用事务
        • 取消代商户签约、创建应用事务
        • 查询签约申请单状态
        • 查询签约授权一体化订单状态详情
        • 创建签约授权一体化订单
    • 基础功能产品
      • 交易支付投诉处理
        • 交易支付投诉处理产品介绍
        • 接入准备
        • 接入指南
        • 常见问题
        • API 列表
          • 交易投诉通知回调
          • 查询单条交易投诉详情
          • 查询交易投诉列表
          • 商户上传处理图片
          • 商家处理交易投诉
          • 商家留言回复
          • 商家补充凭证
      • 付款码解码查询UID
        • 付款码解码查询UID产品介绍
        • 接入准备
        • 接入指南
        • API 列表
          • 通用当面付二阶段接口
      • 蚂蚁门店管理
        • 蚂蚁门店管理产品介绍
        • 接入准备
        • 接入指南
          • 接入指南
          • 沙箱调试
        • API 列表
          • 店铺保存审核通过消息
          • 店铺保存拒绝消息
          • 蚂蚁店铺
            • 蚂蚁店铺关闭
            • 店铺查询接口
            • 店铺分页查询接口
            • 商户申请单查询
            • 修改蚂蚁店铺
            • 蚂蚁店铺创建
          • 商户类目
            • 商户mcc信息查询
          • 商家图片
            • 图片上传
          • 店铺增加收单账号
      • CMM 插件化能力
        • 蚂蚁智能客服(CCM)插件化能力产品介绍
        • 接入准备
        • 快速接入
          • 基础功能
          • 实现SPI接口
          • 插件iframe安全验证机制
        • API 列表
          • 可实现的 SPI
            • 租户角色列表查询接口
            • 租户热线技能组列表查询接口
            • 客服角色设置接口
            • 客服已授权角色列表查询接口
            • 客服热线技能组列表查询接口
            • 客服热线技能组设置接口
            • ISV 订单查询
          • 商家/ISV 调用支付宝
            • 初始化
              • isv服务初始化接口
              • 创建租户实例
              • 查询单个租户实例(数据权限)
              • 列出所有的租户实例(数据权限)
              • 租户开通isv服务接口
              • 关闭租户开通的isv服务接口
              • ccm isv注册接口
              • 关闭租户开通的isv服务接口
              • 列出所有的功能点
            • 客服
              • 查询客服状态变更流水日志
              • 创建角色
              • 更新角色
              • 删除角色
              • 分页查询角色
              • 新增客服接口
              • 更新客服接口
              • 删除客服接口
              • 查询客服详情
              • 客服查询接口
            • 服务记录
              • 创建服务记录
              • 变更服务记录
            • 知识库
              • 知识库-库-创建
              • 知识库-库-删除
              • 知识库-库-修改
              • 知识库-库-批量查询
              • 知识库-类目-创建
              • 知识库-类目-删除
              • 知识库-类目-修改
              • 知识库-类目-获取
              • 知识库-类目-批量查询
              • 知识库-类目-发布
              • 知识库-节点-创建
              • 知识库-节点-删除
              • 知识库-节点-修改
              • 知识库-节点-批量查询
              • 知识库-问答-创建
              • 知识库-问答-删除
              • 知识库-问答-修改
              • 知识库-问答-批量查询
              • 知识库-问答-获取
              • 政务事项同步
              • 知识库问答管理
              • 政务事项删除
            • 数字人
              • 虚拟数字人开放接口调用
            • 在线
              • 查询用户未读信息数
      • 学校库
        • 学校库能力介绍
        • 接入准备
        • 接入指南
        • API 列表
          • 查询学校信息
          • 支付宝文件上传接口
          • 入驻学校信息
      • 商家账单
        • 商家账单产品介绍
        • 接入准备
        • 接入指南
        • API 列表
          • 账单
            • 查询对账单下载地址
          • 支付宝商家账户卖出交易查询
          • 支付宝商家账户买入交易查询
          • 支付宝商家账户账务明细查询
          • 支付宝商家账户充值,转账,提现查询
          • 支付宝商家账户保证金查询
          • 支付宝商家账户当前余额查询
          • 支付宝商家账户历史余额查询
      • 商户自主监控
        • 商户自主监控产品介绍
        • 快速接入
        • API 列表
          • 商户自主监控自定义指标数据上报接口
          • 商户自主监控日志数据上报接口
      • 支付宝卡包
        • 支付宝卡包产品介绍
        • 接入准备
        • 参数详细说明
        • 接入指南
          • 基础功能
          • 进阶功能-优惠券礼包
        • API 列表
          • 卡券模板创建接口
          • 卡券模板更新接口
          • 卡券实例发放接口
          • 卡券实例更新接口
          • 上传门店照片和视频接口
      • 生活缴费
        • 生活缴费产品介绍
        • 接入准备
        • API 列表
          • 创建账单
          • 缴费直连代扣签约
          • 缴费直连代扣取消签约
          • 公共事业缴费直连代扣扣款支付接口
          • 缴费直连代扣订单支付状态查询
      • 地铁线上购票
        • 地铁线上购票产品介绍
        • 接入准备
        • 接入指南
        • API 列表
          • 地铁购票核销码发码
          • 地铁购票发码退款
          • 地铁购票站点数据查询
          • 地铁购票订单批量查询
      • 口碑开店
        • 口碑开店产品介绍
        • 接入准备
        • 接入指南
        • 设置/修改门店收款账号
        • API 列表
          • 创建门店信息
          • 门店类目配置查询接口
          • 修改门店信息
          • 查询单个门店信息接口
          • 查询商户的门店编号列表
          • 门店摘要信息批量查询接口
          • 业务流水批量查询接口
          • 上传门店照片和视频接口
        • 相关资料
          • 门店类目
      • 营销活动
        • 营销活动产品介绍
        • 营销活动详情
        • 接入准备
        • 接入指南
          • 基础功能
          • 进阶指南
        • API 列表
          • 活动创建接口
          • 活动修改接口
          • 活动下架接口
          • 活动详情查询
          • 口碑营销活动列表查询
          • 招商门店分页查询接口
          • 商户创建商品代金券
          • 商户下架代金券
          • 商户查询商品代金券详情
          • 商户修改商品代金券
          • 商户查询商品代金券列表
      • 私域营销
        • 私域营销产品介绍
        • 接入准备
        • 接入指南
          • 开发接入
          • 领券组件插件接入流程
          • 沙箱调试
        • API 列表
          • 活动查询
            • 券活动查询
              • 查询活动详情
              • 条件查询活动列表
            • 用户卷查询
              • 条件查询用户券
              • 查询用户券详情
            • 卷状态消息
              • 券领取通知
              • 券核销消息
              • 券过期消息
            • 可用范围查询
              • 查询活动可用商户
              • 查询活动可用小程序
              • 查询活动可用门店
              • 查询活动适用商品
            • 订单可用卷查询
              • 订单优惠前置咨询
          • 活动发放
            • 领券组件插件接入流程
            • 活动领取咨询接口
        • 相关资料
          • 间连分级商户入驻接入指南
      • 获取 AliOS 车载设备信息
        • 获取 AliOS 车载设备信息产品介绍
        • 接入准备
        • 接入指南
        • API 列表
          • 换取授权访问令牌
          • 查询阿里车的车辆信息
      • 商家费率申请
        • 商家费率申请产品介绍
        • 接入准备
        • 接入指南
        • API 列表
        • 特殊费率申请
      • E签宝电子面签
        • e 签宝电子面签产品介绍
        • 接入准备
        • 常见问题
        • 接入指南
          • 开发接入
          • 文件流上传方法
        • API 列表
          • 合同模板管理接口
            • 创建合同模板(E签宝)
            • 获取合同模板设置地址(E签宝)
          • 合同签署接口
            • 创建电子合同签署流程(E签宝)
            • 签署流程查询(E签宝)
            • 获取签署地址
            • 获取签署流程合同与附件的下载地址(E签宝)
            • 获取文件直传地址(E签宝)
            • 签署流程撤销(E签宝)
          • 创建流程(E签宝)
          • 签署流程归档
  1. 支付宝加油

接入指南

完成 接入准备 后,油企/服务商的研发人员可根据本文内容快速接入支付宝加油。
**说明:**服务商代商家调用服务端接口仅需获取并传入 app_auth_token(商家应用授权令牌)即可,其余入参与接口说明一致,详情可查看 代商家调用接口说明。

流程说明#

业务流程#

1.png

流程说明#

1.
用户在支付宝搜索 支付宝加油 ,进入官方小程序;
2.
找到对应加油站,点击 立即加油 跳转至油企小程序 不下车加油 页;
3.
用户选择 油号、油枪,输入需支付金额,完成支付;
4.
加油员确认加油及支付结果并放行。
5.
其它功能:
用户在支付宝加油中完成的支付,需纳入商家的对账体系,确保商家对账的简便性和完整性。
除支付功能外,油企还可以在下单小程序上自定义其它功能,如:电子会员卡、优惠券领取等。

开发流程#

开发流程图#

整体业务.png

重要流程说明#

1.
油企/服务商前端开发者可复用支付宝提供的 不下车加油 功能页模板,也可根据设计稿自行开发;
2.
开发者需通过服务端接口:
3.
1.
创建/管理加油站支付宝门店,用于在官方频道进行展示。同一站点仅需创建一次,后续仅管理门店及其商品即可。
2.
创建/管理加油门店商品(即油品),只有创建油品后用户才可在官方频道检索到对应门店信息。
4.
油企/服务商开发者完成前、服务端开发。创建门店商品前,需与支付宝进行技术联调,避免线上用户检索到测试阶段门店信息造成客诉。

油企小程序开发#

数据传递说明#

1.
用户在官方 支付宝加油 小程序中选中所需加油站并点击 立即加油,支付宝加油小程序将调用 my.navigateToMiniProgram 接口,引导用户跳转到油企小程序对应页面(跳转地址为创建门店时设置的 MAYIJIAYOU_JUMPURL 扩展参数值,详请可查看下文 门店管理>第二步:创建门店)。更多跳转说明详情可查看 小程序相互跳转。
2.
跳转至油企的小程序时,支付宝加油将在 extraData 中传入如下四个参数,参数说明如下:
alipay_store_id:支付宝侧门店编号即 shop_id,获取查看下文 获取支付宝门店 id。
store_id:商家侧自定义门店编号。
oil_num:油号,默认为 92#,取值支持 92#、95#、98#。
myjy_source:渠道来源,固定为 mayijiayou。
支付宝加油小程序跳转至油企小程序示例:
my.navigateToMiniProgram({
    appId:'xxx',// 油企小程序APPID
    path: 'x/y/z', // 油企小程序页面地址
    extraData: { // 业务参数
      alipay_store_id: '111', // 支付宝门店创建时返回的shop_id
      store_id:'222', // 商家侧自定义门店编号
      oil_num:'92#', // 油号
      myjy_source: 'mayijiayou' // 用户来源渠道,固定为 mayijiayou 表示由支付宝加油小程序跳转
  }
});
1.
油企小程序可在自身应用 App.js 中通过 App.onLaunch()、App.onShow() 获取数据并据此进行下单处理,详情可查看 app.js。

核心功能页面开发#

访问小程序参数识别#

为方便油企/服务商快速规范开发加油小程序,支付宝提供了 不下车加油 功能页面小程序模板,点此下载 不下车加油小程序(民营/外资) 。
其它功能页面可直接查看如上 DEMO 样式或自行设计,支付宝还提供了民营油企设计稿供开发者参考,点此下载 油企小程序DEMO 。
使用油企小程序 DEMO 需注意,支付宝加油小程序会传入如下四个参数:
extraData: { // 业务参数
      alipay_store_id: '111', // 支付宝门店创建时返回的shop_id
      store_id:'222', // 商家侧自定义门店编号
      oil_num:'92#', // 油号
      myjy_source: 'mayijiayou' // 用户来源渠道,固定为 mayijiayou 表示由支付宝加油小程序跳转
  }
参数说明:
alipay_store_id 和 store_id 可以用来准确定位到加油站页面,请勿跳转到主页再让用户选择加油站。
oil_num 可以提前帮用户选好油号,若入参无油号或油号无法匹配当前油站,则不选。
myjy_source 用于在支付传参时传入 business_params,支付传参详情查看下文 接入支付 章节。

价格异常判断#

用户进入油站详情页面之后,油企/服务商需根据门店编号获取支付宝加油商品信息进行比对。如果加油站当日油品油价信息与当前界面展示油价不同,需弹窗提示用户。同时,异步更新支付发起门店信息,将最新油品油价信息传入。
2.png

两种加油模式#

模式一:选择油号、枪号之后输入加油金额支付(多数油站适用),设计如下图:
3.png
模式二:选择枪号查询订单金额(部分智慧油机油站适用),设计如下图:
4.png5.png

支付传参#

支付接口,需精准传入 加油渠道、门店信息、商品(即油品)信息,详情可查看下文 接入****支付。

付后账单详情页#

支付完成后,需展示账单详情页,供车主向加油员展示,由加油员确认后放行。账单详情页面可返回官方 支付宝加油 小程序,跳转至:alipays://platformapi/startapp?appId=2019041063881050 即可。
6.png

功能页面扩展(可选)#

权限授权弹窗#

定位权限#

请不要在用户进入油站详情页面时,申请定位权限,直接弹窗会引起转化降低。定位权限,仅限油站拥有自己的油站列表时,在列表页申请实现。
如油站列表页面申请权限,需注意用户拒绝后,仍需友好展示。展示目的性的文案,如:“获取您的位置,便于推荐附近油站”。
7.png8.png

手机号码权限#

如果无会员优惠能力,请勿申请手机号码。
如油站根据手机号码提供优惠油价或者其它会员特权,建议做一个浮层在立即支付按钮旁引导。如果用户拒绝授权,仍然可以以正常油价完成交易支付。
9.png

会员卡/储值卡能力#

可通过油站页面固定位置,引导油卡开通,并对已开通油卡进行服务展示。请勿将会员开通流程作为加油支付的必须流程,否则会有明确转化影响。
10.png11.png

门店管理#

油企/服务商需根据如下指引在支付宝注册加油站门店(支付宝门店,非口碑门店),完成后油企/服务商才可为其维护商品(即油品)信息。
**注意:**所有油站类型门店需调用接口进行创建,不支持通过 PC 端创建加油站门店。

接口调用流程图#

12.png

第一步:上传图片资质#

开发者需调用 ant.merchant.expand.indirect.image.upload(图片上传接口),上传营业执照等图片资质内容至支付宝,获取资质 image_id 用于后续创建门店。不支持上传网络图片。

资质说明:#

营业执照:门店营业执照。需清晰可见。
特殊行业资质:如果营业执照未包含 “销售/批发汽油、煤油、柴油、天然气、成品油”等项目,则需要根据自身情况提供。需清晰可见。
门头照:需三张包含加油站名称的清晰门头照。
门店授权函:如果是连锁店,需要提供总部的授权函照片,照片需清晰可见。

请求示例#

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AntMerchantExpandIndirectImageUploadRequest request = new AntMerchantExpandIndirectImageUploadRequest();
//request.putOtherTextParam("app_auth_token", "202125BBaffb2ecd6d9d46ad95ef802232971D33"); // 应用授权令牌,ISV代商家接入时使用
request.setImageType("jpg");
FileItem ImageContent = new FileItem("C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg");
request.setImageContent(ImageContent);
AntMerchantExpandIndirectImageUploadResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

重要入参说明#

image_type:必选。图片格式,支持格式为:BMP、JPG、JPEG、PNG、GIF。
image_content:必选。图片二进制字节流,最大为 10 M。

响应示例#

{
    "ant_merchant_expand_indirect_image_upload_response": {
        "code": "10000",
        "msg": "Success",
        "image_id": "a5d373f6-3e79-405f-9993-fb7ea051c372.jpg"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

响应参数说明#

image_id:图片在文件存储平台的标识,用于后续创建加油门店。

第二步:创建门店#

上传资质图片获取 image_id 后,油企/服务商需调用 ant.merchant.expand.shop.create(蚂蚁店铺创建接口)将加油站注册为支付宝门店。
注意:
新创建门店需设置 ext_infos#MAYIJIAYOU_DISPLAY 为 HIDDEN(隐藏),并与支付宝进行技术联调(详情可查看下文 技术联调)。
创建门店后需为门店添加商品(油品),用户才能在官方 支付宝加油 小程序中查询到对应门店信息。

请求示例#

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AntMerchantExpandShopCreateRequest request = new AntMerchantExpandShopCreateRequest();
//request.putOtherTextParam("app_auth_token", "202125BBaffb2ecd6d9d46ad95ef802232971D33"); // 应用授权令牌,ISV代商家接入时使用
request.setBizContent("{" +
"\"business_address\":{" + // 门店地址
"\"city_code\":\"371000\"," +
"\"district_code\":\"371002\"," +
"\"address\":\"万塘路18号黄龙时代广场B座\"," +
"\"province_code\":\"370000\"," +
"\"poiid\":\"B0FFIVU189\"," +
"\"longitude\":\"120.760001\"," + // 门店高德坐标系经度
"\"latitude\":\"60.270001\"" + // 门店高德坐标系维度
"}," +
"\"shop_category\":\"B0091\"," + // 门店类目,固定为 B0091
"\"store_id\":\"NO0001\"," + // 外部门店id,由油企自定义
"\"shop_type\":\"01\"," + // 门店类型,01表示直营,02表示加盟。加油产品固定为 01
"\"ip_role_id\":\"2088301155943087\"," +
"\"shop_name\":\"常州XXX加油站\"," + // 门店名
"\"cert_image\":\"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg\"," + // 营业执照
"\"legal_name\":\"马云\"," +
"\"legal_cert_no\":\"100100198811110001\"," +
// "\"license_auth_letter_image\":\"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg\"," + // 门店授权函资质照片,如果是连锁店,需要提供总部的授权函
"\"contact_phone\":\"010-62286228\"," +
"\"contact_mobile\":\"13901390139\"," +
"\"cert_no\":\"9133010608210550XR\"," +
"\"out_door_images\":[" + // 门头照
 "\"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg\"," +
 "\"c6c0c722-b9d5-4e5d-b9d4-9eed39f00e68.jpg\"," +
 "\"c6c0c7s2-b9d5-4e5d-b9d4-9eed39f00e70.jpg\"" +
"]," +
"\"qualifications\":[{" + // 特殊资质
 "\"industry_qualification_type\":\"374\"," +
 "\"industry_qualification_image\":\"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg\"" +
"}]," +
"\"cert_type\":\"201\"," + // 营业执照类型,固定为 201(营业执照)
"\"cert_name\":\"常州XXX加油站有限公司\"," +
"\"brand_id\":\"2\"," + // 品牌id,加油产品必填
//"\"scene\":\"\"," + //  可选
"\"ext_infos\":[{" +// 扩展参数,加油产品必填。key值固定如下,value值根据说明传入
    "\"key_name\":\"MAYIJIAYOU_SERVICE\"," + // 表示加油站可以提供的服务,label_key值表示加油站可以提供的服务,value是true或false,true代表有此项服务,false代表无此项服务,label_key1值例如eInvoice代表电子发票;toilet代表卫生间
 "\"value\":\"{\"eInvoice\":true,\"toilet\":false}\"" + 
 "}," +
 "\"key_name\":\"MAYIJIAYOU_JUMPURL\"," + // 加油站小程序的下单支付页面url地址,遵循标准的小程序页面url格式
 "\"value\":\"alipays://platformapi/startapp?appId=小程序appid&page=x/y/z\"" + 
 "}," +
 "{" +
 "\"key_name\":\"MAYIJIAYOU_DISPLAY\"," + // 控制当前门店在蚂蚁加油上的隐藏和展现(用户是否能搜索到),value 取值 DISPLAY/HIDDEN
  "\"value\":\"DISPLAY\"" + 
"}]" +
"}");
AntMerchantExpandShopCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

重要入参说明#

shop_name:必填。门店名称,门店的全名建议规范为:品牌(地市+加油站)。如:中国石油(哈尔滨铁东加油站)。
store_id:必填。外部门店编号,表示该门店在该商家角色 ID(直连 PID,间连 SMID)下,由商家自己定义的外部门店编号。
shop_category:必填。类目 ID,固定为 B0091。
ip_role_id:必填。门店拥有者 PID,即油企的 PID。
business_address:必填。地址信息。省市区编码可查看 地区码.xlsx 表格中内容填写或前往 国家统计局 > 统计用区划和城乡划分代码 进行查询。
province_code:必填。门店所处省份编码。
city_code:必填。门店所处市编码。
district_code:必填。门店所处区/县编码。
address:必填。门店详细地址,即商家详细经营地址。
poiid:必填。高德兴趣点 ID。可通过如下两种方式获取:
直接使用访问高德地图的 URL 地址 进行搜索位置,URL 链接后 ID 的值即为 poiid ,例如:搜索 蚂蚁 C 空间,链接为 https://ditu.amap.com/search?id=B0FFIU3QL4&city=510107&geoobj=104.055382%7C30.538725%7C104.070832%7C30.546159&query_type=IDQ&query=%E8%9A%82%E8%9A%81C%E7%A9%BA%E9%97%B4&zoom=17 其中 ID 值 B0FFIU3QL4 即为 poiid 值。
使用 高德开放平台 提供的 API 通过关键字搜索、周边搜索、多边形搜索等筛选机制获取。
longitude:必填。经度,浮点型,请精确到小数点后 6 位。请以高德坐标系为准,录入时请确保经纬度参数准确,可通过 高德经纬度 进行查询。
latitude:必填。纬度,浮点型,请精确到小数点后 6 位。请以高德坐标系为准,录入时请确保经纬度参数准确,可通过 高德经纬度 进行查询。
shop_type:必填。门店类型。固定为 01(表示直营)。
brand_id:必填。品牌 ID。支持品牌见下:
1:壳牌。
2:中国石油。
3:中国石化。
4:中化集团。
5:中海油。
6:中油碧辟。
7:道达尔。
8:中石化碧辟。
其它不在范围内的品牌请留空。
cert_type:必填。证件类型,固定为 201(表示营业执照)。
cert_no:必填。证件编号,即营业执照的编号。
cert_name:必填。证件名称,即营业执照名称。
cert_image:必填。证件图片,即营业执照图片。
out_door_images:必填。门头照,需传入三张包含加油站名称的清晰门头照。
qualifications:特殊可选,行业特殊资质。若营业执照未包含“销售/批发汽油、煤油、柴油、天然气、成品油”等项目,才需根据自身情况提供。
industry_qualification_type:必填,资质类型,可查看 QualificationType.xlsx 文件。如:374(加油资质)。
industry_qualification_image:必填,资质图片。
license_auth_letter_image:可选,门店授权函。若为连锁店,则需要提供总部的授权函图片资质。
ext_infos:必填。扩展参数,加油场景需传入如下两个 key-value 值,使用示例可查看上文 请求示例:
MAYIJIAYOU_SERVICE:字段格式是 MAYIJIAYOU_SERVICE:{"label_key1":true,"label_key2":false},label_key 值表示加油站可以提供的服务,value 是 true 或 false,true 代表有此项服务,false 代表无此项服务,label_key1 值有:
vatInvoice:增值税发票开具 eInvoice代表电子发票。
toilet:卫生间。
convenienceStore:便利店。
chargingStation:充电桩。
emergencyMaintain:车辆维修。
tireInflator:车胎充气。
waterFilling:车辆加水。
carWash:擦车洗车。
freeCarWash:免费洗车。
carPark:对外停车。
boilingWater:开水饮料。
restaurant:咖啡餐饮。
hotel:住宿休息。
shower:快速淋浴。
laundry:服装清洗。
fuelCard:加油卡。
etcRecharge:ETC 充值。
MAYIJIAYOU_JUMPURL:必填,key 值,表示加油站小程序的下单支付页面 URL 地址,遵循标准的小程序页面 URL 格式:alipays://platformapi/startapp?appId=小程序appid&page=x/y/z (其中 appId 为加油站小程序 APPID;page 为下单支付页路径,如 pages/result/pay)。详情可查看 小程序 scheme 链接介绍。
MAYIJIAYOU_DISPLAY:必填,key 值,门店在 支付宝加油 小程序中隐藏/展现。对应 value 值支持:
DISPLAY:展示。
HIDDEN:隐藏。调试过程中必须传入 HIDDEN,避免测试阶段的门店被线上用户看到产生误解。待调试完成之后,再调用 ant.merchant.expand.shop.modify(蚂蚁门店修改接口) 将 MAYIJIAYOU_DISPLAY 修改为 DISPLAY,然后联系支付宝联调人员将门店移出白名单,线上用户才可看见门店。联调详情可查看下文 技术联调。

响应示例#

{
    "ant_merchant_expand_shop_create_response": {
        "code": "10000",
        "msg": "Success",
        "order_id": "2018012000502000000005130266"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

重要响应说明#

order_id:申请单 ID,可用于后续查询门店审核进度等操作。

后续管理#

获取支付宝门店 id#

门店创建成功后,商家/服务商可通过以下方式获取 支付宝门店 ID(shop_id)。

审核通过消息通知#

示例代码
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"shop_id":"门店id","shop_name":"庆丰包子铺中关村店","order_id":"2018011900502000000005124744","store_id":"NO0001"
}
&msg_method=ant.merchant.expand.shop.save.passed&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2&notify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==
参数说明:
shop_id:支付宝侧商家门店 ID。
store_id:商家自定义门店 ID。
card_alias_no:卡编号,仅直付通场景返回,其它场景无需关注。
更多参数详情可查看 ant.merchant.expand.shop.save.passed(店铺保存审核通过消息接口)文档。

查询#

通过 ant.merchant.expand.shop.page.query(店铺分页查询接口)查询获取。
响应示例
{
    "ant_merchant_expand_shop_page_query_response": {
        "code": "10000",
        "msg": "Success",
        "shop_infos": [
            {
                "shop_id": "2018011900502000000005124744",
                "business_address": {
                    "city_code": "371000",
                    "district_code": "371002",
                    "address": "万塘路18号黄龙时代广场B座",
                    "province_code": "370000",
                    "poiid": "B0FFIVU189",
                    "longitude": "120.760001",
                    "latitude": "60.270001",
                    "type": "BUSINESS_ADDRESS"
                },
                "shop_category": "B0001",
                "store_id": "NO0001",
                "shop_type": "01",
                "shop_name": "肯德基中关村店",
                "contact_phone": "010-62286228",
                "contact_mobile": "13901390139",
                "business_time": [
                    {
                        "week_day": 1,
                        "open_time": "09:30",
                        "close_time": "22:00"
                    }
                ],
                "shop_status": "01"
            }
        ],
        "total_pages": 10
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}
参数说明
shop_id:支付宝侧商家门店 ID。

审核结果#

调用门店创建接口成功后,门店会进入审核流程,审核成功/失败后,支付宝将发送 通知消息 至商家 APPID 对应的 应用网关,若未收到消息通知可通过创建门店接口返回的 order_id 查询申请单 审核进度。
更多门店管理详情可查看 蚂蚁门店管理。

其它重要说明:#

服务商可在 服务商平台 > 商家门店管理 查看及管理已创建并审核通过的商家门店。
门店需添加油品信息才能被检索,请确保线上门店的完整链路测试完毕后再发布油品,正式上线。添加油品详情可查看下文 商品(油品)管理。
ant.merchant.expand.shop.create(蚂蚁店铺创建接口)所需资质等图片信息,必须使用上文 第一步:上传图片资质 返回的 image_id,不支持网络地址的图片。

商品(油品)管理#

接口调用流程#

13.png

创建商品(油品)#

完成加油门店创建并与支付宝进行技术联调(详请可查看下文 技术联调)后,油企/服务商需调用 ant.merchant.expand.item.create(商品创建接口)创建对应油号(如 92#、95#)的商品信息,同时与加油门店进行关联。
创建成功的商品会默认处于 EFFECT(生效中)的状态,用户即可在 支付宝加油 中搜索到的对应加油门店中看到不同油号商品信息。
14.png15.png

请求示例#

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AntMerchantExpandItemCreateRequest request = new AntMerchantExpandItemCreateRequest();
//request.putOtherTextParam("app_auth_token", "202125BBaffb2ecd6d9d46ad95ef802232971D33"); // 应用授权令牌,ISV代商家接入时使用
request.setBizContent("{" +
"\"scene\":\"GAS_CHARGE\"," + // 场景,固定为 GAS_CHARGE
"\"target_type\":\"5\"," + // 商品归属主体类型,固定为 5(表示归属于门店)
"\"target_id\":\"2018090600502000000022501261\"," + // 归属主体id,固定为支付宝侧门店id shop_id
"\"name\":\"98#汽油\"," +
"\"ext_info\":\"{\\\"OIL_GUNS\\\":\\\"[7,8,9,10]\\\",\\\"OUT_ITEM_ID\\\":\\\"123456\\\"}\"," +
"\"sku_list\":[{" + // 价格信息
  "\"price\":590," + // 必填,平台价格,即用户实付的油品单价,单位为 (分/升)
  "\"cost_price\":690" + // 必填,油机挂牌价,单位为 (分/升)
"}]," +
"\"label_list\":[{" + // 商品标签列表
"\"label_key\":\"OIL_NUM\"," + // 必填,固定为 OIL_NUM (油号)
"\"label_value\":\"95#\"" + // 必填,油号
"}]" +
"}");
AntMerchantExpandItemCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

重要入参说明#

scene:必填。场景,支付宝加油产品中固定为 GAS_CHARGE。
target_type:必填。商品归属主体类型,支付宝加油产品中固定为 5(代表门店)。
target_id:必填。商品归主主体 ID,为支付宝侧加油门店 shop_id,非油企/服务商自定义的 store_id。
sku_list:必填。价格信息。
注意:price 必须要小于 cost_price,price 参与油价排序。 price!=cost_price 才会展示油价对比。
price:必填,平台价格,即用户实付的油品单价,单位为 分/升。
cost_price:必填,油机挂牌价,单位为 分/升。
label_list:必填。标签信息。
label_key:必填。固定为 OIL_NUM (表示油号)。
label_value:必填。具体油号值,暂支持:92#、95#、98#、0#、-10#、-35#。
ext_info:必填。扩展信息,需传入如下固定 key-value:
OIL_GUNS:必填,油品支持的油枪列表。
OUT_ITEM_ID:可选,外部商品编号。
front_category_id 参数无需传入,请使用 target_type + target_id 的传参方式。

响应示例#

{
    "ant_merchant_expand_item_create_response": {
        "code": "10000",
        "msg": "Success",
        "item_id": "2018091300502200002600104169"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

重要响应说明#

item_id:商品 ID,可用于后续支付接口创建订单时传入商品信息。

后续管理#

创建商品后,油企/服务商还可通过如下接口对商品进行修改、查询、删除等操作。

查询商品#

油企/服务商可调用 ant.merchant.expand.item.query(商品查询接口)查询门店下属的所有商品信息。

修改商品信息#

油企/服务商可调用 ant.merchant.expand.item.modify(商品修改接口)修改创建的商品信息及状态。
说明:
本接口调用处理成功后,状态修改需 T + 1 生效。
本接口罗列商品信息相关入参都可进行修改。
本接口 label_list 中商品信息若传入 null 表示不修改标签信息。若传入 [] 空 list 则清空标签。示例代码:
{"label_list":null} 

{"label_list":"[]"}

修改商品状态#

油企/服务商可调用 ant.merchant.expand.item.status.modify(商品状态修改接口)修改商品生效状态,用以下架/商家门店中的油品。
说明:
本接口仅支持修改商品状态,与 ant.merchant.expand.item.modify(商品修改接口)修改商品状态功能相同。
将 EFFECT 状态商品修改为 INVALID,对应商品将自动从商家门店中隐藏下架,反之商品会自动在商家门店中上架展示。

删除商品#

油企/服务商可调用 ant.merchant.expand.item.delete(商品删除接口)删除商品。
说明:不支持直接删除 EFFECT 状态商品,请将商品状态修改为 INVALID 后删除。

接入支付#

油企小程序支付页需接入 小程序支付 用于完成收费操作。
**注意:**支付宝加油产品对 alipay.trade.create(统一收单交易创建接口)需扩展 business_param、promo_params 参数。

请求示例#

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayTradeCreateRequest request = new AlipayTradeCreateRequest();
//request.putOtherTextParam("app_auth_token", "202125BBaffb2ecd6d9d46ad95ef802232971D33"); // 应用授权令牌,ISV代商家接入时使用
request.setBizContent("{" +
"\"out_trade_no\":\"20150320010101001\"," +
"\"total_amount\":9.60," +
"\"subject\":\"中国石油(XXXX第五加油站)\"," +
"\"buyer_id\":\"2088102146225135\"," +
"\"goods_detail\": [" +
     "{" +
        "\"goods_id\": \"apple-01\","+  //goods_id填商品创建时返回的item_id
      "}" +
    "]," +
//"\"extend_params\":{" +
//"\"sys_service_provider_id\":\"2088511833207846\"" + // 返佣PID,ISV获取返佣时传入
//"}," +
"\"business_params\":{" + // 业务参数,支付宝加油产品必填。如下 key值固定 value根据说明填写
    "\"jiayouSource\":\"mayijiayou\"," + // 加油用户来源
    "\"consumeOutScene\":\"jiayou\"" +  // value固定为 jiayou 
"}," +
"\"promo_params\":{" + // 推广参数,支付宝加油产品必填。如下 key-value 值固定,表示该订单为支付宝加油订单。
    "\"jiayouPromoRule\":\"mayijiayou\"" + 
"}" +
"}");
AlipayTradeCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

重要入参说明#

total_amount:必填。用户订单总金额,单位为人民币(元),取值范围为 0.01~100000000.00,精确到小数点后两位。
buyer_id:必填。买家 user_id,可通过 用户授权 获取。
subject:必填。订单标题。
alipay_store_id:支付宝侧门店 id,创建支付宝门店成功后返回的 shop_id。
store_id:外部油站 id。
goods_id:支付宝商品创建时返回的 item_id。
business_params:必填。业务参数,用于标识加油支付业务。key 值固定,对应 value 值根据说明传入:
jiayouSource:必填。加油用户来源,入参支持:
mayijiayou:通过 支付宝加油 官方小程序跳转至服务商开发的下单小程序完成支付。
isvxiaochengxu:用户通过线下扫码、支付宝搜索、生活号链接等渠道直接进入服务商开发的下单小程序完成支付。
fangbaopos:加油员通过防爆 POS 扫描用户付款码完成支付。
xiaochaoshipos:用户在后厅小超市,收银员扫描用户付款码完成支付。
youkachongzhi:用户在线上或线下充值加油卡完成支付。
youquanshoumai:用户在线上购买加油优惠券完成支付。
consumeOutScene:必填。支付场景,入参固定为 jiayou。
promo_params:必填,推广参数,key-value 值固定为:{"jiayouPromoRule":"mayijiayou"} 表示该订单为支付宝加油订单。

交易辅助接口#

交易查询#

商家可调用 alipay.trade.query(统一收单线下交易查询接口),通过商家唯一订单号 out_trade_no 或支付宝交易号 trade_no 查询对应订单支付情况。

交易退款#

当交易发生之后一段时间内,由于买家或者商家的原因需要退款时,商家可以调用 alipay.trade.refund(统一收单交易退款接口)通过商家唯一订单号 out_trade_no 或支付宝交易号 trade_no,将对应订单支付款退还给买家,支付宝将在收到退款请求并且验证成功之后,按照退款规则将支付款按原路退到买家账号上。
说明:
交易超过约定时间(签约时设置的可退款时间)的订单无法进行退款。
一笔退款失败后重新提交,要采用原来的退款单号。
refund_amount(需要退款的金额),该金额不能大于订单金额,单位为元,支持两位小数。
同一笔订单如需分多次退款,需传入 out_request_no 标识一次退款请求,同一笔交易多次退款需保证该值唯一(即分次退款需保证 trade_no 不变,每次退款请求都需传入不同 out_request_no)。

交易撤销#

支付交易返回失败或支付系统超时,商家可调用 alipay.trade.cancel(统一收单交易撤销接口)通过商家唯一订单号 out_trade_no 或支付宝交易号 trade_no 撤销交易。
说明:
如果此订单用户支付失败,支付宝将关闭此订单。
如果此订单用户支付成功,支付宝将退还订单资金给用户。
仅发生支付系统超时或者支付结果未知时可调用本接口撤销交易,其它正常支付的单如需实现相同功能请调用 alipay.trade.refund(统一收单交易退款接口)。

交易关闭#

当交易创建后,用户如果在一定时间内未进行支付,商家可调用 alipay.trade.close(统一收单交易关闭接口)通过商家唯一订单号 out_trade_no 或支付宝交易号 trade_no 关闭,将对应未付款的交易进行关闭。

交易对账#

油企/服务商可通过接口或使用商家主账号登录 商家平台 进行对账单下载等操作。

接口下载账单#

油企/服务商可通过 alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址)接口查询商家日/月交易业务/账务账单下载地址。
**注意:**账单下载地址有效期为 30 秒,获取后请尽快下载。

商家平台对账#

油企商家还可使用主账号登录 商家平台 > 对账中心 > 账单下载 页进行下载、对账等操作。

用户支付完成后放行#

油企/服务商根据实际情况制定相应应放行方案。推荐如下放行方案:
通过喇叭语音播报的方式放行(需要与语音播报系统打通)。
通过油机/小票机打印小票的方式放行(需要与小票机打通)。
除了以上的放行方案,建议在支付成功后创建一个兜底方案,以便发生异常情况时能够对用户放行:
16.png
用户支付后油企小程序如需跳转至官方 支付宝加油 小程序,可跳转至如下地址:alipays://platformapi/startapp?appId=2019041063881050。

技术联调#

油企/服务商完成开发后,正式上线前需 发送邮件 申请技术联调,防止测试阶段的门店被线上用户看到造成客诉。

联调流程图#

yuque_diagram.jpg
1.
油企/服务商完成小程序及创建门店开发;
2.
发送邮件获取技术支持、申请与支付宝进行技术联调;
3.
先通过支付宝店铺接口创建门店,创建门店成功后,通知支付宝联调人员添加测试白名单(需提供商家 PID、门店 ID、需要加白名单的用户的 UID 列表),防止测试阶段的门店被线上用户看到;
4.
添加测试白名单成功后,通过支付宝商品接口发布油品油价。成功后,白名单人员即可在官方 支付宝加油 小程序中看到这个油站及其商品(油品)信息;
5.
进行系统联调,自测验证线上使用流程,如:验证从官方 支付宝加油 小程序跳转至商家下单小程序,下单支付等功能。

上线验收#

功能正式上线前,油企/服务商需完成 支付传参 及 业务流程 两项验收。

支付传参验收#

油企小程序支付页需接入小程序支付 用于完成收费操作。支付宝加油产品对 alipay.trade.create(统一收单交易创建) 接口的入参有如下要求:
total_amount:必填。用户订单总金额,单位为人民币(元),取值范围为 0.01~100000000.00,精确到小数点后两位。
buyer_id:必填。买家 user_id,可通过 用户授权 获取。
subject:必填。订单标题。
alipay_store_id:支付宝门店创建时返回的 shop_id
store_id:外部油站 id
goods_id:支付宝商品创建时返回的 item_id
business_params:必填。业务参数,用于标识加油支付业务。key 值固定,对应 value 值根据说明传入:
jiayouSource:必填。加油用户来源,入参支持:
mayijiayou:通过 支付宝加油 官方小程序跳转至服务商开发的下单小程序完成支付。
isvxiaochengxu:用户通过线下扫码、支付宝搜索、生活号链接等渠道直接进入服务商开发的下单小程序完成支付。
fangbaopos:加油员通过防爆 POS 扫描用户付款码完成支付。
xiaochaoshipos:用户在后厅小超市,收银员扫描用户付款码完成支付。
youkachongzhi:用户在线上或线下充值加油卡完成支付。
youquanshoumai:用户在线上购买加油优惠券完成支付。
consumeOutScene:必填。支付场景,入参固定为 jiayou。
promo_params:必填,推广参数支付宝加油产品必填。如下 key-value 值固定为 {"jiayouPromoRule":"mayijiayou"} 表示该订单为支付宝加油订单。
云验收上线之前,请支付宝联调人员截图服务商传参日志,作为传参验收通过凭证,云验收完成后,通过云验收作为传参验收通过凭证。

业务流程验收#

油企/服务商需录制由 支付宝加油 小程序跳转至加油站小程序,选择油枪和油号进行支付的全流程视频,提供给支付宝联调人员进行验收。

附录一:油企小程序跳转至"支付宝加油"#

用户支付后油企小程序如需跳转至支付宝加油小程序,可跳转至如下地址:
alipays://platformapi/startapp?appId=2019041063881050。

附录二:油站未在支付宝加油展示问题自助排查#

检查油站归属支付宝账号(门店创建接口中的 ip_role_id)是否已经开通“支付宝加油”。
检查油站隐藏显示参数(门店创建接口中的 ext_infos 中的 MAYIJIAYOU_DISPLAY)。
油站是否添加过测试白名单。
检查油站经纬度地址是否正确。
检查油站下面是否已经添加了油品。
检查油站是否已经审核通过。
上一页
接入准备
下一页
店铺保存拒绝消息
Built with