PATCH /api/v1/personal_information
Update Personal Information

Update the fields of an existing personal information record for the onboarding live application of the currently authenticated merchant.

betaThis API is a pre-release. Please contact KOMOJU to obtain more usage instructions before using it.

Examples

  • cURL
  • Node.js
  • Ruby
curl -X PATCH https://komoju.com/api/v1/live_application/personal_information \
  -u sk_123456: \
  -d "representative_first_name=I%20am%20changing%20this%20in%20this%20request" 
var querystring = require('querystring');
var https = require('https');
var secret_key = 'sk_123456'
var auth = 'Basic ' + Buffer.from(secret_key + ':').toString('base64');
var patch_data = querystring.stringify({
  'representative_first_name': 'I am changing this in this request'
});

var patch_options = {
  host: 'komoju.com',
  port: '443',
  path: '/api/v1/live_application/personal_information',
  method: 'PATCH',
  headers: {
    'Authorization': auth,
    'Content-Length': Buffer.byteLength(patch_data)
  }
};

var patch_req = https.request(patch_options, function(res) {
    res.setEncoding('utf8');
    res.on('data', function (chunk) {
        console.log(chunk);
    });
});

patch_req.write(patch_data);
patch_req.end();
require 'uri'
require 'net/https'
require 'json'
require 'base64'
require 'pp'
uri = URI.parse('https://komoju.com/api/v1/live_application/personal_information')
https = Net::HTTP.new(uri.host, uri.port)
https.use_ssl = true
secret_key = 'sk_123456'
auth = Base64.encode64("#{secret_key}:")
headers = {
  'Content-Type' => 'application/json',
  'Authorization' => "Basic #{auth}"
}

body = {
  representative_first_name: "I am changing this in this request"
}

res = https.patch(
  uri.path,
  body.to_json,
  headers
)

puts res.body
{
  "resource": "personal_information",
  "status": "pending",
  "created_at": "2021-03-03T11:10:30.000+09:00",
  "updated_at": "2021-03-03T11:10:32.000+09:00",
  "representative_first_name": "I am changing this in this request",
  "representative_first_name_kana": "ハナコ",
  "representative_last_name": "古茂樹",
  "representative_last_name_kana": "コモジュ",
  "representative_dob": "2020-08-02",
  "representative_gender": "female",
  "representative_country": "JP",
  "representative_postal_code": "1000003",
  "representative_prefecture_state": "東京",
  "representative_prefecture_state_kana": "トウキョウ",
  "representative_city": "千代田区",
  "representative_city_kana": "チヨダク",
  "representative_address": "一ツ橋1-222-30",
  "representative_address_kana": "ヒトツバシ1-222-30",
  "representative_address_building_name": "古茂樹ビル8F",
  "representative_address_building_name_kana": "コモジュビル8F",
  "representative_phone": "03-9999-9999"
}

Params

Param name Description
representative_first_name
optional

First name of the Representative Director

representative_first_name_kana
optional

First name (represented in Japanese kana) of the Representative Director

representative_last_name
optional

Last name of the Representative Director

representative_last_name_kana
optional

Last name (represented in Japanese kana) of the Representative Director

representative_dob
optional

Date of birth of the Representative Director

representative_gender
optional

Gender of the Representative Director

representative_country
optional

The country of the Representative Director - Residence Address

representative_postal_code
optional

The postal code of the Representative Director - Residence Address

representative_prefecture_state
optional

The prefecture or state of the Representative Director - Residence Address

representative_city
optional

The city of the Representative Director - Residence Address

representative_address
optional

The address of the Representative Director - Residence Address

representative_address_kana
optional

The address represented in Japanese kana of the Representative Director - Residence Address

representative_phone
optional

The phone of the Representative Director - Residence Address

identity_front
optional

A file ID returned by the the File API. Please upload, via the File API, a picture or scan of the front side of a government issued photo ID document (passport, residence card, or driver's license). Ensure the information is clearly displayed. For passports, the front side is sufficient.

identity_back
optional

A file ID returned by the the File API. Please upload, via the File API, a picture or scan of the back side of a government issued photo ID document (passport, residence card, or driver's license). Ensure the information is clearly displayed. For passports, the front side is sufficient.