简要描述:

  • 企业入网

请求域名:

  • http://xx.com

请求URL:

POST:plugin.yop-pay.api.merchant.create

参数:

参数名 是否必须 类型 说明
type 是 int 1:企业
merShortName 是 string 商户简称
legalName 是 string 法人姓名,请按照证件上的真实姓名准确填写
legalIdCard 是 string 法人身份证号
merLevel1No 是 int 商户分类一级
merLevel2No 是 int 商户分类二级
merProvince 是 int 所在城市省
merCity 是 int 所在城市市
merDistrict 是 int 所在城市区
merAddress 是 string 详细地址
cardNo 是 string 结算银行卡号 结算银行账号或者银行卡号
headBankCode 是 string 开户总行
bankProvince 是 string 开户行省
bankCity 是 string 开户行市
bankCode 是 string 开户支行
[info][IDCARD_FRONT] 是 string 法人身份证正面
[info][IDCARD_BACK] 是 string 法人身份证反面
merFullName 否 string 商户全称
merCertNo 是 string 证件号 所对应的证件类型的证件编号
merCertType 是 string 证件类型 UNI_CREDIT_CODE:统一社会信用代码证;CORP_CODE:营业执照
merContactName 是 string 商户联系人姓名
merContactPhone 是 string 商户联系人手机号
merContactEmail 否 string 商户联系人邮箱
taxRegistCert 否 string 税务登记证编号;签约类型为“企业”,且证件类型为“营业执照”,则必填
accountLicense 是 string 开户许可证编号
orgCode 否 string 组织机构代码证;签约类型为“企业”,且证件类型为“营业执照”,则必填
isOrgCodeLong 否 string 组织机构代码证是否长期有效 true:长期有效;false:非长期有效;证件类型为“营业执照”,则必填
orgCodeExpiry 否 string 组织机构代理证有效期;当企业需填写组织机构代码证号且组织机构代码证非永久有效时,须必填。格式:YYYY-MM-DD
[info][CORP_CODE] 是 string 营业执照 : 证件类型选择时显示
[info][UNI_CREDIT_CODE] 是 string 统一社会信用代码证 : 证件类型选择时显示
[info][TAX_CODE] 是 string 税务登记证
[info][ORG_CODE] 是 string 组织机构代码证
[info][OP_BANK_CODE] 是 string 银行开户许可证
localInfo 是 array 项目服务器图片存储地址,键名相同

返回示例:

正确时返回:

{
	"state": "SUCCESS",
	"result": {
		"returnMsg": "请求成功",
		"returnCode": "REG00000",
		"requestNo": "RT20181222102912126868",
		"externalId": "532319477549",
		"parentMerchantNo": "10025325695",
		"merchantNo": "10025947976"
	},
	"ts": 1545445756646,
	"sign": "t9M_QgNLw4ATilATK7G50DY-7cujARoCdxt7CprfP7BYLsJ2cftFEz_k7Cfy0Kk1eXCGRcgKl3w4SmxFOcUGuo0THagfz1xkweYyzpEiuvMHteGiyhviUJCuqzie4fNPrv7JTup86djHOxHNhrxvYdnSeA8XmxmrvuEEUzxXwhUKiVxm1E4ZIKPk_dr-h1Me2dsrnq6SB1QICT1SN0nN-DfDMuLTbLFEiZs4qdGwww6BtUk5y7dLS-dPlD3tTG6CE5U8PTA9wSIXixdsejtRaWl-W0StyMWm005oMjVrYvPkk-umUyGREuFa0VGbT4YSD7_TnaNLshZ7Zl_yTwvIwQ$SHA256",
	"error": null,
	"stringResult": "{\n    \"returnMsg\" : \"请求成功\",\n    \"returnCode\" : \"REG00000\",\n    \"requestNo\" : \"RT20181222102912126868\",\n    \"externalId\" : \"532319477549\",\n    \"parentMerchantNo\" : \"10025325695\",\n    \"merchantNo\" : \"10025947976\"\n  }",
	"format": "json",
	"validSign": true,
	"verSign": null
}

错误时返回:

{
    "state": "SUCCESS",
    "result": {
        "returnMsg": "开户银行支行编码 必填项,请填写",
        "returnCode": "REG30002",
        "requestNo": "RT20181221184339722288",
        "parentMerchantNo": "10025325695"
    },
    "ts": 1545389019474,
    "sign": "gEQGedKvDCO5xwVZIeKYUlFbSAkMs6pduB_WLkLSa146HdZ0YnLsQiBbNYmd7BDuVmn_vXIB0Y7yGkPNfC4MxVwWfJ7MPHLOR39kPCMWzYiDjsH0mdHoy3tQfygaFe1bLHkYIHMwhdd0bIlgd5RZuwXFzhBJ_SaC_HGP5ezSqbhKcI4M7VEAxgLaxGDR3wNdhlx9IHbcbGfJxr3SYNSna6GkjQOaTq7by1vpRJ1vQtfaD7acYqkX_bmjVJW6P317LyHcJkgOCX_WEsXd2ObeMPjfbb7u7hJvOl74BoeTePYgCjEdxdaS__oVjy6AetgTvBZDdVfBYv_G_JYEis2Lgw$SHA256",
    "error": null,
    "stringResult": "{\n    \"returnMsg\" : \"开户银行支行编码 必填项,请填写\",\n    \"returnCode\" : \"REG30002\",\n    \"requestNo\" : \"RT20181221184339722288\",\n    \"parentMerchantNo\" : \"10025325695\"\n  }",
    "format": "json",
    "validSign": true,
    "verSign": null
}

返回参数说明:

参数名 类型 说明
returnCode int 状态码 成功 REG00000

备注: