简要描述:

  • 企业入网

请求域名:

  • 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

备注: