简要描述:
- 企业入网
请求域名:
- 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 |