Create

Request address

POST

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

Test account

Merchant ID：10010

ApiKey: 7e4nicn14nhyup146dfbi8hpnpus9juz

Request headers

Header Name	Header Value
Agent-Merchant-Id	10010

Request parameters

Parameter Name	Type	Required	Sign(Y OR N)	Parameter Description
memberid	String	Y	Y	Merchant ID
id_number	String	Y	Y	Identity number of the person.
first_name	String	Y	Y	First name of the person.
last_name	String	Y	Y	Last name of the person.
birthday	String	Y	Y	Date of birth of the person.
phone	String	Y	Y	Phone number of the person.
percent_ownership	String	Y	Y	Percentage of ownership of the company.
cert_issue_date	String	Y	Y	Date when the person’s identity document was issued.
cert_expire_date	String	N	N	Date when the person’s identity document expires.
address	Array	Y	N	Address of the person.
title	String	N	N	Title of the person. Such as CEO.
document	Array	Y	N	Documents that may be submitted to satisfy various informational requests.
sign	String	Y	N	Please see the verification signature field format

Address

Parameter Name	Type	Required	Sign(Y OR N)	Parameter Description
country	String	Y	N	Country code.
state	String	Y	N	State, county, province, or region(ISO 3166-2)
city	String	Y	N	City.
line1	String	Y	N	Address line 1.
line2	String	N	N	Address line 2.
postal_code	String	Y	N	ZIP or postal code.

Documents

File ID collection, Upload files

Parameter Name	Type	Required	Sign(Y OR N)	Parameter Description
company_authorization	Array	Y	N	One or more documents that demonstrate proof that this person is authorized to represent the company.
passport	Array	Y	N	One or more documents showing the person’s passport page with photo and personal data.
passport_handing	Array	Y	N	One or more documents showing the person holding a passport photo

Response Parameters

Parameter Name	Type	Parameter Description
status	String	Status of the request success:Successful error:Fail
msg	String	Message of the request
data	Array	Response data
data.id	Integer	Merchant Person ID

Demo

Javascript

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

const KEY = "7e4nicn14nhyup146dfbi8hpnpus9juz";
const MEMBER_ID = "10010";
let query = {
  memberid: '10304',
  id_number: '000000000',
  first_name: 'fred',
  last_name: 'flintstone',
  birthday: '1990-01-01',
  phone: '1234567890',
  cert_issue_date: '2020-01-01',
  percent_ownership: '100',
};
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(),
  address: {
    country: 'US',
    state: "CA",
    city: "San Francisco",
    line1: "123 Main St",
    postal_code: "94102",
  },
  documents: {
    company_authorization: [1,2,3],
    passport: [3],
    passport_handing: [3],
  },
});

axios
  .request({
    url: "https://sandbox.j-pay.net/pay/merchant_person/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...