EurewaX开放平台
  1. 2.1 商户入网
  • 基础规范
    • 全局约定
    • 报文结构
    • 签名
    • 加密
  • 交互流程
    • 业务申请流程
  • 业务接口
    • 1 公共服务
      • 1.1 事件通知
        • 配置通知URL
      • 1.2 文件服务
        • 上传文件
        • 补充业务材料
      • 1.3 认证服务
        • 获取商户Token
    • 2 入网服务
      • 2.1 商户入网
        • 注册商户
          POST
        • KYC申请
          POST
        • KYB申请
          POST
        • 查询KYC审核结果
          POST
        • KYC审核结果通知
        • 查询KYB审核结果
          POST
        • KYB审核结果通知
        • 获取可开通产品列表
          GET
    • 3 法币业务
      • 3.1 收款服务
        • 3.1.1 收款店铺管理
          • 获取平台站点
          • 添加店铺持有人
          • 绑定店铺
          • 查询店铺信息
        • 3.1.2 VA账号服务
          • 申请VA账号
          • 下载开户凭证
          • 查询VA账号
          • VA账号变更通知
        • 3.1.3 收款交易处理
          • 收款入账通知
      • 3.2 付款服务
        • 3.2.1 收款人管理
          • 添加收款人
          • 删除收款人
          • 查询收款人审核结果
          • 收款人审核结果通知
        • 3.2.2 付款交易处理
          • 单笔付款
          • 付款结果通知
        • 3.2.3 结汇额度管理
          • 查询结汇额度
          • 上传结汇材料
          • 查询结汇材料审核结果
          • 结汇材料审核结果通知
      • 3.3 外汇服务
        • 查询商户汇率
        • 商户换汇询价
        • 实时换汇
      • 3.4 账户服务
        • 3.4.1 账户管理
          • 账户查询
          • 账户授权
          • 取消授权
        • 3.4.2 账户交易
          • 账户转账
          • 批量转账
          • 资金归集
          • 资金归集结果通知
          • 批量转账结果通知
          • 单笔转账结果通知
      • 3.5 交易查询
        • 3.5.1 交易详情
          • 资金归集交易详情
          • 付款交易详情
          • 收款交易详情
          • 转账交易详情
          • 换汇交易详情
        • 下载交易凭证
        • 查询交易详情
    • 4 数币业务
      • 4.1 基础功能
        • 查询汇率
        • 查询支持的资产
      • 4.2 账户管理
        • 查询账户列表
      • 4.3 收款工具管理
        • 查询收款工具
      • 4.4 收款人管理
        • 添加收款人
        • 删除收款人
        • 查询收款人列表
        • 收款人审核结果通知
      • 4.5 交易管理
        • 法币充值
          • 法币充值
        • 法币提现
          • 法币提现
        • 数币充值
          • 数币充值
        • 数币提现
          • 数币提现
        • 数币买入
          • 获取数币买入报价
          • 买入数币
        • 数币卖出
          • 获取数币卖出报价
          • 卖出数币
        • 法币转数币
          • 获取法转数报价
          • 法币转数币
        • 数币转法币
          • 获取数转法报价
          • 数币转法币
        • 充值/提现交易费用试算
        • 查询交易详情
        • 查询交易记录
        • 交易结果通知
    • 5 VCC业务
      • 5.1 卡账户管理服务
        • 新建共享账户
        • 共享账户资金转入
        • 共享账户资金转出
        • 查询资金交易申请详情
        • 查询共享账户余额
        • 查询共享账户列表
        • 查询资金交易列表
        • 资金交易结果通知
      • 5.2 卡申请服务
        • 查询产品列表
        • 虚拟卡申请
        • 查询申请详情
        • 卡申请结果通知
      • 5.3 卡信息查询服务
        • 查询卡CVV
        • 查询卡信息
        • 查询卡片余额
      • 5.4 卡管理服务
        • 解冻卡片
        • 激活卡片
        • 注销卡片
        • 冻结卡片
        • 修改卡限额
        • 修改持卡人
        • 卡状态变更通知
      • 5.5 卡交易服务
        • 卡资金转入
        • 卡资金转出
        • 查询卡交易列表
        • 查询卡订单列表
        • 查询手续费交易列表
        • 查询卡资金明细
        • 授权结果通知
        • 清算结果通知
        • 手续费交易结果通知
        • 卡3DS验证通知
    • 6 聚合收银
      • 创建订单
      • 查询订单详情
      • 支付结果通知
  • 业务联调
    • 整体流程
    • 环境参数
  • 附录
    • 枚举类型
    • KYC模板
    • KYB模板
  • 数据模型
    • TransferOrder
  1. 2.1 商户入网

