1. 客户管理
星驿支付文档中心(dev)
  • 文档说明
    • 阅读对象
    • 版本说明
  • 术语
    • 支付模式
    • 名词解释
  • 接口规则
    • 协议规则
    • 安全规范
  • 星账云管家
    • 星账云管家
    • 功能开通
      • 功能开通(XZY001)
      • 编辑上传付款凭证(XZY002)
      • 编辑(XZY003)
      • 修改生效状态(XZY004)
      • 查询详情信息(XZY005)
      • 产品开通审核通知(XZY006)
    • 公共接口
      • 上传文件(XZY013)
    • 分账
      • 交易
        • 订单查询(XZY015)
        • 分账结果回调(XZY016)
        • 分账撤销退回(XZY017)
        • 分账合并入账电子回单下载(XZY039)
        • 分账结算电子回单下载(XZY037)
        • 余额查询接口(XZY041)
        • 分账(XZY014)
      • 客户管理
        • 分账授权申请接口-收单统一结算(XZY043)
          POST
        • 新增客户(XZY018)
          POST
        • 审核通知(XZY019)
          POST
        • 合作状态调整(XZY020)
          POST
        • 查询分账客户信息(XZY021)
          POST
        • 替换客户结算卡(XZY022)
          POST
        • 编辑客户(XZY023)
          POST
        • 批量分账授权申请接口-收单统一结算(XZY044)
          POST
        • 批量查询分账客户信息(XZY-001-001)
          POST
        • 解约/重启签约(XZY-001-002)
          POST
    • 归集
      • 开户/授权
        • 归集授权申请接口-收单统一结算(XZY037)
        • 审核通知(XZY025)
        • 合作状态调整(XZY026)
        • 查询归集客户信息(XZY027)
        • 替换结算卡(XZY028)
        • 编辑信息(XZY029)
      • 交易
        • 订单查询(XZY031)
        • 归集结果回调(XZY032)
        • 归集撤销退回(XZY033)
        • 归集结算电子回单下载(XZY038)
        • 归集合并入账电子回单下载(XZY040)
        • 余额查询接口(XZY042)
        • 归集(XZY030)
    • 提现
      • 提现电子回单下载(XZY040)
      • 提现订单查询(XZY035)
      • 提现(XZY036)
      • 结算回调通知(XZY050)
    • 账户
      • 结算资金流水查询(XZY047)
      • 结算卡资金流水查询(XZY049)
  1. 客户管理

新增客户(XZY018)

POST
/yyfsevr/manage/ryf/customer/addCustomer
1.
mainCustId 是开通分账功能设置的600商户,在星驿付的唯一代码,作为分账出款方
2.
附件补充说明
客户签约时无需人脸验证,需上传 0-身份证人像面,1-身份证国徽面
对私时结算人姓名与法人姓名不一致或对公时结算人姓名与企业名称不一致,需上传 12-非法人授权书
对私时需上传8结算卡正面照片
对私时结算人姓名与法人姓名不一致需上送31结算人身份证人像照,32结算人身份证国徽照
客户线下已签约,无需走电子签约,需上传 5-分账协议
新增客户类型为企业,分账比例超过30%,需上传 15门头照,16室内照,3收银台照
新增客户类型为企业,需上传30对公材料,例如【请上传以下任意一种对公材料(任选其一即可):基本存款账户证明、印鉴卡、银行对账单、商户自己打印的对公材料、网上银行电子回执单】
新增客户类型为企业,需上送10营业执照

请求参数

Body 参数application/json

示例
{
    "agetId": "61000000339343",
    "mainCustId": "60000001050921",
    "version": "1.0.0",
    "timestamp": "2025102111112",
    "sign": "",
    "customerBaseInfo": {
        "custId": "60000001046928",
        "customerType": "0",
        "settleType": "1",
        "idCardName": "郑英镇",
        "idCard": "350583199302280773",
        "usci": "92350105MACXMRAKXC",
        "phoneNo": "19926531903",
        "maxValue": 0.10,
        "tag": "测试标签",
        "receiptType": "0",
        "settlementCycle": "1",
        "isMergeWithDraw":"1",
        "signTarget":"1"
    },
    "splitSettlementList": [
        {
            "cardNo": "6212261402003362115",
            "cardName": "郑英镇",
            "isDefault": "1"
            ,"interbankNumber":"102393000173"
            ,"settleCardType": 0,
            "settleCardId": "350583199302280773",
            "settleCardStartDate": "20260309",
            "settleCardEndDate": "20260309"
        }
    ]
    ,
    "attachmentList": [
        {
            "attachmentType": "5",
            "filePath": "test.png",
            "fileName": "test.png"
        }
    ]
}

请求示例代码

Java
Shell
C#
PHP
Python
请求示例请求示例
Java
Shell
C#
PHP

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": "000000",
    "msg": "成功",
    "data": {
        "customerId": "20000000000594",
        "shortUrl": "https://wxaurl.cn/6PMt0Rn0mUg",
        "authId": "8351080436662800384"
    }
}
修改于 2026-04-02 09:51:27
上一页
分账授权申请接口-收单统一结算(XZY043)
下一页
审核通知(XZY019)
Built with