1. 商家管理
机构平台API
  • 机构平台公共API
    • 机构公共API文档说明
    • 机构配置
      • 获取机构配置
    • 商家管理
      • 商家列表
        POST
      • 商家详情
        POST
      • 商家信息同步
        POST
    • 钱包
      • 钱包信息
    • 用户管理
      • 用户信息同步
    • 订单管理
      • 平台下单
      • 订单信息同步
      • 订单批量同步
      • 用户侧补充分润
      • 更正订单数据
    • 数据模型
      • CommonRequest
      • CommonResponse
      • MerchantInfo
      • HuifuMerchantEnterInfo
      • InstitutionConfig
  • H5公共积分商城 API
    • H5公共积分商城API文档说明
    • 商品
      • 商品列表
      • 商品详情
      • 商品分类
    • 钱包
      • 钱包余额信息
      • 积分变动记录
      • 可用积分钱包
      • 验证支付密码
    • 收货地址
      • 收货地址列表
      • 收货地址详情
      • 新增/编辑/删除地址
      • 设置默认地址
      • 批量删除地址
    • 订单
      • 确认订单
      • 提交订单
      • 订单支付
      • 订单列表
    • 其他
      • 协议列表
      • 提现问题列表
    • 提现
      • 提现方式列表
      • 获取用户月累计提现金额
      • 同意纳税协议
      • 赟余额申请提现
      • 赟余额提现规则
    • 数据模型
      • CommonRequest
      • PaginatedResponse
  1. 商家管理

商家信息同步

POST
api/institution/merchant/store_sync
同步商家信息到平台,支持新增(sync_type=1)和修改(sync_type=2)两种模式。channel默认为6(汇付)。

请求参数

Body 参数application/json

示例
{
    "ins_no": "INS001",
    "version": "1.0",
    "nonce": "abc123def456",
    "sign": "XXXXXXXXXXXXXXXX",
    "data": {
        "sync_type": 1,
        "channel": 6,
        "merchant_info": {
            "phone": "13800138000",
            "name": "测试商户",
            "merchant_type": 1,
            "type": 1,
            "address": "XX省XX市XX区XX路XX号",
            "is_firm": 1,
            "cover": "https://xxx.com/cover.jpg",
            "lng": "120.123456",
            "lat": "30.123456",
            "navigation_address": "XX省XX市XX区XX路XX号",
            "product_type": 1,
            "fy_mchnt_cd": "HF0001"
        },
        "merchant_enter_info": {
            "merchant_type": "2",
            "line_type": "2",
            "reg_name": "张三",
            "short_name": "测试商户",
            "receipt_name": "测试商户",
            "mcc": "5812",
            "district_id": "330102",
            "detail_addr": "XX路XX号",
            "license_code": "91330100XXXXXXXXXX",
            "license_pic": "https://xxx.com/license.jpg",
            "legal_name": "张三",
            "legal_cert_no": "330100XXXXXXXXXXXX",
            "contact_mobile_no": "13800138000",
            "card_type": "1",
            "card_name": "张三",
            "card_no": "6222XXXXXXXXXXXX",
            "area_id": "330100",
            "store_header_pic": "https://xxx.com/header.jpg",
            "store_indoor_pic": "https://xxx.com/indoor.jpg",
            "store_cashier_desk_pic": "https://xxx.com/cashier.jpg"
        }
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.yuanpay.vip/api/institution/merchant/store_sync' \
--header 'Content-Type: application/json' \
--data '{
    "ins_no": "INS001",
    "version": "1.0",
    "nonce": "abc123def456",
    "sign": "XXXXXXXXXXXXXXXX",
    "data": {
        "sync_type": 1,
        "channel": 6,
        "merchant_info": {
            "phone": "13800138000",
            "name": "测试商户",
            "merchant_type": 1,
            "type": 1,
            "address": "XX省XX市XX区XX路XX号",
            "is_firm": 1,
            "cover": "https://xxx.com/cover.jpg",
            "lng": "120.123456",
            "lat": "30.123456",
            "navigation_address": "XX省XX市XX区XX路XX号",
            "product_type": 1,
            "fy_mchnt_cd": "HF0001"
        },
        "merchant_enter_info": {
            "merchant_type": "2",
            "line_type": "2",
            "reg_name": "张三",
            "short_name": "测试商户",
            "receipt_name": "测试商户",
            "mcc": "5812",
            "district_id": "330102",
            "detail_addr": "XX路XX号",
            "license_code": "91330100XXXXXXXXXX",
            "license_pic": "https://xxx.com/license.jpg",
            "legal_name": "张三",
            "legal_cert_no": "330100XXXXXXXXXXXX",
            "contact_mobile_no": "13800138000",
            "card_type": "1",
            "card_name": "张三",
            "card_no": "6222XXXXXXXXXXXX",
            "area_id": "330100",
            "store_header_pic": "https://xxx.com/header.jpg",
            "store_indoor_pic": "https://xxx.com/indoor.jpg",
            "store_cashier_desk_pic": "https://xxx.com/cashier.jpg"
        }
    }
}'

返回响应

🟢200成功
application/json
成功
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "同步成功",
    "data": null
}
修改于 2026-03-17 08:37:22
上一页
商家详情
下一页
钱包信息
Built with