1. 基础支付
星驿支付文档中心
  • 文档说明
    • 阅读对象
    • 版本说明
  • 术语
    • 支付模式
    • 名词解释
    • 支付产品
      • 付款码支付
      • 聚合码支付
      • PC支付
      • 小程序支付
        • 微信小程序支付
        • 支付宝小程序支付
      • APP支付
        • 微信支付
        • 支付宝支付
      • H5支付
        • 微信H5支付
        • 支付宝H5支付
        • 云闪付H5支付
        • 手机浏览器H5支付
      • Native支付
        • 支付宝支付
        • 云闪付支付
      • 终端支付
        • 智能云MIS
        • 智能APP
  • 接口规则
    • 协议规则
    • 安全规范
  • 支付交易
    • 交易前指引
      • 微信认证操作流程
      • 支付宝认证操作流程
      • H5页面微信支付对接前准备
      • H5页面支付宝支付对接前准备
      • 支付流程
      • 支付接入注意事项
      • 消费者IP获取指引
    • 基础支付
      • 付款码支付
        POST
      • JSAPI支付
        POST
      • 订单查询
        POST
      • 扫码支付-星驿码
        POST
      • 扫码支付-官方码
        POST
      • 扫码支付-场景码
        POST
      • 关闭订单
        POST
      • 撤销订单
        POST
      • 退款
        POST
      • 退款查询
        POST
      • 授权码查询openid
        POST
      • 获取银联用户标识
        POST
      • 获取微信刷脸凭证
        POST
      • 成品油(现金/储值)开票
        POST
    • 小程序支付
      • 使用说明
      • 小程序半屏-星驿付
      • 小程序半屏-场景
    • 扫码预授权
      • 扫码预授权
      • 预授权查询
      • 预授权撤销
      • 预授权撤销查询
      • 预授权完成
      • 预授权完成查询
      • 预授权完成撤销
      • 预授权完成撤销查询
    • 订单推送
      • 推送终端交易
      • 关闭推送终端交易
      • 碰一下推单状态查询
      • 碰一下订单取消
      • 碰一下订单推送
    • 智能终端SDK
      • 智能终端SDK
    • 交易通知及对账
      • 交易对账文件-场景应用
      • 交易对账文件-ISV
      • 交易和退款结果通知
      • 交易手续费通知
    • 刷卡预授权
      • 预授权撤销
      • 预授权完成撤销
  • 商户管理
    • 前件前指引
      • 进件说明
      • 图片示例
      • 微信认证操作流程
      • 支付宝认证操作流程
      • 附件下载
    • 商户入网
      • 商户进件上传图片
      • 普通商户进件
      • 普通商户信息修改
      • 小微商户进件
      • 小微商户信息修改
      • 审核结果查询
      • 商户审核结果通知
      • 待审核商户撤回
      • 商户信息查询
      • 结算卡修改
      • 商户快捷修改
      • 受益人信息查询
      • 商户报备查询
      • 商户报备结果通知
      • 商户状态修改
      • 终端报备查询
      • 商户阶梯费率配置
      • 商户阶梯费率查询
    • 商户协议签约
      • 入网协议签约接口调用流程
      • 普通商户用户开户
      • 小微商户用户开户
      • 发短信验证码
      • 获取签约链接
      • 校验验证码
      • 校验验证码-补签
      • 签约结果通知
    • 微信支付宝认证
      • 微信申请单提交
      • 微信申请单撤销
      • 微信申请单状态查询
      • 微信商户授权状态查询
      • 支付宝申请单提交
      • 支付宝申请单撤销
      • 支付宝申请单状态查询
      • 支付宝商户授权状态查询
    • 微信开发配置
      • 微信APPID配置
      • 微信支付目录配置
      • 微信公众号查询
      • 微信开发配置查询
      • 指定渠道报备
      • 微信小程序冻结状态查询
      • 微信小程序冻结通知(非接口)
    • 商户限额调整
      • 商户限额查询
      • 商户提额申请
      • 商户提额记录查询
    • 商户风险处置
      • 商户风险处置通知
      • 风险商户图片上传
      • 微信官方风险商户文件
      • 支付宝官方风险商户文件
      • 风险商户异常流水查询
      • 风险商户调查列表
      • 风险商户调查详情
      • 风险调查单历史查询
      • 风险调查材料下载
      • 风险调查单处理
    • 商户手续费开票
      • 开具发票
      • 开票详情
      • 待开发票信息查询
      • 合并开票商户信息查询
      • 电子普票重发邮箱
      • 开票历史查询
    • 无界收款
      • 无界收款图片上传
      • 无界收款开通
      • 无界收款审核查询
      • 无界收款审核结果通知
  • 资金结算
    • D0结算业务
      • 产品介绍
      • 获取人脸识别链接
      • 人脸认证结果查询
      • D0开通
      • D0信息修改
      • D0状态查询
      • D0开通失败申诉
      • D0申诉结果查询
      • D0申诉结果通知
    • 特殊结算业务
      • 产品介绍
      • 结算业务申请
      • 结算业务变更
      • 结算业务结果查询
      • 结算业务结果通知
    • 提现查账
      • 手工提现
      • 到账记录查询
      • 到账记录批量查询
      • 秒到提现记录查询
      • 账户余额查询
      • 挂账记录查询
      • 补付申请
      • 提现结果通知
      • 账户余额变动通知
      • 提现对账文件
      • 批量结算提现通知
      • 到账附言配置
      • 查询到账附言
  • 星账云管家
    • 星账云管家
    • 功能开通
      • 功能开通(XZY001)
      • 编辑(XZY003)
      • 编辑上传付款凭证(XZY002)
      • 修改生效状态(XZY004)
      • 查询详情信息(XZY005)
      • 产品开通审核通知(XZY006)
    • 公共接口
      • 上传文件(XZY013)
    • 分账
      • 交易
        • 分账结算电子回单下载(XZY037)
        • 余额查询接口(XZY041)
        • 分账合并入账电子回单下载(XZY039)
        • 订单查询(XZY015)
        • 分账(XZY014)
        • 分账撤销退回(XZY017)
        • 分账结果回调(XZY016)
      • 客户管理
        • 新增客户(XZY018)
        • 分账授权申请接口-收单统一结算(XZY043)
        • 批量分账授权申请接口-收单统一结算(XZY044)
        • 合作状态调整(XZY020)
        • 解约/重启签约(XZY-001-002)
        • 编辑客户(XZY023)
        • 替换客户结算卡(XZY022)
        • 审核通知(XZY019)
        • 查询分账客户信息(XZY021)
    • 归集
      • 开户/授权
        • 归集授权申请接口-收单统一结算(XZY037)
        • 审核通知(XZY025)
        • 合作状态调整(XZY026)
        • 查询归集客户信息(XZY027)
        • 替换结算卡(XZY028)
        • 编辑信息(XZY029)
      • 交易
        • 归集合并入账电子回单下载(XZY040)
        • 归集结算电子回单下载(XZY038)
        • 余额查询接口(XZY042)
        • 订单查询(XZY031)
        • 归集-支持自定义服务费(XZY030)
        • 归集(XZY030)
        • 归集结果回调(XZY032)
        • 归集撤销退回(XZY033)
    • 提现
      • 提现订单查询(XZY035)
      • 结算回调通知(XZY050)
      • 提现电子回单下载(XZY040)
      • 提现(XZY036)
    • 账户
      • 结算资金流水查询(XZY047)
      • 结算卡资金流水查询(XZY049)
  • 设备管理与推送
    • 设备管理
      • 收款设备绑定
      • 收款设备解绑
      • 收款设备绑定查询
      • 设备绑定/解绑结果通知
      • 音箱绑定
      • 音箱绑定查询
      • 音箱解绑
    • 设备推送
      • 音箱播报
      • 交易打印
  • 营销活动
    • 银行活动
      • 产品介绍
      • 图片上传
      • 商户补贴列表查询
      • 银行活动报名
      • 银行活动报名结果查询
      • 银行活动报名结果通知
      • 银行活动列表查询
      • 银行活动退出
    • 特殊行业活动
      • 产品介绍
      • 特殊行业活动报名申请
      • 特殊活动报名结果通知
      • 特殊行业商户活动查询
      • 特殊行业活动图片上传
    • 综合账户
      • 营销增资-订单
      • 营销增资-金额
      • 营销增资查询
      • 综合账户余额查询
      • 综合账户流水查询
    • 增值服务
      • 获取增值营销产品列表
      • 获取增值营销产品明细
      • 获取分享链接
      • 推广结果列表查询
      • 推广结果详情
  • 慧徕店开放平台
    • 慧+SPI
      • 对接前准备
      • 商户同步
        • 开发配置
          • 请求域名
          • 加签&验签
        • 商户同步
        • 商户同步查询
        • 商户同步回调
      • 应用模块
        • 产品介绍
        • 开发配置
          • 请求域名
          • 加签&验签
        • 应用及增值服务查询
        • 商户应用注册及增值服务状态查询
        • 应用注册
        • 应用注册状态查询
        • 应用注册回调通知
        • 增值服务激活
        • 增值服务激活状态查询
        • 增值服务激活回调通知
      • 聚合支付SPI
        • 产品介绍
        • 开发配置
          • 签名方式
          • 验签方式
          • 公共参数
        • 支付API
        • 付款码支付
        • 扫码支付-官方码
        • JSAPI支付
        • 扫码支付-聚合码
        • 获取小程序支付信息
        • 订单查询
        • 交易结果通知
        • 退款
        • 退款查询
        • 关闭订单
        • 获取银联用户标识
    • 应用开发API
      • 验签说明
      • 应用支付
      • 门店信息同步
      • 门店增值服务激活
  • 支付广告
    • 微信小程序广告
    • 支付宝小程序广告
    • 支付宝H5广告
    • SDK资源文件
  • 数据字典
    • MCC
      • 搜索查询二级mcc
      • 获取一级mcc目录
      • 获取二级mcc目录
    • 地区码
      • 获取省
      • 获取市
      • 获取区县
    • 落地银行
      • 落地银行查询
      • 落地银行下级机构查询
    • 银行信息
      • 获取银行省信息-联行号
      • 获取银行市信息-联行号
      • 银行信息查询
      • 查询联行号信息
      • 根据银行卡号获取银行信息
    • 连锁品牌
      • 获取连锁品牌信息
  • 分账服务
    • 订单分账
      • 订单分账
      • 订单分账结果查询
      • 订单分账撤销
      • 订单分账对帐文件
    • 余额分账
      • 余额分账
      • 余额分账结果查询
      • 可分账余额查询
    • 分账配置
      • 分账图片上传
      • 分账商户配置
      • 分账商户配置结果查询
      • 分账商户配置结果通知
      • 分账商户移除
      • 快捷创建资金接收方
      • 修改分账比例与金额
      • 商圈信息查询
  • 数据模型
    • FileHeader
    • FileBody
    • StandardResponse
  1. 基础支付

