Create Seller

Path

• URL: /cb-core/api/v1/seller/create
• Method: POST
• Description: This API allows registering new seller information into the Baokim system

Request

Request table

Params	Data Type	Required	Description
request_id	string(50)	Yes	Request ID from merchant. Format: MerchantCode + YYYYMMDDHHMMSS + UniqueId
request_time	string(19)	Yes	Request timestamp. Format: YYYY-MM-DD HH:MM:SS
merchant_code	string(20)	Yes	Merchant code provided by Baokim
sub_merchant_code	string(20)	Yes	Sub-merchant code. If seller belongs to merchant directly, fill in merchant_code
seller_id	string(50)	Yes	Seller ID in merchant system
seller_name	string(255)	Yes	Full name of seller
platform	array	Yes	Platform information
- type	string	Yes	Platform type: 1: Website 2: E-commerce Platform 3: B2B 4: Service 5: Other
- links	string(255)	Yes*	Platform URL (*Required if type is 1 or 2)
- platform_seller_id	string(255)	Yes*	Seller ID on platform (*Required if type is 2)
files	array	Yes	Document files (maximum 15 files)
- type	string	Yes	File type: 1: Business License 2: ID Card/Passport/Visa 3: Contract 4: Bank Statement 5: Other
- file	file	Yes	File upload (jpg, jpeg, png, pdf, max: 2MB)
representative_DOB	string	Yes	Representative's date of birth (Format: YYYY-MM-DD)
representative_ID_number	string(255)	Yes	Representative's ID number
representative_name	string(255)	Yes	Representative's full name
representative_nationality	string(255)	Yes	Representative's nationality
representative_address	string(255)	No	Representative's address
seller_business_type	string	Yes	Business type: 1: Enterprise 2: Household 3: Individual
seller_business_registration_no	string(255)	Yes*	Business registration number (*Required if business_type is 1 or 2)
seller_phone	string	No	Contact phone number
seller_email	string	No	Contact email (must be valid email format)
seller_business_description	string(255)	Yes	Business description
seller_risk_level	string	Yes	Risk level: 1: Low 2: Medium 3: High
gc_code	string(10)	Yes	Group Category code (must exist in system) Dowload excel
mcc_code	string(10)	Yes	Merchant Category Code (must exist in system) Dowload excel

Request Example

{
    "request_id": "MERCHANT12345678901234510281",
    "request_time": "2024-11-15 14:36:00",
    "merchant_code": "MERCHANT001",
    "sub_merchant_code": "MERCHANT001",
    "seller_id": "SELLER123456",
    "seller_name": "Nguyễn Văn A",
    "platform": [
        {
            "type": "2",
            "links": "https://shopee.vn/seller123",
            "platform_seller_id": "SHOPEE123456"
        }
    ],
    "files": [
        {
            "type": "1",
            "file": "[binary file data]"
        },
        {
            "type": "2",
            "file": "[binary file data]"
        }
    ],
    "representative_DOB": "1990-01-01",
    "representative_ID_number": "001099012345",
    "representative_name": "Nguyen Van A",
    "representative_nationality": "Vietnam",
    "representative_address": "1 Dai Co Viet Street, Hai Ba Trung District, Ha Noi",
    "seller_business_type": "2",
    "seller_business_registration_no": "0123456789",
    "seller_phone": "0912345678",
    "seller_email": "[email protected]",
    "seller_business_description": "Online retail store selling electronics",
    "seller_risk_level": "1",
    "gc_code": "5045",
    "mcc_code": "5399"
}

Response

Response table

Params	Data Type	Description
response_code	int	Response code from Baokim
response_message	string(255)	Response description
merchant_code	string(20)	Merchant code
seller_id	string(50)	Seller ID
status	int	Seller status: 1: Processing

Response Example

{
    "response_code": 200,
    "response_message": "Success",
    "merchant_code" :"MERCHANT001",
    "seller_id": "SELLER123456",
    "status": 1
}

Error Codes

Response Code	Response Message	Description
200	Success	Create seller successfully
101	System Error	System error
422	Validation Error	Validation Error
130	Seller ID exist	Seller's ID is duplicated or existing