Live Application: Update

patch

https://komoju.com/api/v1/live_application/{merchant_id}

Updates the live application for the applicant merchant

Path Params

merchant_id

string

required

length between 25 and 25

A unique 25-character alphanumeric resource identifier.

Body Params

locale

string

enum

For supported payment methods, sets the language of the instruction page.

Allowed:

service_agreement.agreed_to_tos

boolean

Whether the merchant has agreed to KOMOJU's terms of service.

company_information.company_name

string

Registered legal name of the company.

company_information.company_phone

string

Company contact phone number.

company_information.company_country

string

enum

company_information.corporation_type

string

enum

Whether the business is a sole proprietorship or corporation.

Allowed:

company_information.company_postal_code

string

Postal code of the company's registered address.

company_information.company_prefecture_state

string

Prefecture or state of the company's registered address.

company_information.company_prefecture_state_kana

string

Prefecture or state in katakana.

company_information.company_city

string

City of the company's registered address.

company_information.company_city_kana

string

City name in katakana.

company_information.company_address

string

Street address of the company.

company_information.industry_description

string

Description of the industry the company operates in.

company_information.business_description

string

Description of the company's business activities and products/services sold.

company_information.employee_number

string

Number of employees at the company.

company_information.establishment_date

string

Date the company was established (YYYY-MM-DD format).

company_information.office_name

string

Name of the specific office or branch.

company_information.contact_email

string

Primary contact email address for the company.

company_information.contact_phone

string

Primary contact phone number for the company.

company_information.incorporation_certificates

array of strings

File IDs of uploaded incorporation certificate documents.

company_information.incorporation_certificates

company_information.registration_number

string

Company registration number.

company_information.share_capital_amount

int32

≥ 0

Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).

company_information.share_capital_currency

string

enum

3-letter ISO currency code.

company_information.sole_proprietor_proofs

array of strings

File IDs of uploaded sole proprietorship proof documents.

company_information.sole_proprietor_proofs

company_information.company_name_kana

string

Company name in katakana.

company_information.company_name_alphabet

string

Company name in alphanumeric (Roman) characters.

company_information.company_url

string

URL of the company's website.

company_information.company_address_kana

string

Street address in katakana.

company_information.company_address_building_name

string

Building name portion of the company address.

company_information.company_address_building_name_kana

string

Building name in katakana.

representative_director_information.first_name

string

Representative director's first name.

representative_director_information.first_name_kana

string

Representative director's first name in katakana.

representative_director_information.last_name

string

Representative director's last name.

representative_director_information.last_name_kana

string

Representative director's last name in katakana.

representative_director_information.date_of_birth

string

Representative director's date of birth (YYYY-MM-DD format).

representative_director_information.gender

string

enum

Representative director's gender.

Allowed:

representative_director_information.country

string

enum

representative_director_information.postal_code

string

Postal code of the representative director's address.

representative_director_information.prefecture_state

string

Prefecture or state of the representative director's address.

representative_director_information.prefecture_state_kana

string

Prefecture or state in katakana.

representative_director_information.city

string

City of the representative director's address.

representative_director_information.city_kana

string

City name in katakana.

representative_director_information.address

string

Street address of the representative director.

representative_director_information.address_kana

string

Street address in katakana.

representative_director_information.address_building_name

string

Building name portion of the representative director's address.

representative_director_information.address_building_name_kana

string

Building name in katakana.

representative_director_information.phone

string

Representative director's phone number.

applicant_information.first_name

string

Applicant's first name.

applicant_information.first_name_kana

string

Applicant's first name in katakana.

applicant_information.last_name

string

Applicant's last name.

applicant_information.last_name_kana

string

Applicant's last name in katakana.

applicant_information.country

string

enum

applicant_information.gender

string

enum

Applicant's gender.

Allowed:

applicant_information.date_of_birth

string

Applicant's date of birth (YYYY-MM-DD format).

applicant_information.identity_document_type

string

enum

Type of identity document submitted for verification.

Allowed:

applicant_information.identity_front

string

File ID of the front side of the uploaded identity document.

applicant_information.identity_back

string

File ID of the back side of the uploaded identity document.

site_information.site_name

string

Name of the merchant's website or online store.

site_information.site_name_kana

string

Site name in katakana.

site_information.site_name_alphabet

string

Site name in alphanumeric (Roman) characters.

site_information.site_url

string

URL of the merchant's online store.

site_information.establishment_date

string

Date the online store was established (YYYY-MM-DD format).

site_information.store_country

string

enum

site_information.store_postal_code

string

Postal code of the store's physical location.

site_information.store_prefecture_state

string

Prefecture or state of the store's physical location.

site_information.store_prefecture_state_kana

string

Prefecture or state in katakana.

site_information.store_city

string

City of the store's physical location.

site_information.store_city_kana

string

City name in katakana.

site_information.store_address

string

Street address of the store's physical location.

site_information.store_address_kana

string

Store street address in katakana.

site_information.store_building_name

string

Building name for the store's address.

site_information.store_building_name_kana

string

Building name in katakana.

site_information.site_product_description

string

Description of the products or services sold on the site.

site_information.site_annual_sales

int32

≥ 0

Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).

site_information.site_annual_sales_currency

string

enum

3-letter ISO currency code.

site_information.site_average_transactional_value

string

Average transaction value as a formatted string.

site_information.site_average_transactional_currency

string

enum

3-letter ISO currency code.

site_information.site_minimum_product_pricing_cents

int32

≥ 0

Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).

site_information.site_minimum_product_pricing_currency

string

enum

3-letter ISO currency code.

site_information.site_maximum_product_pricing_cents

int32

≥ 0

Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).

site_information.site_maximum_product_pricing_currency

string

enum

3-letter ISO currency code.

site_information.sctl_url

string

URL of the merchant's Specified Commercial Transaction Law disclosure page.

site_information.sales_permit_required

boolean

Whether a sales permit is required for the merchant's business type.

site_information.aup_accepted

boolean

Whether the merchant has accepted the Acceptable Use Policy.

site_information.industry_type

string

enum

site_information.sales_permits

array of strings

File IDs of uploaded sales permit documents.

site_information.sales_permits

bank_account_information.zengin_bank_name

string

Name of the merchant's bank (Zengin network).

bank_account_information.zengin_bank_code

string

4-digit bank code in the Zengin network.

bank_account_information.zengin_branch_name

string

Name of the bank branch.

bank_account_information.zengin_branch_code

string

3-digit branch code.

bank_account_information.zengin_account_type

string

enum

Type of bank account (ordinary or checking).

Allowed:

bank_account_information.zengin_account_number

string

Bank account number.

bank_account_information.zengin_account_holder_kana

string

Account holder name in katakana as registered with the bank.

bank_account_information.transfer_type

string

enum

Type of bank transfer supported (currently only "domestic").

Allowed:

bank_account_information.currency

string

enum

3-letter ISO currency code.

bank_account_information.default_frequency

string

enum

Allowed:

Response

200Subsequent requests will specify errored fields or additional required fields