KYC申请

POST
/api/v1/ex/onboarding/merchant/kyc
提交商户的KYC信息和材料,KYC审核通过后才能进行后续操作,否则无法发起业务请求。文件、 图片附件类材料请调用【上传文件】接口上传。

请求参数

Header 参数

Body 参数application/json

示例
{
    "merchantNo": "26040214854040",
    "bizOrderNo": "3bbb8881228",
    "bizType": "B2B",
    "kycData": 
    {
    "entityLegalDtos": {
        "director1": [
            {
                "meterialName": "请选择您的身份",
                "meterialValue": "director",
                "meterialCode": "legalType"
            },
            {
                "meterialName": "证件签发国家或地区",
                "meterialValue": "CN",
                "meterialCode": "country"
            },
            {
                "meterialName": "证件类型",
                "meterialValue": "idCard",
                "meterialCode": "certType"
            },
            {
                "meterialName": "验证方式",
                "meterialValue": "idCardHoldAuth",
                "meterialCode": "certificationType"
            },
            {
                "meterialName": "身份证正面照片",
                "meterialValue": "",
                "meterialCode": "id_card_front",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "zhang_san_front.jpg",
                        "type": "id_card_front",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "身份证正面照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
            {
                "meterialName": "身份证背面照片",
                "meterialValue": "",
                "meterialCode": "id_card_back",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "zhang_san_back.jpg",
                        "type": "id_card_back",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "身份证背面照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
            {
                "meterialName": "身份证号码",
                "meterialValue": "110101199022026434",
                "meterialCode": "idCardNo"
            },
            {
                "meterialName": "姓名",
                "meterialValue": "张三11",
                "meterialCode": "fullName"
            },
            {
                "meterialName": "出生日期",
                "meterialValue": "1990-01-01",
                "meterialCode": "birthday"
            },
            {
                "meterialName": "证件有效期开始时间",
                "meterialValue": "2015-01-01",
                "meterialCode": "certExpirationBegin"
            },
            {
                "meterialName": "证件有效期结束时间",
                "meterialValue": "2035-01-01",
                "meterialCode": "certExpirationEnd"
            },
            {
                "meterialName": "董事持证照片",
                "meterialValue": "",
                "meterialCode": "directorHandheldPhoto",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "zhang_san_hold.jpg",
                        "type": "directorHandheldPhoto",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "董事持证照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
	    {
                "display": "IMAGES",
                "meterialCode": "addressCertificate",
                "meterialName": "地址证明(最近3个月),即银行对账单,水电费账单,或任何政府签发的信件",
                "kycEntityAttachmentDto": [
                    {
                        "location": "/unified/account/createAccount",
                        "fileName": "f6784d63654ddbf8f975aa02f2718c1b.jpg",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "previewUrl": "",
                        "name": "f6784d63654ddbf8f975aa02f2718c1b.jpg",
                        "isMerchantOriginal": "Y",
                        "type": "addressCertificate"
                    }
                ]
            },
            {
                "meterialName": "董事常住地址",
                "meterialValue": "北京市朝阳区望京街道 1 号",
                "meterialCode": "detailAddress"
            },
            {
                "display": "TEXT",
                "meterialCode": "Nationality",
                "meterialName": "国籍",
                "meterialValue": "中国"
            },
            {
                "meterialName": "同时是最终受益人",
                "meterialValue": "N",
                "meterialCode": "sameAsUbo"
            }
        ],
        "UBO1": [
            {
                "meterialName": "证件签发国家或地区",
                "meterialValue": "CN",
                "meterialCode": "country"
            },
            {
                "meterialName": "证件类型",
                "meterialValue": "idCard",
                "meterialCode": "certType"
            },
            {
                "meterialName": "身份证正面照片",
                "meterialValue": "",
                "meterialCode": "id_card_front",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "wang_wu_front.jpg",
                        "type": "id_card_front",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "身份证正面照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
            {
                "meterialName": "身份证背面照片",
                "meterialValue": "",
                "meterialCode": "id_card_back",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "wang_wu_back.jpg",
                        "type": "id_card_back",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "身份证背面照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            }, 
	    {
                "meterialName": "受益人持证照片",
                "meterialValue": "",
                "meterialCode": "directorHandheldPhoto",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "zhang_san_hold.jpg",
                        "type": "directorHandheldPhoto",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "受益人持证照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
	    {
                "display": "IMAGES",
                "meterialCode": "addressCertificate",
                "meterialName": "地址证明(最近3个月),即银行对账单,水电费账单,或任何政府签发的信件",
                "kycEntityAttachmentDto": [
                    {
                        "location": "/unified/account/createAccount",
                        "fileName": "f6784d63654ddbf8f975aa02f2718c1b.jpg",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "previewUrl": "",
                        "name": "f6784d63654ddbf8f975aa02f2718c1b.jpg",
                        "isMerchantOriginal": "Y",
                        "type": "addressCertificate"
                    }
                ]
            },
            {
                "meterialName": "身份证号码",
                "meterialValue": "310101199313035456",
                "meterialCode": "idCardNo"
            },
            {
                "meterialName": "姓名",
                "meterialValue": "王五",
                "meterialCode": "fullName"
            },
            {
                "meterialName": "出生日期",
                "meterialValue": "1990-01-01",
                "meterialCode": "birthday"
            },
            {
                "meterialName": "证件有效期开始时间",
                "meterialValue": "2015-01-01",
                "meterialCode": "certExpirationBegin"
            },
            {
                "meterialName": "证件有效期结束时间",
                "meterialValue": "2035-01-01",
                "meterialCode": "certExpirationEnd"
            },
	    {
                "meterialName": "常住地址",
                "meterialValue": "北京市朝阳区望京街道 1 号",
                "meterialCode": "detailAddress"
            },
            {
                "display": "TEXT",
                "meterialCode": "Nationality",
                "meterialName": "国籍",
                "meterialValue": "中国"
            }
        ]
    },
    "entityDynamicDtoList": [
        {
            "meterialName": "主体所在国家地区",
            "meterialValue": "HK",
            "meterialCode": "countryCode"
        },
        {
            "meterialName": "主体类型",
            "meterialValue": "enterprise",
            "meterialCode": "entityType"
        },
        {
            "meterialName": "公司注册证明书",
            "meterialValue": "",
            "meterialCode": "incorporation_certificate",
            "kycEntityAttachmentDto": [
                {
                    "fileName": "inc.png",
                    "type": "incorporation_certificate",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                    "isMerchantOriginal": "Y",
                    "name": "公司注册证明书",
                    "location": "/unified/account/createAccount",
                    "category": "entity"
                }
            ]
        },
        {
            "meterialName": "商业登记证",
            "meterialValue": "",
            "meterialCode": "business_register_certificate",
            "kycEntityAttachmentDto": [
                {
                    "fileName": "br.png",
                    "type": "business_register_certificate",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                    "isMerchantOriginal": "Y",
                    "name": "商业登记证",
                    "location": "/unified/account/createAccount",
                    "category": "entity"
                }
            ]
        },
        {
            "meterialName": "法团成立表(NNC1)",
            "meterialValue": "",
            "meterialCode": "NNC1",
            "kycEntityAttachmentDto": [
                {
                    "fileName": "nnc1.png",
                    "type": "NNC1",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                    "isMerchantOriginal": "Y",
                    "name": "法团成立表(NNC1)",
                    "location": "/unified/account/createAccount",
                    "category": "entity"
                }
            ]
        },
        {
            "meterialName": "周年申报表(NAR1)",
            "meterialValue": "",
            "meterialCode": "NAR1",
            "kycEntityAttachmentDto": [
                {
                    "fileName": "nar1.png",
                    "type": "NAR1",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                    "isMerchantOriginal": "Y",
                    "name": "周年申报表(NAR1)",
                    "location": "/unified/account/createAccount",
                    "category": "entity"
                }
            ]
        },
        {
            "meterialName": "证件号码",
            "meterialValue": "12345665673000121",
            "meterialCode": "certificateNumber"
        },
        {
            "meterialName": "企业名称",
            "meterialValue": "BB Tech",
            "meterialCode": "companyName"
        },
        {
            "meterialName": "企业英文名称",
            "meterialValue": "BB & Partners (UK) Ltd.",
            "meterialCode": "companyNameEn"
        },
        {
            "meterialName": "企业经营地址",
            "meterialValue": "香港中环皇后大道中 99 号",
            "meterialCode": "businessAddress"
        },
	{
            "meterialName": "企业注册日期",
            "meterialValue": "2025-01-01",
            "meterialCode": "registrationDate"
        },
        {
            "meterialName": "企业员工数",
            "meterialValue": "50-100人",
            "meterialCode": "enterpriseScale"
        },
        {
            "meterialName": "公司收入来源(维持公司经营的资金来源途径和方式)",
            "meterialValue": "营业收入",
            "meterialCode": "sourceFunds"
        },
        {
            "meterialName": "公司收入来源详细说明",
            "meterialValue": "主要资金来源为软件订阅与技术服务费",
            "meterialCode": "description_sourceFunds"
        }
    ],
      "entitykybDtos": [
        {
            "display": "select",
            "displayOrder": 0,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "b2bMcc",
            "meterialId": "",
            "meterialName": "行业模式",
            "meterialValue": "goods",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
	{
            "display": "select",
            "displayOrder": 0,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "industry",
            "meterialId": "",
            "meterialName": "行业类型",
            "meterialValue": "Education",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "select",
            "displayOrder": 1,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "hasSite",
            "meterialId": "",
            "meterialName": "是否有官方网站",
            "meterialValue": "",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "select",
            "displayOrder": 2,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "siteType",
            "meterialId": "",
            "meterialName": "网站类型",
            "meterialValue": "",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "cascadeCategoryKey": "",
            "display": "TEXT",
            "displayOrder": 3,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "storeUrl",
            "meterialId": "",
            "meterialName": "店铺网址",
            "meterialValue": "https://bbss.com",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "multi select",
            "displayOrder": 2,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "relateCountries",
            "meterialId": "",
            "meterialName": "涉及国家",
            "meterialValue": "",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "cascadeCategoryKey": "",
            "display": "TEXT",
            "displayOrder": 4,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "exportTypeDesc",
            "meterialId": "",
            "meterialName": "涉及产品品类",
            "meterialValue": "阿萨大时代",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "select",
            "displayOrder": 5,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "expectAmount",
            "meterialId": "",
            "meterialName": "预计在iPayLinks的月交易额(美元)",
            "meterialValue": "100000",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "select",
            "displayOrder": 6,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "monthExpectedTranNum",
            "meterialId": "",
            "meterialName": "预计在iPayLinks的月交易笔数",
            "meterialValue": "111",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "cascadeCategoryKey": "",
            "display": "attachmentMix",
            "displayOrder": 7,
            "explainText": "",
            "imgExplainUrl": "",
            "kycEntityAttachmentDto": [
                {
                    "category": "kyb",
                    "fileName": "",
                    "isMerchantOriginal": "Y",
                    "location": "",
                    "name": "补充资料",
                    "previewUrl": "",
                    "type": "additionalInformation",
                    "url": ""
                }
            ],
            "materialGroup": "",
            "meterialCode": "additionalInformation",
            "meterialId": "",
            "meterialName": "补充资料",
            "meterialValue": "",
            "mpDisplay": "Y",
            "mpRequired": "N",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        }
    ],
    "fundInInfos":[
	{
	    "meterialCode": "sourceOfFunds",
            "meterialName": "资金来源",
            "meterialValue": "otc"
	},
	{
	    "meterialCode": "sourceOfFundsProof",
            "meterialName": "资金来源证明",
            "meterialValue": "",
	    "kycEntityAttachmentDto": [
                {
                    "fileName": "ceshi.jpg",
                    "location": "",
                    "name": "资金来源证明",
                    "previewUrl": "",
                    "type": "sourceOfFundsProof",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3"
                }
            ]
	},
	{
	    "meterialCode": "purposeOfFunds",
            "meterialName": "资金用途",
            "meterialValue": "SupplierPayment"
	},
	{
	"meterialCode": "purposeOfFundsProof",
            "meterialName": "资金用途证明",
            "meterialValue": "",
	    "kycEntityAttachmentDto": [
                {
                    "category": "kyb",
                    "fileName": "ceshi1.jpg",
                    "location": "",
                    "name": "资金用途证明",
                    "previewUrl": "",
                    "type": "purposeOfFundsProof",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3"
                }
            ]
	}
    ]
}
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/v1/ex/onboarding/merchant/kyc' \
--header 'x-app-id;' \
--header 'x-request-id;' \
--header 'x-signature;' \
--header 'Content-Type: application/json' \
--data '{
    "merchantNo": "26040214854040",
    "bizOrderNo": "3bbb8881228",
    "bizType": "B2B",
    "kycData": 
    {
    "entityLegalDtos": {
        "director1": [
            {
                "meterialName": "请选择您的身份",
                "meterialValue": "director",
                "meterialCode": "legalType"
            },
            {
                "meterialName": "证件签发国家或地区",
                "meterialValue": "CN",
                "meterialCode": "country"
            },
            {
                "meterialName": "证件类型",
                "meterialValue": "idCard",
                "meterialCode": "certType"
            },
            {
                "meterialName": "验证方式",
                "meterialValue": "idCardHoldAuth",
                "meterialCode": "certificationType"
            },
            {
                "meterialName": "身份证正面照片",
                "meterialValue": "",
                "meterialCode": "id_card_front",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "zhang_san_front.jpg",
                        "type": "id_card_front",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "身份证正面照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
            {
                "meterialName": "身份证背面照片",
                "meterialValue": "",
                "meterialCode": "id_card_back",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "zhang_san_back.jpg",
                        "type": "id_card_back",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "身份证背面照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
            {
                "meterialName": "身份证号码",
                "meterialValue": "110101199022026434",
                "meterialCode": "idCardNo"
            },
            {
                "meterialName": "姓名",
                "meterialValue": "张三11",
                "meterialCode": "fullName"
            },
            {
                "meterialName": "出生日期",
                "meterialValue": "1990-01-01",
                "meterialCode": "birthday"
            },
            {
                "meterialName": "证件有效期开始时间",
                "meterialValue": "2015-01-01",
                "meterialCode": "certExpirationBegin"
            },
            {
                "meterialName": "证件有效期结束时间",
                "meterialValue": "2035-01-01",
                "meterialCode": "certExpirationEnd"
            },
            {
                "meterialName": "董事持证照片",
                "meterialValue": "",
                "meterialCode": "directorHandheldPhoto",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "zhang_san_hold.jpg",
                        "type": "directorHandheldPhoto",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "董事持证照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
	    {
                "display": "IMAGES",
                "meterialCode": "addressCertificate",
                "meterialName": "地址证明(最近3个月),即银行对账单,水电费账单,或任何政府签发的信件",
                "kycEntityAttachmentDto": [
                    {
                        "location": "/unified/account/createAccount",
                        "fileName": "f6784d63654ddbf8f975aa02f2718c1b.jpg",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "previewUrl": "",
                        "name": "f6784d63654ddbf8f975aa02f2718c1b.jpg",
                        "isMerchantOriginal": "Y",
                        "type": "addressCertificate"
                    }
                ]
            },
            {
                "meterialName": "董事常住地址",
                "meterialValue": "北京市朝阳区望京街道 1 号",
                "meterialCode": "detailAddress"
            },
            {
                "display": "TEXT",
                "meterialCode": "Nationality",
                "meterialName": "国籍",
                "meterialValue": "中国"
            },
            {
                "meterialName": "同时是最终受益人",
                "meterialValue": "N",
                "meterialCode": "sameAsUbo"
            }
        ],
        "UBO1": [
            {
                "meterialName": "证件签发国家或地区",
                "meterialValue": "CN",
                "meterialCode": "country"
            },
            {
                "meterialName": "证件类型",
                "meterialValue": "idCard",
                "meterialCode": "certType"
            },
            {
                "meterialName": "身份证正面照片",
                "meterialValue": "",
                "meterialCode": "id_card_front",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "wang_wu_front.jpg",
                        "type": "id_card_front",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "身份证正面照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
            {
                "meterialName": "身份证背面照片",
                "meterialValue": "",
                "meterialCode": "id_card_back",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "wang_wu_back.jpg",
                        "type": "id_card_back",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "身份证背面照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            }, 
	    {
                "meterialName": "受益人持证照片",
                "meterialValue": "",
                "meterialCode": "directorHandheldPhoto",
                "kycEntityAttachmentDto": [
                    {
                        "fileName": "zhang_san_hold.jpg",
                        "type": "directorHandheldPhoto",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "isMerchantOriginal": "Y",
                        "name": "受益人持证照片",
                        "location": "/unified/account/createAccount",
                        "category": "legal"
                    }
                ]
            },
	    {
                "display": "IMAGES",
                "meterialCode": "addressCertificate",
                "meterialName": "地址证明(最近3个月),即银行对账单,水电费账单,或任何政府签发的信件",
                "kycEntityAttachmentDto": [
                    {
                        "location": "/unified/account/createAccount",
                        "fileName": "f6784d63654ddbf8f975aa02f2718c1b.jpg",
                        "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                        "previewUrl": "",
                        "name": "f6784d63654ddbf8f975aa02f2718c1b.jpg",
                        "isMerchantOriginal": "Y",
                        "type": "addressCertificate"
                    }
                ]
            },
            {
                "meterialName": "身份证号码",
                "meterialValue": "310101199313035456",
                "meterialCode": "idCardNo"
            },
            {
                "meterialName": "姓名",
                "meterialValue": "王五",
                "meterialCode": "fullName"
            },
            {
                "meterialName": "出生日期",
                "meterialValue": "1990-01-01",
                "meterialCode": "birthday"
            },
            {
                "meterialName": "证件有效期开始时间",
                "meterialValue": "2015-01-01",
                "meterialCode": "certExpirationBegin"
            },
            {
                "meterialName": "证件有效期结束时间",
                "meterialValue": "2035-01-01",
                "meterialCode": "certExpirationEnd"
            },
	    {
                "meterialName": "常住地址",
                "meterialValue": "北京市朝阳区望京街道 1 号",
                "meterialCode": "detailAddress"
            },
            {
                "display": "TEXT",
                "meterialCode": "Nationality",
                "meterialName": "国籍",
                "meterialValue": "中国"
            }
        ]
    },
    "entityDynamicDtoList": [
        {
            "meterialName": "主体所在国家地区",
            "meterialValue": "HK",
            "meterialCode": "countryCode"
        },
        {
            "meterialName": "主体类型",
            "meterialValue": "enterprise",
            "meterialCode": "entityType"
        },
        {
            "meterialName": "公司注册证明书",
            "meterialValue": "",
            "meterialCode": "incorporation_certificate",
            "kycEntityAttachmentDto": [
                {
                    "fileName": "inc.png",
                    "type": "incorporation_certificate",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                    "isMerchantOriginal": "Y",
                    "name": "公司注册证明书",
                    "location": "/unified/account/createAccount",
                    "category": "entity"
                }
            ]
        },
        {
            "meterialName": "商业登记证",
            "meterialValue": "",
            "meterialCode": "business_register_certificate",
            "kycEntityAttachmentDto": [
                {
                    "fileName": "br.png",
                    "type": "business_register_certificate",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                    "isMerchantOriginal": "Y",
                    "name": "商业登记证",
                    "location": "/unified/account/createAccount",
                    "category": "entity"
                }
            ]
        },
        {
            "meterialName": "法团成立表(NNC1)",
            "meterialValue": "",
            "meterialCode": "NNC1",
            "kycEntityAttachmentDto": [
                {
                    "fileName": "nnc1.png",
                    "type": "NNC1",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                    "isMerchantOriginal": "Y",
                    "name": "法团成立表(NNC1)",
                    "location": "/unified/account/createAccount",
                    "category": "entity"
                }
            ]
        },
        {
            "meterialName": "周年申报表(NAR1)",
            "meterialValue": "",
            "meterialCode": "NAR1",
            "kycEntityAttachmentDto": [
                {
                    "fileName": "nar1.png",
                    "type": "NAR1",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3",
                    "isMerchantOriginal": "Y",
                    "name": "周年申报表(NAR1)",
                    "location": "/unified/account/createAccount",
                    "category": "entity"
                }
            ]
        },
        {
            "meterialName": "证件号码",
            "meterialValue": "12345665673000121",
            "meterialCode": "certificateNumber"
        },
        {
            "meterialName": "企业名称",
            "meterialValue": "BB Tech",
            "meterialCode": "companyName"
        },
        {
            "meterialName": "企业英文名称",
            "meterialValue": "BB & Partners (UK) Ltd.",
            "meterialCode": "companyNameEn"
        },
        {
            "meterialName": "企业经营地址",
            "meterialValue": "香港中环皇后大道中 99 号",
            "meterialCode": "businessAddress"
        },
	{
            "meterialName": "企业注册日期",
            "meterialValue": "2025-01-01",
            "meterialCode": "registrationDate"
        },
        {
            "meterialName": "企业员工数",
            "meterialValue": "50-100人",
            "meterialCode": "enterpriseScale"
        },
        {
            "meterialName": "公司收入来源(维持公司经营的资金来源途径和方式)",
            "meterialValue": "营业收入",
            "meterialCode": "sourceFunds"
        },
        {
            "meterialName": "公司收入来源详细说明",
            "meterialValue": "主要资金来源为软件订阅与技术服务费",
            "meterialCode": "description_sourceFunds"
        }
    ],
      "entitykybDtos": [
        {
            "display": "select",
            "displayOrder": 0,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "b2bMcc",
            "meterialId": "",
            "meterialName": "行业模式",
            "meterialValue": "goods",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
	{
            "display": "select",
            "displayOrder": 0,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "industry",
            "meterialId": "",
            "meterialName": "行业类型",
            "meterialValue": "Education",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "select",
            "displayOrder": 1,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "hasSite",
            "meterialId": "",
            "meterialName": "是否有官方网站",
            "meterialValue": "",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "select",
            "displayOrder": 2,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "siteType",
            "meterialId": "",
            "meterialName": "网站类型",
            "meterialValue": "",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "cascadeCategoryKey": "",
            "display": "TEXT",
            "displayOrder": 3,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "storeUrl",
            "meterialId": "",
            "meterialName": "店铺网址",
            "meterialValue": "https://bbss.com",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "multi select",
            "displayOrder": 2,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "relateCountries",
            "meterialId": "",
            "meterialName": "涉及国家",
            "meterialValue": "",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "cascadeCategoryKey": "",
            "display": "TEXT",
            "displayOrder": 4,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "exportTypeDesc",
            "meterialId": "",
            "meterialName": "涉及产品品类",
            "meterialValue": "阿萨大时代",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "select",
            "displayOrder": 5,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "expectAmount",
            "meterialId": "",
            "meterialName": "预计在iPayLinks的月交易额(美元)",
            "meterialValue": "100000",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "display": "select",
            "displayOrder": 6,
            "explainText": "",
            "imgExplainUrl": "",
            "materialGroup": "",
            "meterialCode": "monthExpectedTranNum",
            "meterialId": "",
            "meterialName": "预计在iPayLinks的月交易笔数",
            "meterialValue": "111",
            "mpDisplay": "Y",
            "mpRequired": "Y",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        },
        {
            "cascadeCategoryKey": "",
            "display": "attachmentMix",
            "displayOrder": 7,
            "explainText": "",
            "imgExplainUrl": "",
            "kycEntityAttachmentDto": [
                {
                    "category": "kyb",
                    "fileName": "",
                    "isMerchantOriginal": "Y",
                    "location": "",
                    "name": "补充资料",
                    "previewUrl": "",
                    "type": "additionalInformation",
                    "url": ""
                }
            ],
            "materialGroup": "",
            "meterialCode": "additionalInformation",
            "meterialId": "",
            "meterialName": "补充资料",
            "meterialValue": "",
            "mpDisplay": "Y",
            "mpRequired": "N",
            "nextMeterialCode": "",
            "noInputText": "",
            "opDisplay": "N",
            "opRequired": "N"
        }
    ],
    "fundInInfos":[
	{
	    "meterialCode": "sourceOfFunds",
            "meterialName": "资金来源",
            "meterialValue": "otc"
	},
	{
	    "meterialCode": "sourceOfFundsProof",
            "meterialName": "资金来源证明",
            "meterialValue": "",
	    "kycEntityAttachmentDto": [
                {
                    "fileName": "ceshi.jpg",
                    "location": "",
                    "name": "资金来源证明",
                    "previewUrl": "",
                    "type": "sourceOfFundsProof",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3"
                }
            ]
	},
	{
	    "meterialCode": "purposeOfFunds",
            "meterialName": "资金用途",
            "meterialValue": "SupplierPayment"
	},
	{
	"meterialCode": "purposeOfFundsProof",
            "meterialName": "资金用途证明",
            "meterialValue": "",
	    "kycEntityAttachmentDto": [
                {
                    "category": "kyb",
                    "fileName": "ceshi1.jpg",
                    "location": "",
                    "name": "资金用途证明",
                    "previewUrl": "",
                    "type": "purposeOfFundsProof",
                    "url": "http://filesystem.ipaylinks.com?bucket=noprod-s3-private&endpoint=cn-north-1&fileLocation=unified-filesystem/openapi/0/2025-10-20/7c7b9d14af4049b28229f4252af6a8ad/QQ截图20250910105453.png&objectType=s3"
                }
            ]
	}
    ]
}
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": "string",
    "message": "string",
    "data": {
        "status": "string",
        "completeTime": "20230101120000",
        "failReason": "string"
    }
}
上一页
注册商户
下一页
KYB申请
Built with