1. 开户/授权
星驿支付文档中心
  • 文档说明
    • 阅读对象
    • 版本说明
  • 术语
    • 支付模式
    • 名词解释
    • 支付产品
      • 付款码支付
      • 聚合码支付
      • PC支付
      • 小程序支付
        • 微信小程序支付
        • 支付宝小程序支付
      • APP支付
        • 微信支付
        • 支付宝支付
      • H5支付
        • 微信H5支付
        • 支付宝H5支付
        • 云闪付H5支付
        • 手机浏览器H5支付
      • Native支付
        • 支付宝支付
        • 云闪付支付
      • 终端支付
        • 智能云MIS
        • 智能APP
  • 接口规则
    • 协议规则
    • 安全规范
  • 支付交易
    • 交易前指引
      • 微信认证操作流程
      • 支付宝认证操作流程
      • H5页面微信支付对接前准备
      • H5页面支付宝支付对接前准备
      • 支付流程
      • 支付接入注意事项
      • 消费者IP获取指引
    • 基础支付
      • 付款码支付
      • JSAPI支付
      • 订单查询
      • 扫码支付-星驿码
      • 扫码支付-官方码
      • 扫码支付-场景码
      • 关闭订单
      • 撤销订单
      • 退款
      • 退款查询
      • 授权码查询openid
      • 获取银联用户标识
      • 获取微信刷脸凭证
      • 成品油(现金/储值)开票
    • 小程序支付
      • 使用说明
      • 小程序半屏-星驿付
      • 小程序半屏-场景
    • 扫码预授权
      • 扫码预授权
      • 预授权查询
      • 预授权撤销
      • 预授权撤销查询
      • 预授权完成
      • 预授权完成查询
      • 预授权完成撤销
      • 预授权完成撤销查询
    • 订单推送
      • 推送终端交易
      • 关闭推送终端交易
      • 碰一下推单状态查询
      • 碰一下订单取消
      • 碰一下订单推送
    • 智能终端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)
          POST
        • 审核通知(XZY025)
          POST
        • 合作状态调整(XZY026)
          POST
        • 查询归集客户信息(XZY027)
          POST
        • 替换结算卡(XZY028)
          POST
        • 编辑信息(XZY029)
          POST
      • 交易
        • 归集合并入账电子回单下载(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. 开户/授权

审核通知(XZY025)

测试环境
https://xyf-server-test.postar.cn
测试环境
https://xyf-server-test.postar.cn
POST
/客户审核通知
1.处理成功code需返回{"code": "000000","msg": "成功","data":""}
2.mainCustomerId是星管家分账产品管理员,开通分账功能返回
3.对接异步通知需提前提供异步通知地址用于通知配置,网络开通
4.返回报文处理如下

异步返回结果验签#

假设接收到通知的示例如下:
注意:以下示例报文仅供参考,实际返回的详细报文请以实际返回为准。
{"agetId":"61000000103774","pdata":"O619w1fPFR76cKt1QVastYzxm7qdxaS2JnlhZG0WFLFXV3atb1WT8uuCwRgqRhM5sUPGE8DyKgHI+rhfDfIKoGdMNx97oftvdRM11QTlDnldD9T9y//k6OPKWNvCZx6x/tOYYwta550aqsqC8hYRAZdPhZymuF7ydi2Xu0VHOMbkpYBAaz4l0vZvUGxzJoImwDiPB8jZP8Ri7bltVGfkwGlGOSjcwJMqYlG4c7U49jgoDtgs051z54yRDjpCEWmu5YkavkQhqHaj5yg2zltPrbhztY/X5WZ1EGZgt1EtP7hZ9D7DSpdyTjWa9yZeQNY0zn7i9aAM7hA8yhITXEcpFWz8sb7ZY9zBVkmXOfqRl+mek7DJ4CwRNjolraY4kRq9tIVJYlA/2SfkNZEABa+vhwMzy3CChoQNdLgf8T2rq/Rv03x8HW39G9YYzkONZnmofXylLy5sWqFnGlSQu3y7sORcIkBjvPL2CQfoPNWKZ7MPY9vXzlXCNuxNzTYzeJ0uK4sITT0PZ9yKWfFFfJWY//kojPnhXkEI2f28T9V5FPKVfrv5637yG4MiqA0Mqn1eKBMQ5b8guqNUQcAwdqbtikPLXzWDCPXPG2oXaWE0Q9slJgDCOFIU4Nx/E3ee1mEpo6ywyyEQLIi0SWouM4MrIek6gGGtIg5f7R2M6Brk1zRpN12V4FybRPFr2O6uE23GlWUYkj/8bGrPaEIMFLn6PeK80T6WMtRiN3coC4Z6yInK3cBQAPKpZe51FyYEGdyEjQ42fwmNlKW1AV95Lz/0PQLLEVUP14AQs68XgB4jQI0mCBbFgbYoRZkmuG537KmZEy48r2E0nWImI/VLym2JEbAKf/GCmrDcVcFqPCQqP++6CFFDEKI1yepVZizFjUMQvK6vYAgQuRNeMI+dHiioIZZFJXdj7AJOhNYRnNInFZlRVcuvFr7O8Lp/TZwXe7HuFjnanYXPvdETsvtn3sXzuc/qClyp9TWbd4fE8/g5aHa9aqOAIzKst7ueRPZw3kxpjYJ9z/MiEDE3+O+UC5zqIZ/Zv8KpPwWmAjB0B3AY3jq3Aikspc2ypA3XISYfLrQ7pnNTIC+9hIrp0mOQE+qrzo0fk47n+l5HxbC2LIfm4N9tVjc+ZNSWmT4j2DNUTq1MLq7S4FRgG5HnlpUfyUl3meG/0XxkFVg/E7BISaCClgW9kNy1FKmZWGa8+Ygi0I4PpX3xaUOFkaxyHGorSmQm/0PtSD+dGo5vp1ER7ZROL/EjVNNijuFD7UkE/XmD/vNdc5aLgZQvFws93BKfzo+A5KbrK1oW/4cCYBQV2HjhTqD0ycjow7UDs1Nh44CpA6o06rakfl5tBXvCjxhQdVtfvVsEsJ9UthSHNx5et7vbxd1NWZhtdWRRP6aTQeUCCCRqFburI53t/xNNea0F3BJ1L5UZ5u94eEl8f+wLdV21np52pDDOd5XOCtBwVFzuveumQfn3mlleB4hxTKSt/JLH1rQgLXS83JYnpjkxtmJLAQ7cWzYoPDWSzf7bdC0KODC2usokUR9RNVL5yMm6uBv12+8xduuC8zBrgEjsBTEeM1ulLz1k5/oo0Kvv/ITNdaHiD+XcEo+PMElQKPTgH/Inth7DZOa5N3hR/jXYTMQQIwGfJ11uKZ/TBCKSNApZGNl87PKqTThN+aEjM4yc4SFx2hPQLAkD5PG4qqyGGWRykcw="}
第一步:将加密参数(pdata)使用 RSA 公钥解密成明文:
{"auditRemark":null,"auditStatus":"1","authId":"8496379813794816000","custId":"2
0000000001203","customerId":"20000000001203","isManage":"0","mainCustId":"60000001057073","operationType":"0","sign":"d9FmeZoeoRblzvbqYywCQWBmuXR5x5B1oTS/csZx0L3OWBZK7NYccFSo3GXIGjr9I
NU5V8ZdSfTf157P4SWk81AJyieJ9WRAYuhMkcLBweofyPqv1coox4lHF/1wYNwun8fBo7jxjs/fCOEaGFRfm0BIO1nDduID8ciaPB1QUYDYpajeZanql7y/epBKucMW5Hy/C5v6gtNVUEz/rk2yuTkSUkk5ttjDC6ZYeDSBWRQ4SjTm4Wkb53G/
VegJzm0Z6hqS8YNNHMstzd94eC8/5acA4iMs4gTXAvHdulEiiz7KZYQzmfAjToVquh+Bf/23U6szDkcNV0jpBI0RK6S4MA==","signId":"8496379815405428736"}
第二步:在明文参数列表中,除去 sign 参数外,其他参数均为待验签的参数。
第三步:将剩下明文参数进行字典排序,组成字符串,得到拼接串:
auditRemark=null&auditStatus=1&authId=8496485944751955968&custId=20000000001206&customerId=20000000001206&isManage=0&mainCustId=60000001057073&operationType=0&signId=8496485947201429504
第四步:将拼接串使用 SHA256 编码,生成字符串1:
00afe4449dd26aa727bd7354e848219aeda2c48caee7dfe96b30ff8498040437
第五步:将明文中签名参数(sign)使用 RSA 公钥解密为字符串2。
第六步:将字符串1和字符串2进行比较,相同即为验签通过,反之验签失败。
第7步:处理成功返回{"code": "000000","msg": "成功","data":""}。

异步通知验签Demo-java#

公钥解签demo
展开查看完整demo
import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.TypeReference;
import lombok.extern.log4j.Log4j2;
import org.apache.commons.lang3.ArrayUtils;
import sun.misc.BASE64Decoder;

import javax.crypto.BadPaddingException;
import javax.crypto.Cipher;
import javax.crypto.IllegalBlockSizeException;
import javax.crypto.NoSuchPaddingException;
import java.security.InvalidKeyException;
import java.security.KeyFactory;
import java.security.NoSuchAlgorithmException;
import java.security.PublicKey;
import java.security.spec.X509EncodedKeySpec;
import java.util.TreeMap;


/**
 * 公钥解签
 */
@Log4j2
public class RUtil {
    /**
     * 公钥解密过程
     *
     * @param key  公钥
     * @param data 密文数据
     * @return 明文
     * @throws Exception 解密过程中的异常信息
     */
    public static String decrypt(String key, String data) throws Exception {
        if (key == null) {
            throw new Exception("解密公钥为空, 请设置");
        }
        PublicKey publicKey = getPublicKey(key);
        byte[] cipherData = Base64Util.decode(data);
        Cipher cipher = null;
        try {
            // 使用默认RSA
            cipher = Cipher.getInstance("RSA");
            cipher.init(Cipher.DECRYPT_MODE, publicKey);

            byte[] buf = (byte[]) null;
            for (int i = 0; i < cipherData.length; i += 256) {
                byte[] doFinal = cipher.doFinal(ArrayUtils.subarray(cipherData, i, i + 256));
                if(buf == null) {
                    buf = doFinal;
                } else {
                    buf = addBytes(buf,doFinal);
                }
            }
            return new String(buf);
        } catch (NoSuchAlgorithmException e) {
            throw new Exception("无此解密算法");
        } catch (NoSuchPaddingException e) {
            e.printStackTrace();
            return null;
        } catch (InvalidKeyException e) {
            throw new Exception("解密公钥非法,请检查");
        } catch (IllegalBlockSizeException e) {
            throw new Exception("密文长度非法");
        } catch (BadPaddingException e) {
            throw new Exception("密文数据已损坏");
        }
    }

    /**
     * 数组拼接
     * @param data1 数组1
     * @param data2 数组2
     * @return
     */
    public static byte[] addBytes(byte[] data1, byte[] data2) {
        byte[] data3 = new byte[data1.length + data2.length];
        System.arraycopy(data1, 0, data3, 0, data1.length);
        System.arraycopy(data2, 0, data3, data1.length, data2.length);
        return data3;
    }

    /**
     *  验证sign
     *  plainText 返回数据报文
     *  publicKey 公钥
     * @return
     */
    public static boolean checkSign(String plainText,String publicKey) throws Exception {
        TreeMap<String ,Object> map = JSONObject.parseObject(plainText, new TypeReference<TreeMap<String, Object>>(){});
        System.out.println(JSONObject.toJSONString(map));
        StringBuilder sb = new StringBuilder();
        String sign = "";
        for (String key : map.keySet()){
            if("sign".equals(key)){
                sign =(String) map.get(key);
                continue;
            }
            sb.append(key).append("=").append(map.get(key)).append("&");
        }
        String res = sb.substring(0,sb.lastIndexOf("&"));
        log.info("拼接字符串:"+res);
        String sha256 = SHA256.getSHA256(res);
        log.info("拼接串的SHA256:"+sha256);
        String decodeSha256 = decrypt(publicKey,sign);
        log.info("sign解密的SHA256:"+decodeSha256);

        return sha256.equals(decodeSha256);
    }

    /**
     * 得到公钥
     *
     * @param key 密钥字符串(经过base64编码)
     * @throws Exception
     */
    public static PublicKey getPublicKey(String key) throws Exception {
        byte[] keyBytes;
        keyBytes = new BASE64Decoder().decodeBuffer(key);
        X509EncodedKeySpec keySpec = new X509EncodedKeySpec(keyBytes);
        KeyFactory keyFactory = KeyFactory.getInstance("RSA");
        PublicKey publicKey = keyFactory.generatePublic(keySpec);
        return publicKey;
    }
}
Base64工具类
展开查看完整demo
SHA256工具类
展开查看完整demo

请求参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

请求示例请求示例
Java
Shell
C#
PHP
响应示例响应示例
{
    "code": "string",
    "msg": "string"
}
修改于 2026-01-22 08:56:29
上一页
归集授权申请接口-收单统一结算(XZY037)
下一页
合作状态调整(XZY026)
Built with