创建商户

请求地址

POST

https://sandbox.j-pay.net/pay/merchant/create

测试账号

商户ID：10010

ApiKey: 7e4nicn14nhyup146dfbi8hpnpus9juz

请求头

请求头名称	请求头值
Agent-Merchant-Id	10010

请求参数

参数名称	类型	是否必填	参与签名	参数说明
email	String	Y	Y	商户邮箱
country	String	Y	Y	国家,是一个ISO 3166-1 alpha-2国家代码
company	Array	Y	N	关于公司或业务的信息。
business_profile	Array	N	N	关于商户账户的业务信息。
bank	Array	N	N	结算账户信息
persons	ArrayList	N	N	法人信息
sign	String	Y	N	请参阅验证签名字段格式

Company

参数名称	类型	是否必填	参与签名	参数说明
name	String	Y	N	公司名称.
tax_id	String	N	N	企业证件号码。
phone	String	N	N	公司的电话号码。
state	String	N	N	国家的州、县、省或区域(ISO 3166-2)
city	String	N	N	城市.
line1	String	N	N	地址行1.
line2	String	N	N	地址行2.
postal_code	String	N	N	ZIP或邮政编码。
cert_valid_date	String	N	N	证件有效期，格式为YYYY-MM-DD。
cert_past_date	String	N	N	证件过期日期，格式为YYYY-MM-DD, 不传或为空时，则长期有效。

Business Profile

参数名称	类型	是否必填	参与签名	参数说明
mcc	String	Y	N	商户分类代码。例如：7372表示在线购物。
url	String	Y	N	商户的公开网站。例如：google.com

Documents

File ID collection, Upload files

Parameter Name	Type	Required	Sign(Y OR N)	Parameter Description
company_registration	Array	Y	N	一份或多份文件，证明公司已在相关地方当局注册。(公司注册证书)
company_address	Array	Y	N	一份或多份文件，证明公司地址。(经营地址证明)
company_moa	Array	Y	N	一份或多份文件，证明公司的协会声明。(公司章程)
bank_proof	Array	Y	N	一份或多份文件，证明公司的银行账户。(比如水电账单、银行流水之类的)

Bank Account

参数名称	类型	是否必填	参与签名	参数说明
type	Enum	Y	Y	结算账户类型： china: 仅结算人名币 other: 含港澳台
bank_name	String	Y	Y	银行名称
account	String	Y	Y	结算账户号（不包含授权收款账户）
subbranch	String	N	N	分行名称
address	String	N	N	银行地址
swift_code	String	N	N	SWIFT code, type为other时必填
remark	String	N	N	备注

Persons

参数名称	类型	是否必填	参与签名	参数说明
id_number	String	N	N	个人证件号码
first_name	String	N	N	个人名
last_name	String	N	N	个人姓
birthday	String	N	N	个人出生日期
phone	String	N	N	个人手机号
percent_ownership	String	N	N	公司资产占比，取值范围0-100，单位%
cert_issue_date	String	N	N	个人证件Issue日期
cert_expire_date	String	N	N	个人证件过期日期,不传或为空则为长期有效
address	Array	N	N	个人地址
title	String	N	N	个人职务, 例如CEO
document	Array	N	N	个人证件, 例如公司授权书, 护照等, 请参考上传文件

返回参数

参数名称	类型	参数说明
code	String	请求状态 1:成功 0:失败
info	String	请求消息
data	Array	响应数据
data.id	Integer	商户ID
data.bank_id	String	银行账户ID
data.person_ids	Array	员工ID列表

示例

Javascript

import { md5 } from "js-md5";
import axios from "axios";

const KEY = "7e4nicn14nhyup146dfbi8hpnpus9juz";
const MEMBER_ID = "10010";
let query = {
  email: Date.now().valueOf() + "@123.com",
  country: 'US',
};
let signData = [];
Object.keys(query)
  .sort()
  .forEach((key) => signData.push(`${key}=${query[key]}`));

signData.push(`key=${KEY}`);
Object.assign(query, {
  sign: md5(signData.join("&")).toUpperCase(),
  company: {
    name: Date.now().valueOf(),
    phone: "1234567890",
    tax_id: "000000000",
    city: "San Francisco",
    state: "CA",
    line1: "123 Main St",
    postal_code: "94102",
  },
  business_profile: {
    mcc: "7372",
    url: "nimiya.shop"
  },
  bank: {
    bank_name: 'ETH',
    account: '0000000000000000',
    type: 'other',
    swift_code: 'ETHBUSD',
  },
  persons: [
    {
      id_number: '000000000',
      first_name: 'fred',
      last_name: 'flintstone',
      birthday: '1990-01-01',
      phone: '1234567890',
      cert_issue_date: '2020-01-01',
      percent_ownership: '100',
      address: {
        country: 'US',
        state: "CA",
        city: "San Francisco",
        line1: "123 Main St",
        postal_code: "94102",
      },
      documents: {
        company_authorization: ['b97864b6ed8b4e1f94494c884f2b6d92'],
        passport: ['b97864b6ed8b4e1f94494c884f2b6d92'],
        passport_handing: ['b97864b6ed8b4e1f94494c884f2b6d92'],
      },
    },
  ],
});

axios
  .request({
    url: "https://sandbox.j-pay.net/pay/merchant/create",
    method: "post",
    headers: {
      "Agent-Merchant-Id": MEMBER_ID,
      "Content-Type": "application/x-www-form-urlencoded",
    },
    data: query,
  })
  .then(({ data }) => {
    console.log("success", data);
  })
  .catch((error) => {
    console.log("error", error);
  });

Php

Continuously updating...

Python

Continuously updating...