KYB

KYB non file details submission

Allows users to submit a non file Know Your Business (KYB) data.

Allow user to retry submission also.

Know Your Business (KYB) form submission (non file submission).

POST https://integration.coinmena.com/onramp/api/v2/whiteLabel/kyb/submit

On submitting new KYB data createdAt time sent as in response and on resubmitting updatedAt time sent as in response.

Request Body

Name	Type	Description
entityName*	String	Name of Entity which will deal with CoinMena
tradingName	String	Does the entity have a trading name? If yes, please provide the trading name.
legalEntityNature*	String	What is the nature of the legal entity? (Limited Liability Company, Partnership etc.)
purposeOnOnramp*	String	What is the purpose of relationship with CoinMena? In other words, what is the intended use case of registering an account on CoinMena.
companyRegistrationNumber*	String	What is the company registration number?
registeredEntityAddress*	String	What is the registered address of the entity?
operationalAddressOfEntity*	String	Operational address of the entity? Please provide the address proof of the operational address.
companyTaxId*	String	What is the tax ID the company
ownershipDetailsAndControlStructure*	String	Details of ownership and control structure
sourceOfFund*	String	Source of funds
natureOfBusiness*	String	Nature of Business
customerId*	String	customerId returned from /kyc/url
submissionId	String	to retry submission (id received from webhook or /kyb/status)
uboDetails*	String	Provide the following information related to the Ultimate Beneficial Owners ("UBOs"): 1. Name of UBO, 2. Nationality of UBO, 3. Date of Birth (dd/mm/yyyy), 4. Residence of UBO, 5. Passport Number/National Identity Card Number, 6. Validity of Passport/National Identity Card, 7. Percentage of shareholding.
directorsDetails*	String	Please provide the following information for the company's Directors: Name of Directors, Nationality of Directors, Date of Birth (dd/mm/yyyy), Residence of Directors, Passport Number/National Identity Card Number, Validity of Passport/National Identity Card.
companyRepDetails*	String	Please consolidate copies of the following documents and attach it in the form of a zip file.Please consolidate copies of the following documents and attach it in the form of a zip file. If any of the following documents are not in English, please provide a translated copy along with the original copy. Please ensure that the attached documents are clear, coloured scans of the original documents: 1. Authorised person's passport/ National Identity Card , 2. . Authorised person's proof of address. The proof of address means any utility bill or bank statement. The proof of address shall not be more than 3 months old.

Name

Type

Description

entityName*

String

Name of Entity which will deal with CoinMena

tradingName

String

Does the entity have a trading name? If yes, please provide the trading name.

legalEntityNature*

String

What is the nature of the legal entity? (Limited Liability Company, Partnership etc.)

purposeOnOnramp*

String

What is the purpose of relationship with CoinMena? In other words, what is the intended use case of registering an account on CoinMena.

companyRegistrationNumber*

String

What is the company registration number?

registeredEntityAddress*

String

What is the registered address of the entity?

operationalAddressOfEntity*

String

Operational address of the entity? Please provide the address proof of the operational address.

companyTaxId*

String

What is the tax ID the company

ownershipDetailsAndControlStructure*

String

Details of ownership and control structure

sourceOfFund*

String

Source of funds

natureOfBusiness*

String

Nature of Business

customerId*

String

customerId returned from /kyc/url

submissionId

String

to retry submission (id received from webhook or /kyb/status)

uboDetails*

String

Provide the following information related to the Ultimate Beneficial Owners ("UBOs"): 1. Name of UBO, 2. Nationality of UBO, 3. Date of Birth (dd/mm/yyyy), 4. Residence of UBO, 5. Passport Number/National Identity Card Number, 6. Validity of Passport/National Identity Card, 7. Percentage of shareholding.

directorsDetails*

String

Please provide the following information for the company's Directors: Name of Directors, Nationality of Directors, Date of Birth (dd/mm/yyyy), Residence of Directors, Passport Number/National Identity Card Number, Validity of Passport/National Identity Card.

companyRepDetails*

String

Please consolidate copies of the following documents and attach it in the form of a zip file.Please consolidate copies of the following documents and attach it in the form of a zip file. If any of the following documents are not in English, please provide a translated copy along with the original copy. Please ensure that the attached documents are clear, coloured scans of the original documents: 1. Authorised person's passport/ National Identity Card , 2. . Authorised person's proof of address. The proof of address means any utility bill or bank statement. The proof of address shall not be more than 3 months old.

Send all documents and parameters in the form-data format.

{
    "status": 1,
    "code": 200,
    "data": {
        "submissionId": "vwL8su0HHL_30",
        "createdAt": "2023-10-06T12:20:22.000Z"
    }
}

{
        "status": 0,
        "error": "Missing required parameter(s): entityName, submissionId etc",
        "code": 400,
 }

{
      "status": 0,
      "code": 500,
      "error":"Unable to send kybRequirements. Please try again after some time.",
}

    "status": 1,
    "code": 200,
    "data": {
        "submissionId": "vwL8su0HHL_30",
        "createdAt": "2023-10-06T12:20:22.000Z"
    }
}

PreviousKYC Integration Guide NextKYB Requirements

Last updated 5 months ago