获取银联用户标识

测试环境
https://xyf-server-test.postar.cn
测试环境
https://xyf-server-test.postar.cn
POST
/yyfsevr/order/getPaypalTag
使用场景:商户、ISV、应用开发者

获取用户信息:
用户信息获取包含两个接口。
第一步,收款方通过“获取用户授权”接口请求付款方APP获取临时授权URL;
第二步,收款方通过HTTP GET方式访问临时授权URL,付款方直接在HTTP应答中返回用户标识。具体过程如下:

1.png

获取用户授权接口(第一步):
付款方APP访问收单机构H5页面,收单判断当前是否有该 APP 的用户信息 。如没有,则返回 302 重定向地址,具体格式如下: “https://qr.95516.com/qrcGtwWeb-web/api/userAuth?version=1.0.0&redirectUrl=收单机构接收处理结果的地址” (具体格式可参考《中国银联二维码交易处理系统技术指南V2.5》中“获取用户授权”接口部分),其中请求的redirectUrl值需进行URLEncode。付款方APP将处理用户信息获取请求,完成后直接访问请求中的redirectUrl,并在redirectUrl后面添加userAuthCode和respCode两个参数,respCode=00标识成功,userAuthCode为后台获取APP用户信息的临时授权码。

获取用户授权接口有以下三种返回情况:
1)获取用户信息成功(respCode == 00),收单在订单推送接口必须上送userId;
2)获取用户信息失败(respCode != 00&& respCode != 34),收单机构需告知用户终止交易;3)付款方不支持获取用户信息(respCode == 34),收单在订单推送接口可以不送userId,也不用再执行第二步“获取用户标识”。

获取用户授权接口(第二步):
收款方获取授权码userAuthCode、银联支付标识appUpIdentifier后通过后台接口请求银联获取用户标识。其中,授权码只能请求一次,一般访问有效时间为5分钟(注:付款方可能会根据情况缩短或延长链接有效时间);银联支付标识需要收款方通过HTTP中的User Agent截取,银联支付标识的格式为“UnionPay/<版本号><App标识>”(不含双引号),其中<版本号>固定为1.0,<App标识>为付款方自行定义的内容(仅包含字母或数字)。具体报文可参考《中国银联二维码交易处理系统技术指南V2.5》中“获取用户标识”接口部分。银联将通过付款方后台将处理用户信息获取请求,完成后返回应答,应答内容包括userId和respCode两个参数,respCode=00标识成功,userId为用户标识。

获取用户标识接口有以下二种返回情况:
1)获取用户信息成功(respCode == 00),收单在订单推送接口必须上送userId;
2)获取用户信息失败(respCode != 00),收单机构需告知用户终止交易。

订单推送接口:
用户在收款方 H5 页面上点击“确认”后,收款方识别 HTTP 请求 User Agent 中包含银联支付标识“UnionPay/<版本号> <App 标识>”或者包含 Safari 浏览器标识时,通过“订单推送”接口向银联推送消费类订单。银联将向收款方返回重定向地址(redirectUrl),收款方向浏览器返回 HTTP 应答码 301,且重定向地址指向银联返回的redirectUrl。

注:收款方向银联发起“订单推送”请求报文中的 customerIp 字段需要填写用户 APP侧的真实 IP 地址,银联将对此进行安全控制;userId 字段通过用户信息获取接口获取,非APP 返回用户信息获取接口不支持(respCode=34 表示不支持)情况下该值必送;frontUrl字段填写扣款成功之后、收款方接收银联“前台收款通知”的地址(HTTP POST 方式);
frontFailUrl 字段填写扣款失败之后、收款方接收交易结果的地址(HTTP GET 方式);backUrl字段填写扣款成功之后、收款方接收银联“收款通知”的地址。

前台收款通知接口:
付款方扣款成功后,银联通过 App 的 WebView 向收款方发送“前台收款通知”,具体采用 HTTP POST方式,POST 数据内容根据接口定义采用 Key/Value 格式,URL 地址为收款方订单推送时指定的 frontUrl 字段。同时,银联会通过后台发送“收款通知”交易报文,这两种通知在功能上是等效的,收款方按照先到先处理的原则,对于后到的通知交易,收款方应直接返回成功,收款方也需具备重复接收银联通知的能力。 收款方应同时具备后台接入的能力,流程同收款方自发码的处理流程。收款方需要在“查询订单”应答报文中返回收款方机构代码(详见 4.1.4.3 章节)。

相关附件下载:

关于规范银联JS支付银联支付标识获取方式的通知.pdf
中国银联二维码交易处理系统改造指南-JS支付(收款方).pdf

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

请求示例请求示例
Java
Shell
C#
PHP
响应示例响应示例
{
    "code": "string",
    "msg": "string",
    "data": {
        "userId": "string",
        "atqTag": "string"
    }
}
修改于 2025-11-07 07:09:53
上一页
授权码查询openid
下一页
获取微信刷脸凭证
Built with