商家信息同步

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

商家详情

钱包信息