商户线上进件 |
您所在的位置:网站首页 › 腾讯微卡APP官网 › 商户线上进件 |
商户管理服务接口列表商户线上进件商户线上进件
线下提交资料以后,客户拿到业务线ID,进行商户的进件。 对于微信进件,需调用资质文件上传照片,在调用进件接口时,除了通用的参数外,还需传入SalesInfo、CredentialFiles、SettleInfo,在接口调用后,会给商户业务联系人或法人发送签约短信,短信包含签约链接,客户点击链接填写详细信息。进件完成后会收到回调通知或主动查询结果。 对于微企付进件,需调用资质文件上传照片,在调用进件接口时,除了通用的参数外,还需传入CredentialFiles、SettleInfo,在接口调用后,会给商户业务联系人或法人发送签约短信,短信包含签约链接,客户点击链接填写详细信息。进件完成后会收到回调通知或主动查询结果。 对于平安见证宝进件,在调用进件接口时,除了通用的参数外,还需传入SettleInfo、InterConnectionSubMerchantData、MerchantRole、OutSubMerchantExtensionInfo的ServicePhone字段。在接口调用后银行会向结算账户转入小于等于0.5元的随机金额,并短信通知客户查看,客户查看后,需将收到的金额大小及短信序列号通过子商户进件绑定结算卡校验接口传入完成进件。 接口说明 请求方式:posthttps://p.wecard.tencent.com/cloudpay/v1/merchant/out/channelSubMerchant/createAndOnlineAsyncAggregatedRegistration 请求参数 RequestBody 包体OutRegistrationNo必填string外部进件申请号 最小长度:0 最大长度:50OutSubMerchantId必填string外部子商户ID 最小长度:0 最大长度:50ChannelMerchantId必填string业务线ID 最小长度:0 最大长度:50ChannelName必填string渠道名.微信-WECHAT;微企付-ENTPAY;通联-ALLINPAY;平安见证宝-PINGANJZB 最小长度:0 最大长度:50OutSubMerchantType必填string外部商户类型ENTERPRISE:企业商户 INSTITUTION:事业单位商户 INDIVIDUALBISS:个体工商户PERSON:个人商户(小微商户) SUBJECT_TYPE_OTHERS:其他组织 最小长度:0 最大长度:50OutSubMerchantName必填string外部商户名称 再次进件可不传 OutSubMerchantShortName必填string外部商户简称建行渠道长度限制1到20 再次进件可不传 最小长度:0 最大长度:50NotifyUrl选填string进件结果通知地址 最小长度:0 最大长度:300OutSubMerchantDescription选填string外部子商户描述 PaymentMethod选填string支付方式 UNIFIED_PAYMENT:统一付款,C2B场景模式下,默认使用该值 StallNumber选填string门店档位号 ApiMode选填string对接模式,目前主要for农行生效 H5_MODE: H5模式 MP_MODE: 公众号模式 BusinessLicenseInfo必填object营业证件信息,见下文说明 再次进件可不传 BusinessLicenseType必填string营业证件类型IDCARD:身份证 CREDITCODE:统一社会信用代码 最小长度:0 最大长度:32BusinessLicenseNumber必填string营业证件号码 非个人商户上送统一社会信用代码,个人商户上送身份证号码 最小长度:0 最大长度:32BusinessLicenseValidityType必填string营业证件有效期类型 LONGTERM:长期有效OTHER:非长期有效 最小长度:0 最大长度:32BusinessLicenseEffectiveDate必填string营业证件生效日期,yyyy-MM-dd 最小长度:0 最大长度:10BusinessLicenseExpireDate选填string营业证件失效日期,yyyy-MM-dd非长期有效时必填 最小长度:0 最大长度:10OutSubMerchantExtensionInfo选填object外部商户扩展信息,见下文说明微信、建行、通联、平安见证宝渠道必传 RegionCode选填string地区代码,国标码 最小长度:0 最大长度:8RegisterAddress选填string注册地址 最小长度:0 最大长度:200MailingAddress选填string通讯地址 最小长度:0 最大长度:200BusinessAddress选填string营业地址/经营地址建行、通联渠道必传 最小长度:0 最大长度:200ServicePhone选填string电话。微信、平安见证宝进件必传 最小长度:0 最大长度:20WebSiteUrl选填string网站url 最小长度:0 最大长度:200WebName选填string网站或者应用名称 最小长度:0 最大长度:100EmailAddress选填string邮箱地址。微信进件必填 最小长度:0 最大长度:200LegalPersonInfo必填object商户法人代表信息,见下文说明 IdType必填string证件类型IDCARD:身份证PASSPORT:护照 SOLDIERSCERTIFICATE:士兵证 OFFICERSCERTIFICATE:军官证 GATXCERTIFICATE:香港居民来往内地通行证 TWNDCERTIFICATE:台湾同胞来往内地通行证 MACAOCERTIFICATE:澳门来往内地通行证 最小长度:0 最大长度:32IdNumber必填string证件号码 最小长度:0 最大长度:32PersonName必填string姓名 最小长度:0 最大长度:80IdValidityType必填string证件有效期类型 LONGTERM:长期有效 OTHER:非长期有效 最小长度:0 最大长度:32IdEffectiveDate必填string证件生效日期,yyyy-MM-dd 最小长度:0 最大长度:10IdExpireDate选填string证件失效日期,yyyy-MM-dd非长期有效则必填 最小长度:0 最大长度:10ContactPhone选填string联系电话 最小长度:0 最大长度:20ContactAddress选填string联系地址 最小长度:0 最大长度:200Nationality选填string国籍,例如:中国 最小长度:0 最大长度:20Sex选填string性别 1:男 2:女 最小长度:0 最大长度:1Occupation选填string职业1:国家机关、党群组织、企业、事业单位人员;2:专业技术人员;3:办事人员和有关人员;4:商业、服务业人员;5:农、林、牧、渔、水利业生产人员;6:生产、运输设备操作人员及有关人员;7:军人;8:其他。 最小长度:0 最大长度:2EmailAddress选填string邮箱 IdAddress选填string身份证地址 NaturalPersonList选填array相关自然人信息列表,见下文说明 数组子类型:objectPersonType必填string自然人类型 2:商户负责人 3:授权经办人4:业务联系人 5:实际控制人 6:控股股东 7:受益人 8:结算人 最小长度:0 最大长度:2IdType必填string证件类型IDCARD:身份证PASSPORT:护照 SOLDIERSCERTIFICATE:士兵证 OFFICERSCERTIFICATE:军官证 GATXCERTIFICATE:香港居民来往内地通行证 TWNDCERTIFICATE:台湾同胞来往内地通行证 MACAOCERTIFICATE:澳门来往内地通行证 最小长度:0 最大长度:32IdNumber必填string证件号码 最小长度:0 最大长度:32PersonName必填string姓名 最小长度:0 最大长度:80IdValidityType必填string证件有效期类型 LONGTERM:长期有效 OTHER:非长期有效 最小长度:0 最大长度:32IdEffectiveDate必填string证件生效日期,yyyy-MM-dd 最小长度:0 最大长度:10IdExpireDate选填string证件失效日期,yyyy-MM-dd非长期有效则必填 最小长度:0 最大长度:10ContactPhone选填string联系电话 最小长度:0 最大长度:20ContactAddress选填string联系地址 最小长度:0 最大长度:200EmailAddress选填string邮箱地址 最小长度:0 最大长度:200SettleInfo选填object商户结算信息,见下文说明建行、通联渠道必传 SettleAccountType选填string结算账户类型 PRIVATE:对私 BUSINESS:对公建行、通联渠道必传 最小长度:0 最大长度:32SettleAccountNumber选填string结算账号建行、通联渠道必传 最小长度:0 最大长度:32SettleAccountName选填string结算账户名称建行、通联渠道必传 最小长度:0 最大长度:200BankBranchId选填string支行号 最小长度:0 最大长度:32BankBranchName选填string支行名称建行、通联渠道必传 最小长度:0 最大长度:200BankCode选填string所属银行 最小长度:0 最大长度:32AccountFoldType选填string卡折类型,00-借记卡 01-存折通联渠道默认00 SettleMode选填string结算方式 AUTO:自动结算 SELF:自主结算 最小长度:0 最大长度:32SettlePeriod选填string结算周期 T1:工作日隔天结算 D1:自然日隔天结算 D0:当日结算。 最小长度:0 最大长度:12AddressCode选填string银行所在省市编码。微信进件必填。可通过http://xzqh.mca.gov.cn/defaultQuery 查询 SalesInfo选填object经营场景信息,微信渠道需传入此信息 SalesScenesType选填array场所类型。SALES_SCENES_STORE:线下场所 SALES_SCENES_MP:公众号 SALES_SCENES_MINI_PROGRAM:小程序 SALES_SCENES_WEB:互联网网站 SALES_SCENES_APP:App SALES_SCENES_WEWORK:企业微信 数组子类型:stringBizStoreInfo选填object线下场所,如果场景类型包含该场景需传入该字段 BizAddressCode选填string线下场所省市编码。可通过http://xzqh.mca.gov.cn/defaultQuery 查询 BizStoreAddress选填string线下场所地址 BizSubAppid选填stringBizStoreName选填string线下场所名称 MpInfo选填object公众号场景,如果场景类型包含该场景需传入该字段 MpAppid选填string服务商公众号AppID MpSubAppid选填string商家公众号AppID MiniProgramInfo选填object小程序场景,如果场景类型包含该场景需传入该字段 MiniProgramAppid选填string服务商小程序APPID MiniProgramSubAppid选填string商家小程序APPID AppInfo选填objectapp场景,如果场景类型包含该场景需传入该字段 AppAppid选填string服务商应用APPID AppSubAppid选填string商家应用APPID WebInfo选填object互联网网站场景,,如果场景类型包含该场景需传入该字段 Domain选填string互联网网站域名 WebAppid选填string互联网网站对应的商家APPID WeworkInfo选填object企业微信场景,,如果场景类型包含该场景需传入该字段 CorpId选填string商家企业微信CorpID CredentialFiles选填array资质文件列表资质类型,枚举值 数组子类型:objectCredentialType选填string资质类型枚举值 最小长度:0 最大长度:32FileType选填string文件类型。建行:文件限制PNG/JPG/ZIP格式 最小长度:0 最大长度:32CredentialToken选填string文件token码(渠道上传码)。通过文件上传接口获取。渠道文件链接和token码二选一。通联渠道请先上传资质文件,传入响应体中的ChannelApplyId作为CredentialToken 最小长度:0 最大长度:64CredentialUrl选填string客户自己的资质文件的公网下载url,若没有,可调用资质文件上传接口拿到token并传入token 最小长度:0 最大长度:3000InterConnectionSubMerchantData选填string子商户进件扩展信息,转义后的json字符串,见渠道特殊说明 Action必填string公共参数。本接口取值:CreateOpenBankOnlineAsyncAggregatedSubMerchantRegistration MerchantRole选填array平安见证宝必传。如果在后续调用分账接口时作为分账接收方需传入["MERCHANT","PAYEE"],否则传入["MERCHANT"] 数组子类型:string请求示例{ "Action": "CreateOpenBankOnlineAsyncAggregatedSubMerchantRegistration", "OutRegistrationNo": "leonarzhang20240117014", "ChannelMerchantId": "CM453726390617904511", "OutSubMerchantId": "OM20240117001", "ChannelName": "WECHAT", "StallNumber": "leonarxxx测试", "OutSubMerchantType": "INDIVIDUALBISS", "OutSubMerchantName": "深圳市龙岗区平湖信华烟酒行1", "ThirdSubMerchantId": "", "OutSubMerchantShortName": "平湖信华烟酒行1", "NotifyUrl": "http://127.0.0.2:8661/merchant/inner/notifyRegistration", "BusinessLicenseInfo": { "BusinessLicenseType": "CREDITCODE", "BusinessLicenseNumber": "92440300L608515047", "BusinessLicenseValidityType": "OTHER", "BusinessLicenseEffectiveDate": "2013-01-16", "BusinessLicenseExpireDate": "2033-01-16" }, "OutSubMerchantExtensionInfo": { "RegionCode": "440302", "RegisterAddress": "深圳市-龙岗区", "MailingAddress": "深圳市龙岗区平湖街道白坭坑社区丹农路1号深圳海吉星国际农产品物流园C2036", "BusinessAddress": "深圳市龙岗区平湖街道白坭坑社区丹农路1号深圳海吉星国际农产品物流园C2036", "WebSiteUrl": "http://www.merchant.com", "WebName": "webname", "EmailAddress": "[email protected]", "ServicePhone": "17620150000", "ContactMail": "[email protected]" }, "LegalPersonInfo": { "IdType": "IDCARD", "IdNumber": "441423199001010000", "PersonName": "张先生", "IdValidityType": "OTHER", "IdEffectiveDate": "2013-01-16", "IdExpireDate": "2033-01-16", "ContactPhone": "17620150000", "ContactAddress": "广东省惠来县葵潭镇新联管区余家寮糖间内38号" }, "SalesInfo": { "SalesScenesType": [ "SALES_SCENES_STORE" ], "BizStoreInfo": { "BizStoreName": "奶茶店", "BizAddressCode": "110101", "BizStoreAddress": "腾讯大厦", "BizSubAppid": "" } }, "NaturalPersonList": [ { "IdType": "IDCARD", "IdNumber": "441423199001010000", "PersonName": "张先生", "PersonType": "4", "IdValidityType": "OTHER", "IdEffectiveDate": "2013-01-16", "IdExpireDate": "2033-01-16", "ContactPhone": "17620150000", "ContactAddress": "广东省惠来县葵潭镇新联管区余家寮糖间内38号" } ], "SettleInfo": { "BankBranchId": "403584001102", "BankBranchName": "中国邮政储蓄银行股份有限公司深圳福田区支行", "SettleAccountName": "张先生", "SettleAccountNumber": "923829739723730000", "SettleAccountType": "PRIVATE", "SettleMode": "AUTO", "SettlePeriod": "T1", "AddressCode": "440304" }, "CredentialFiles": [ { "CredentialType": "006", "FileType": "jpg", "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png" }, { "CredentialType": "005", "FileType": "jpg", "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png" }, { "CredentialType": "008", "FileType": "jpg", "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png" }, { "CredentialType": "009", "FileType": "jpg", "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png" }, { "CredentialType": "014", "FileType": "jpg", "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png" }, { "CredentialType": "002", "FileType": "jpg", "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png" }, { "CredentialType": "032", "FileType": "jpg", "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png" } ], "InterConnectionSubMerchantData": "{\"MccId\":\"5399\"}" } InterConnectionSubMerchantData 结构 ChannelName = ALLINPAY 时 参数名称类型必选描述MccIdString是商户行业类别码。枚举值StoresArray否门店列表+StoreNameString是门店名称PayProductsArray是支付产品信息列表+PayTypeString是支付类型。SWIPE:被扫(B扫C),SCAN:扫码(C扫B),PUBLIC:公众号支付,MINI_PROGRAM:小程序。注意:通联渠道传SWIPE、SCAN、PUBLIC+PayChannelString是支付渠道ALIPAY:支付宝WXPAY:微信支付UNIONPAY:银联+FeeRateString是费率,百分之n,例如3.5代表百分之3.5。BusdetailString是经营内容TaxdetailObject否税务登记详情:在商户性质为企业,选择非三证合一时,税务登记证信息必填+TaxRegCodeString是税务登记号码+TaxCodeExpireString是税务登记证日期+TaxCodePicString是税务登记证照片 ChannelName = WECHAT 时 参数名称类型必选描述MccIdString是商户行业类别码。枚举值 ChannelName = PINGANJZB 时 参数名称类型必选描述IpAddressString是用户ip地址MacAddressString是用户mac地址 返回参数 Response200 OKResponse选填objectRequestId选填string请求id Result选填objectRegistrationStatus必填string进件状态。进件基本状态,可依赖此字段做业务逻辑处理。SUCCESS: 进件成功FAILED: 进件失败PROCESSING: 进件中INIT: 已受理 (待发起)CLOSED:已关闭注意:若返回进件中或者已受理,需要再次调用进件结果查询接口,查询结果。 RegistrationMessage选填string进件返回描述 RegistrationDetailState必填string进件详细状态,渠道的具体进件状态,可参考此字段做辅助判断。INIT: 待发起申请FAILED: 申请失败PROCESSING: 申请成功UN_CHECK:待审核CHECK_FAILED:审核失败UN_SIGN:待签约SIGN_FAILED:签约失败UN_EFFECT:审核成功(待生效)SUCCESS: 进件成功CLOSED:已关闭 ChannelRegistrationNo必填string进件序列号 ChannelSubMerchantId必填string商户ID ThirdMerchantId选填string合作渠道商户号 ExternalReturnData选填string合作渠道返回信息,见渠道特殊说明 Stores选填array数组子类型:objectStoreId选填string门店ID StoreName选填string门店名称 StaticPictureKey选填string静态码key值 SmsSendStatus必填string进件签约短信下发状态(针对平台进行下发的场景例如建行,无需平台下发的默认成功)SUCCESS:短信下发执行成功FAILED:短信下发执行失败 SmsSendFailedMessage选填string腾讯云短信服务下发短信失败原因描述 ErrCode选填string错误码 ErrMessage选填string错误信息 返回示例{ "Response": { "RequestId": "a998b5a0486843bcb4863df0559df97c", "Result": { "ChannelRegistrationNo": "496542238168324474", "ChannelSubMerchantId": "CM496518091627370848", "ExternalReturnData": "", "RegistrationMessage": "已受理", "RegistrationStatus": "INIT", "Stores": [ { "StaticPictureKey": "/wecardpay/merchant/allinpay/staticqrcode/qr1682021751-539B5E14DA3944ABA5AB80E14EE204B5.jpg", "StoreId": "CM4965180916273708480001", "StoreName": "平湖信华烟酒行1", "ContractName": "", "ContractPhone": "", "EnableFlag": 0, "StallNumber": "leonarzhang测试" } ], "RegistrationDetailState": "", "SmsSendStatus": "", "SmsSendFailedMessage": "", "AccountId": "" }, "ErrCode": "SUCCESS", "ErrMessage": "成功" } } 响应状态码 状态码描述SUCCESS成功MERCHANT.DATA_NOT_EXIST商户不存在MERCHANT.INVALID_PARAMETER参数错误MERCHANT.MISSING_PARAMETER缺少参数错误MERCHANT.SYSTEM_ERROR系统错误MERCHANT.DUPLICATE_ENTRY重复进件 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |