닫기

  • Store

  • Product

  • Order

  • Customer

  • Community

  • Design

  • Promotion

  • Application

  • Category

  • Collection

  • Supply

  • Shipping

  • Salesreport

  • Personal

  • Privacy

  • Mileage

  • Notification

  • Translation

  • Analytics

    non-print

    API Index

    Introduction

    Cafe24 API

    Cafe24 Shopping Mall API is an API provided to app store join developers and third-party solution providers to provide services related to shopping malls.

    Cafe24 API is a RESTful architecture that provides OAuth 2.0 based authentication system, a standard HTTP request method, a predictable endpoint URL, and an HTTP code based error message.

    API Diagram

    Check out the overall structure of Cafe24 API through the diagram that describes the relations between resources.

    Request/Response Format

    • API request and response support JSON format.

    • For privacy protection purposes, Cafe 24 API only supports HTTPS protocol.

    • Dates properties are provided in the ISO_8601 format. : YYYY-MM-DDTHH:MM:SS + 09:00

    Request Example (search)
    Request Example (register/modify)
    Right response example 
    {
    "resource": {
        "key": "value",
        "key": "value"
     }
}
    Error response example 
    {
    "error": {
        "code": "error code",
        "message": "error message",
        "more_info": {
        }
    }
}

    Method

    Each resources support Create, Read, Update, and Delete and API can be used by using standard HTTP method.

    • POST : Create the resource.

    • GET: Read data the resource.

    • PUT : Modify(Update) the resource.

    • DELETE : Delete (delete) the resource.

    Admin API Intro

    Admin API

    The Admin API is suitable for the shopping mall administrator to query, create, modify, and delete information in the shopping mall. The Admin API can get almost every information of resource and available only after pass Oauth 2.0 authentication.

    Example 
    https://{mallid}.cafe24api.com/api/v2/admin/sampleapi

    API Status Code

    Code Case Solutions
    200 When GET success, PUT success, DELETE success
    201 When POST success
    207 When status is vary as requested multiple objects. Checks the error status of each object and deal with errors according to its status.
    400 Server does not understand request
    1) Wrong Content-Type declaration
    2) Application/type is not json     		Check for the "Content-Type" is application/json when request.
    400 When not use URL Encoded character in API Request URL Check whether API request URL has URL encoded character.
    401 1) When Access Token is missing
    2) When Access Token is wrong
    3) When Access Token is expired
    4) Unrecognizable client    		 Check whether the Access Token is granted and used via valid process.
    401 client_id is missing when using Front API Check whether using valid client_id.
    403 1) Access Token does not include Scope authority
    2) Access forbidden for Front API    		 Check the Scope of API or setting of shopping mall whether you have the authority for request API.
    403 Not a https protocol Check whether request protocol is https.
    403 Shopping mall has not been upgraded to a 'New product' mall Shopping mall has to be upgraded to a 'New product' mall in order to use API.
    403 (Admin API) App has been deleted from the shopping mall. Install again after check whether the App is installed at the shopping mall.
    403 (Front API) App has been deleted from the shopping mall. Install again after check whether the App is installed at the shopping mall.
    404 1) When requested wrong API URL
    2) When cannot found resource
    3) When missing {#id}    		 Check the API reference for errors in URL.
    422 When requested value is unprocessible with API reference
    1) Missing necessary parameter
    2) Not same with API reference    		 Check the API reference for whether omitted necessary parameter or put a wrong value.
    429 When client requested over than Bucket volume Request later in a while for not exceed maximum request.
    500 Internal server error or unknown error A temporary error has occurred. Please try again.
    503 Server is unavailable Please contact to developer center.
    503 Server is unavailable. Cannot use API right now Please contact to developer center.
    504 Timeout Response timeout due to a temporary error. Please try again later.

    How to use GET API

    Cafe24 API provides several ways to get the data.

    The following describes the different ways to recall data using various parameters when inquiring an API.

    1. Add search conditions

    You can use search conditions by adding parameters to an endpoint.

    If you want to use multiple search conditions, separate them with ampersands (&).

    You can also specify a date and time if it is supported by the API you are using.

    Add search conditions 
    E.g. When searching for products of which price is KRW 1,000 or higher in a certain brand
GET https://{mallid}.cafe24api.com/api/v2/products?brand_code=B000000A&price_min=1000

E.g. When searching for products by specifying the date range in which they were added
GET https://{mallid}.cafe24api.com/api/v2/products?created_start_date=2018-01-03&created_end_date=2018-02-03

E.g. When searching for products by specifying the date range in which they were edited
GET https://{mallid}.cafe24api.com/api/v2/products?updated_start_date=2018-01-03T14:01:26+09:00&updated_end_date=2018-02-03T14:01:26+09:00

    2. Use commas to search for more than one item

    Use commas to search for data for more than one item. (You can search for up to 100 items in one query.)

    The search conditions separated by commas are OR conditions; You can view all data corresponding to the conditions.

    Use commas to search for more than one item 
    E.g. When searching for products by specifying their product numbers
GET https://{mallid}.cafe24api.com/api/v2/products?product_no=11,12,13

E.g. When searching for products by specifying their product numbers and product codes
GET https://{mallid}.cafe24api.com/api/v2/products?product_no=11,12,13&product_code=P000000X,P000000W

    3. View multi-language store information

    You can search for the information of a localized store by specifying its multi-language store number.

    If you don't, the information of the default store will be shown.

    View multi-language store information 
    E.g. When searching for products in a certain localized store
GET https://{mallid}.cafe24api.com/api/v2/products?shop_no=2

    4. Retrieve single item & details

    You can retrieve the details of a resource by specifying its ID.

    You can only search for the details of one single product in one query

    but you can retrieve more details than when you search for multiple products.

    Retrieve single item & details 
    E.g. When retrieving the details of a product by specifying its product number
GET https://{mallid}.cafe24api.com/api/v2/admin/products/128


E.g. When retrieving the details of one single product by specifying its product number
GET https://{mallid}.cafe24api.com/api/v2/admin/products?product_no=128

    5. Pagination

    If there are too many results, you define the number of details returned in one response with the "limit" parameter.

    If you are not able to view all details with the maximum value of the "limit" parameter, you can use the "offset" parameter.

    Pagination 
    E.g. When paging the details of 100 products at a time
GET https://{mallid}.cafe24api.com/api/v2/admin/products?limit=100


E.g. When retrieving details from the 201st to the 300th product
GET https://{mallid}.cafe24api.com/api/v2/admin/products?limit=100&offset=200

    6. Retrieve specific items

    Use the "fields" parameter to view specific details

    Retrieve specific items 
    E.g. When retrieving the product name and product name only
GET https://{mallid}.cafe24api.com/api/v2/admin/products?fields=product_name,product_no

    7. View sub-resources

    If supported by the API you are using, you can search for the data for sub-resources with the "embed" parameter.

    View sub-resources 
    E.g. When searching for the variants and stock of a product
GET https://{mallid}.cafe24api.com/api/v2/admin/products/570?embed=variants,inventories

    API Limit

    Cafe 24 API works with the "Leaky Bucket" algorithm. The Leaky Bucket algorithm has the effect of limiting the number of API requests that are abnormally high for performance purposes, but also allowing the use of routine API requests without restriction.

    Cafe 24 API stacks API requests in the dock. Bucket is limited to API calls when up to "Request Limit" per shopping mall are filled. The Bucket is decreased twice per second and can be recalled as a decrease.

    • If the app calls the API twice a second, you can continue to use the API calls without restriction.

    • If more than "Request Limit" calls are generated momentarily within a second, return the 429 error (too many requests).

    • If more than 10 requests per second are made from the same IP address of an online store, the requests may be considered abnormal or malicious.

    You can avoid the 429 error by checking the X-Api-Call-Limit with the header. You can see how many APIs have been ordered from the shopping mall, and how many Buckets are left.

    X-Api-Call-Limit : 1/40

    Versioning

    Past Versions are provided in date format to support APIs that are not compatible with (latest) 2022-12-01

    User may define which version to use by setting value in the custom header "X-Cafe24-Api-Version". Without this value set, API version will follow version set in the app setup.

    App version can be found in below path.

    • Developer Center (sign-in) > Apps > App setup > "Version settings" underneath "App credentials"

    A version is valid for 1 year since the release of the latest version.

    In case your version get expired, oldest version currently valid will be used instead.

    Example (request)

    Authentication

    Get Authentication Code

    When requesting a token to be issued, the code used can not be reused and expires one minute after the code is issued.

    • {mallid} : Enter the appropriate shopping mall ID.

    • {client_id} : Enter the client_id of the app created in the developer center.

    • {state} : The value entered above is returned as a value to prevent modulation.

    • {redirect_anI} : Enter the Redirect URL for the app created by the developer center.

    • {script} : You can enter the privileges of the resource server to access the access token.

    To receive an access token, you must request a cotton access code. The access code is used if the client is in the form of a Web application.

    Example (request) 
    GET 'https://{mallid}.cafe24api.com/api/v2/oauth/authorize?response_type=code&client_id={client_id}&state={state}&redirect_uri={redirect_uri}&scope={scope}'
    Example (response) 
    HTTP/1.1 302 Found
Location: {redirect_uri}?code={authorize_code}&state={state}

    Get Access Token

    You can get a user token to actually call up the API using the issued authentication code.

    • {mallid} : Enter the corresponding shopping mall ID.

    • {client_id} : Enter the client_id of the app created in the developer center.

    • {client_secret} : Enter the client_secret for the app created at the developer center.

    • {code} : Enter the issued code.

    • {redirect_anI} : Enter the Redirect URL for the app created by the developer center.

    access_token : This is the approach token used by clients to access the resource server.

    refresh_token : This token is used to reissue after the approach token expires.

    Example (request)
    Example (response) 
    HTTP/1.1 200 OK
{
    "access_token": "0iqR5nM5EJIq..........",
    "expires_at": "2021-03-01T14:00:00.000",
    "refresh_token": "JeTJ7XpnFC0P..........",
    "refresh_token_expires_at": "2021-03-15T12:00:00.000",
    "client_id": "BrIfqEKoPxeE..........",
    "mall_id": "yourmall",
    "user_id": "test",
    "scopes": [
        "mall.read_order",
        "mall.read_product",
        "mall.read_store",
        "...etc...",
    ],
    "issued_at": "2021-03-01T12:00:00.000"
}

    Get Access Token using refresh token

    The approach token is unavilable after two hours after issued. After the approach token has expired, it must be reissued before the resource server can be accessed. If you have already received the approach token, you can re-issue it using refresh_token.

    The refresh token is valid for two weeks. If you request it before refresh token is finished, it is returned with the updated access token. You can not use the old refresh token after it has expired.

    You can get a user token to actually call up the API using the issued authentication code.

    • {mallid} : Enter the corresponding shopping mall ID.

    • {domain} : Enter the domain of the shopping mall.

    • {Client_id} : Enter the client_id of the app created by the developer center.

    • {client_secret} : Enter the client_secret of the app created by the developer center.

    • {refresh_token} : Enter the refresh_token received when the token was issued.

    access_token : Used as access token when clients access resource servers.

    refresh_token : This token is used to reissue after the approach token expires.

    Example (request)
    Example (response) 
    HTTP/1.1 200 OK
{
    "access_token": "21EZes0dGSfN..........",
    "expires_at": "2021-03-01T15:50:00.000",
    "refresh_token": "xLlhWztQHBik............",
    "refresh_token_expires_at": "2021-03-15T13:50:00.000",
    "client_id": "BrIfqEKoPxeE..........",
    "mall_id": "yourmall",
    "user_id": "test",
    "scopes": [
        "mall.read_order",
        "mall.read_product",
        "mall.read_store",
        "...etc...",
    ],
    "issued_at": "2021-03-01T13:50:00.000"
}

    Store

    Activitylogs

    Activity log is a record of activities performed by admin user upon managing the mall.
    The activity log resource allows you to create or retrieve activity logs of the mall.

    Endpoints 
    GET /api/v2/admin/activitylogs
GET /api/v2/admin/activitylogs/{process_no}

    Activitylogs properties

    Attribute Description
    process_no

    action number
    mode

    mode

    P : PC Admin
    M : Mobile admin
    S : Smart Mode (old)
    type

    division
    content

    action
    process_date

    timezone

    processed on
    manager_id

    Type : [a-z0-9]
    Length Min : [4]~Max : [16]

    account
    manager_type

    account type

    Retrieve a list of action logs

    GET /api/v2/admin/activitylogs

    GET

    Retrieve activity logs as a list.
    Check who performed the operation in which menu and when.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    manager_type

    account type

    P: head admin
    A: sub-admin
    S: supplier

    manager_id

    Type : [a-z0-9]
    Length Min : [4]~Max : [16]

    account

    mode

    mode

    P : PC Admin
    M : Mobile admin
    S : Smart Mode (old)

    type

    division

    content

    Max Length : [500]

    action

    start_date
    Required

    timezone

    Search Start Date

    end_date
    Required

    timezone

    Search End Date

    offset

    Max : [8000]

    Start location of list

    DEFAULT 0

    limit

    Min : [1]~Max : [100]

    Limit

    DEFAULT 10

    Retrieve an action log

    GET /api/v2/admin/activitylogs/{process_no}

    GET

    Search the activity log in detail.
    Check who performed the operation in which menu and when. Check details of the operation conducted.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    process_no
    Required

    action number

    Retrieve an action log
    Request Copy
    Response Copy

    Coupons setting

    Coupons setting allows you to enter basic settings for coupons to be used in the mall.
    Various settings such as coupon discounts, toggling accumulation, restrictions and displays are capable.

    Endpoints 
    GET /api/v2/admin/coupons/setting
PUT /api/v2/admin/coupons/setting

    Coupons setting properties

    Attribute Description
    shop_no

    Min : [1]

    Shop Number
    use_coupon

    enable coupons

    T: yes
    F: no
    available_issue_type

    allowed coupon type at checkout

    A: both checkout and product coupons
    O: checkout coupons only
    P: product coupons only
    allow_using_coupons_with_points

    allow using points with coupons

    T: yes
    F: no
    allow_using_coupons_with_discounts

    allow using customer tier based-discounts with coupons

    A: allow both
    C: allow coupons only
    G: allow customer tier-based discounts only
    allow_using_product_and_order_coupons

    allow using product coupons and checkout coupons together

    T: yes
    F: no
    recover_coupon_setting

    auto-restore coupons for
    max_coupon_count

    limit number of coupon uses for
    use_additional_coupon

    additional coupon

    T: yes
    F: no
    additional_coupon_no

    additional coupon number
    show_coupon_to_non_members

    display coupons to guests

    T: yes
    F: no
    show_group_coupon_to_non_members

    including coupons issued for specific customer tiers

    T: Included
    F: Not included
    show_issued_coupon

    display coupons already downloaded

    T: yes
    F: no
    sorting_type

    sort coupons by

    A: coupon start date
    B: coupon end date
    C: coupon issued date
    D: amount of discount/points issued
    E: discount/points issuance rate
    download_image_type

    default download button image

    1:TYPE1
    2:TYPE2
    3:TYPE3
    4:TYPE4
    5:TYPE5
    background_image_type

    default background image

    1:TYPE1
    2:TYPE2
    3:TYPE3
    4:TYPE4
    5:TYPE5

    Retrieve coupon settings

    GET /api/v2/admin/coupons/setting

    GET

    Retrieve setting information such as whether coupons are used or whether coupons and discounts are used at the same time.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    Retrieve coupon settings
    Request Copy
    Response Copy

    Update coupon settings

    PUT /api/v2/admin/coupons/setting

    PUT

    Update coupon setting information.
    You can update information such as whether to use coupons, restrictions on coupon usage, and limiting the number of coupon usage.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    use_coupon

    enable coupons

    T: yes
    F: no

    available_issue_type

    allowed coupon type at checkout

    A: both checkout and product coupons
    O: checkout coupons only
    P: product coupons only

    allow_using_coupons_with_points

    allow using points with coupons

    T: yes
    F: no

    allow_using_coupons_with_discounts

    allow using customer tier based-discounts with coupons

    A: allow both
    C: allow coupons only
    G: allow customer tier-based discounts only

    allow_using_product_and_order_coupons

    allow using product coupons and checkout coupons together

    T: yes
    F: no

    recover_coupon_setting

    auto-restore coupons for

    restore_viewpoint
    auto-restore coupons
    A: once cancellations/exchanges/returns are complete
    B: once cancellations/exchanges/returns are accepted

    cancel_before_pay
    cancellations before payment
    T: yes
    F: no
    M: always ask

    cancel_after_pay
    cancellations after payment
    T: yes
    F: no
    M: always ask

    return
    exchanges
    T: yes
    F: no
    M: always ask

    exchange
    returns
    T: yes
    F: no
    M: always ask

    part
    auto-restore coupons for orders partially canceled/returned/exchanged
    F: no
    M: always ask
    max_coupon_count

    limit number of coupon uses for

    product_per_product
    product coupons per product

    order_per_order
    checkout coupons per order

    product_and_order_per_order
    product/checkout coupons per order

    product_per_order
    product coupons per order

    product_and_order_per_day
    product/checkout coupons per day
    use_additional_coupon

    additional coupon

    T: yes
    F: no

    additional_coupon_no

    Array Max : [5]

    additional coupon number

    coupon_no
    Coupon number
    show_coupon_to_non_members

    display coupons to guests

    T: yes
    F: no

    show_group_coupon_to_non_members

    including coupons issued for specific customer tiers

    T: Included
    F: Not included

    show_issued_coupon

    display coupons already downloaded

    T: yes
    F: no

    sorting_type

    sort coupons by

    A: coupon start date
    B: coupon end date
    C: coupon issued date
    D: amount of discount/points issued
    E: discount/points issuance rate

    download_image_type

    default download button image

    1:TYPE1
    2:TYPE2
    3:TYPE3
    4:TYPE4
    5:TYPE5

    background_image_type

    default background image

    1:TYPE1
    2:TYPE2
    3:TYPE3
    4:TYPE4
    5:TYPE5

    Update coupon settings
    Request Copy
    Response Copy

    Currency

    This resource lets you read a store’s currency information and exchange rates.

    Endpoints 
    GET /api/v2/admin/currency

    Currency properties

    Attribute Description
    exchange_rate

    Exchange rate
    standard_currency_code

    Standard currency code

    The currency code used in the shopping mall of the shopping mall. Standard currency refers to the currency commonly used in countries where a shopping mall operator belongs.
    standard_currency_symbol

    Standard currency symbol

    The currency symbol used in the shopping mall of the shopping mall. Standard currency refers to the currency commonly used in countries where a shopping mall operator belongs.
    shop_currency_code

    Shopping mall currency code
    shop_currency_symbol

    Shopping mall currency symbol
    shop_currency_format

    Payment currency display method

    Retrieve currency settings

    GET /api/v2/admin/currency

    GET

    Retrieve currency & exchange rate info used in the mall.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40
    Retrieve currency settings
    Request Copy
    Response Copy

    Dashboard

    Dashboard is a brief summary of shopping mall operation information such as order status and sales status.

    Endpoints 
    GET /api/v2/admin/dashboard

    Dashboard properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    daily_sales_stats

    Daily sales stats

    Daily sales information.
    weekly_sales_stats

    Weekly sales stats

    Weekly sales information.
    monthly_sales_stats

    Monthly sales stats

    Monthly sales information.
    sold_out_products_count

    Number of the products sold out

    Number of soldout products. Counts only for products which using both soldout option and inventory management option.
    new_members_count

    Number of new members

    Number of newly signed up customer.
    board_list

    Board list

    Board list of a mall.

    Retrieve a dashboard

    GET /api/v2/admin/dashboard

    GET

    Retrieve Dashboard info.
    Check info on sales stats, etc.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    Retrieve a dashboard
    Request Copy
    Response Copy

    Financials paymentgateway

    Financials paymentgateway (PG information) provides PG contract information.

    Endpoints 
    GET /api/v2/admin/financials/paymentgateway

    Financials paymentgateway properties

    Attribute Description
    partner_id

    PG-issued store ID
    payment_gateway_name

    Payment gateway name

    inicis: Inicis
    kcp: KCP
    allat: Allat
    ksnet: KSNET
    dacom: Toss Payments
    allthegate: alltheGate
    settlebank: SettleBank
    smartro: Smartro
    kicc: KICC
    mobilians: KG Mobilians
    danal: Danal
    contract_date

    timezone

    PG contract date
    setting_date

    timezone

    PG installation date
    bank_code

    bank code
    bank_account_no

    bank account
    status

    affiliated with kb bank

    T: yes
    F: no
    bank_account_name

    account holder
    payment_method_information

    settlement details by payment method

    Retrieve a list of Payment Gateway contract details

    GET /api/v2/admin/financials/paymentgateway

    GET

    Retrieve a list of contract information by PG.
    Check PG contract date, settlement info by payment method, etc.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    payment_gateway_name

    Payment gateway name

    partner_id

    PG-issued store ID

    Retrieve a list of Payment Gateway contract details
    Request Copy
    Response Copy

    Financials store

    Provides transaction info by Payment Gateway.

    Endpoints 
    GET /api/v2/admin/financials/store

    Financials store properties

    Attribute Description
    shop_no

    Shop Number
    first_payment_date

    First paid on
    payment_gateway_name

    Payment gateway name

    Retrieve the transaction information of a store

    GET /api/v2/admin/financials/store

    GET

    Retrieve transaction info by payment methods.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    payment_method
    Required

    payment method code

    card: credit card
    tcash: bank transfer
    icash: virtual account
    cell: mobile
    deferpay: COD
    cvs: convenience store
    point: digital wallet balance
    etc: others

    Retrieve the transaction information of a store
    Request Copy
    Response Copy

    Images setting

    Retrieve or update product image size settings.

    Endpoints 
    GET /api/v2/admin/images/setting
PUT /api/v2/admin/images/setting

    Images setting properties

    Attribute Description
    shop_no

    Shop Number
    product_image_size

    Product image size settings

    Retrieve product image size settings

    GET /api/v2/admin/images/setting

    GET

    Retrieve product image size settings.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    Retrieve product image size settings
    Request Copy
    Response Copy

    Update product image size settings

    PUT /api/v2/admin/images/setting

    PUT

    Update product image size settings.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    product_image_size
    Required

    Product image size settings

    detail_image_width
    Detail image width

    detail_image_height
    Detail image height

    list_image_width
    List image width

    list_image_height
    List image height

    tiny_image_width
    Tiny list image width

    tiny_image_height
    Tiny list image height

    zoom_image_width
    Zoomed-in image width

    zoom_image_height
    Zoomed-in image height

    small_image_width
    Small image width

    small_image_height
    Small image height
    Update product image size settings
    Request Copy
    Response Copy

    Kakaopay setting

    Retrieve or update Kakaopay settings for a mall.

    Endpoints 
    GET /api/v2/admin/kakaopay/setting
PUT /api/v2/admin/kakaopay/setting

    Kakaopay setting properties

    Attribute Description
    shop_no

    Shop Number
    shop_key

    Unique identifier of the store
    pixel_code

    Kakao Advertising Pixel ID being used by the store (ECP/non-ECP)
    use_kakaopay

    Enable Kakao Pay

    T: Yes
    F: No
    product_detail_button_size

    Product details page button size
    basket_button_size

    Shopping cart page button size
    use_dark_mode

    Enable dark mode

    T: Yes
    F: No
    button_authorization_key

    Button authorization key of the store
    thirdparty_agree

    Agree to provide info to third parties

    T : Yes
    F : No
    thirdparty_agree_date

    timezone

    Date of consent to provision of information to third party

    Retrieve settings for KakaoPay orders

    GET /api/v2/admin/kakaopay/setting

    GET

    Retrieve Kakaopay settings for a mall.
    Check info on Kakaopay purchase, 3rd party consent, etc.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    Retrieve settings for KakaoPay orders
    Request Copy
    Response Copy

    Update settings for KakaoPay orders

    PUT /api/v2/admin/kakaopay/setting

    PUT

    Update Kakaopay settings for a mall.
    Update info on Kakaopay purchase, dark-mode activation, etc.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    shop_key

    Unique identifier of the store

    pixel_code

    Kakao Advertising Pixel ID being used by the store (ECP/non-ECP)

    use_kakaopay

    Enable Kakao Pay

    T: Yes
    F: No

    product_detail_button_size

    Product details page button size

    pc
    pc

    mobile
    mobile
    basket_button_size

    Shopping cart page button size

    pc
    pc

    mobile
    mobile
    use_dark_mode

    Enable dark mode

    T: Yes
    F: No

    button_authorization_key

    Button authorization key of the store

    thirdparty_agree

    Agree to provide info to third parties

    T : Yes
    F : No

    thirdparty_agree_date

    timezone

    Date of consent to provision of information to third party

    Update settings for KakaoPay orders
    Request Copy
    Response Copy

    Menus is a feature dealing with menu modes in a mall.
    You can retrieve menu modes & paths. Menu modes are comprised of pro mode, smart mode & mobile admin.

    Endpoints 
    GET /api/v2/admin/menus
    Attribute Description
    shop_no

    Shop Number
    mode

    Mode

    new_pro: PC Admin
    mobile_admin: Mobile admin
    menu_no

    Menu number
    name

    Menu name
    path

    Menu path
    contains_app_url

    Include app URL

    T: Yes
    F: No

    Retrieve menus

    GET /api/v2/admin/menus

    GET

    Retrieve menu modes & paths in a mall.
    Check info such as menu mode, menu number & whether app URL is included.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    mode

    Mode

    new_pro: PC Admin
    mobile_admin: Mobile admin

    DEFAULT new_pro

    menu_no

    Menu number

    You can search multiple item with ,(comma)

    contains_app_url

    Include app URL

    T: Yes
    F: No

    Mobile setting

    A resource on mobile shopping mall settings.
    Check info such as whether mobile mall is toggled & if address auto connection is used.

    Endpoints 
    GET /api/v2/admin/mobile/setting

    Mobile setting properties

    Attribute Description
    shop_no

    Shop Number
    use_mobile_page

    Enable mobile store

    T: Use
    F: Do not use
    use_mobile_domain_redirection

    Mobile connection address auto connection setting

    T: Use
    F: Do not use

    Retrieve mobile settings

    GET /api/v2/admin/mobile/setting

    GET

    Retrieve mobile settings of a mall.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 10

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    Retrieve mobile settings
    Request Copy
    Response Copy

    Naverpay Setting is a feature to retrieve or update Naverpay common authentication key of a mall.

    Endpoints 
    GET /api/v2/admin/naverpay/setting
PUT /api/v2/admin/naverpay/setting
    Attribute Description
    shop_no

    Shop Number
    authentication_key

    Naver common authentication key

    Retrieve Naver Pay settings

    GET /api/v2/admin/naverpay/setting

    GET

    Retrieve a Naverpay common authentication key of a mall.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    Retrieve Naver Pay settings
    Request Copy
    Response Copy

    Update Naver Pay settings

    PUT /api/v2/admin/naverpay/setting

    PUT

    Update a Naverpay common authentication key of a mall.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    authentication_key

    Type : [a-zA-Z0-9_-]
    Max Length : [50]

    Naver common authentication key

    Update Naver Pay settings
    Request Copy
    Response Copy

    Orders setting

    Retrieve and update order settings for automatic recovery of inventory and discount/point amount upon cancellation/return.

    Endpoints 
    GET /api/v2/admin/orders/setting
PUT /api/v2/admin/orders/setting

    Orders setting properties

    Attribute Description
    shop_no

    Min : [1]

    Shop Number
    claim_request

    Settings for customer cancellation exchange and return requests

    T: Use
    F: Do not use
    claim_request_type

    Item display settings for customer cancellation exchange and return requests

    S: Display "Basic options" D: Display "Advanced options"
    claim_request_button_exposure

    Request button display settings for customer cancellation exchange and return requests

    cancel_N10: Request cancellation button (Order status: Order in progress)
    cancel_N20: Request cancellation button (Order status: Preparing for shipment
    cancel_N22: Request cancellation button (Order status: Pending shipment)
    cancel_N21: Request cancellation (Order status: Awaiting shipment)
    exchange_N00: Request exchange button (Order status: Awaiting payment)
    exchange_N10: Request exchange button (Order status: Order in progress)
    exchange_N20: Request exchange button (Order status: Preparing for shipment)
    exchange_N22: Request exchange button (Order status: Pending shipment)
    exchange_N21: Request exchange button (Order status: Awaiting shipment)
    exchange_N30: Request exchange button (Order status: In transit)
    exchange_N40: Request exchange button (Order status: Delivered
    return_N30: Request return button (Order status: In transit)
    return_N40: Request return button (Order status: Delivered)
    claim_request_button_date_type

    Display request buttons for customer cancellation exchange and return based on

    order_date: Start displaying buttons from the order date
    shipend_date: Start displaying buttons from the delivered date
    claim_request_button_period

    Display period for customer cancellation exchange and return request buttons
    stock_recover

    Automatically recover stock for a canceled/returned item

    T: General settings F: Individual settings
    stock_recover_base

    General settings: Automatically recover stock for a canceled/returned item

    T: Automatically recover F: Do not automatically recover M: Ask whether to recover
    stock_recover_individual

    Individual settings: Recover stock for a canceled/returned item
    claim_request_auto_accept

    Settings for auto-accepting customer cancellation exchange and return requests

    T: Use
    F: Do not use
    refund_benefit_setting

    Set discount/point amount for cancellations/exchanges/returns
    refund_processing_setting

    Refund settings for cancellation/exchange/return requests

    S: Process concurrently
    D: Process separately

    Retrieve Order Settings

    GET /api/v2/admin/orders/setting

    GET

    Retrieve order settings such as automatic recovery of inventories upon cancellation/return & prices for discounts/points.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    Retrieve Order Settings
    Request Copy
    Response Copy

    Update Order settings

    PUT /api/v2/admin/orders/setting

    PUT

    Update settings for discount / point amount upon cancel, exchange & return

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    refund_benefit_setting

    Set discount/point amount for cancellations/exchanges/returns

    F: Display by total amount T: Display by selected item U: Auto-calculate discount amount (Note: Settings applied to orders hence after)

    Update Order settings
    Request Copy
    Response Copy

    Paymentgateway



    With PG (Paymentgateway), you can retrieve, create, update or delete a PG app.

    Endpoints 
    POST /api/v2/admin/paymentgateway
PUT /api/v2/admin/paymentgateway/{client_id}
DELETE /api/v2/admin/paymentgateway/{client_id}

    Paymentgateway properties

    Attribute Description
    shop_no

    Shop Number
    partner_id

    PG-issued store ID
    client_id

    app client ID
    additional_information

    additional information
    membership_fee_type

    subscription fee type

    PRE : Prepaid
    PAD : Pay after delivery
    FREE : Free

    Create a Payment Gateway

    POST /api/v2/admin/paymentgateway

    POST

    Create a new PG (Payment Gateway) for a mall.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    partner_id
    Required

    Max Length : [50]

    PG-issued store ID

    additional_information

    Array Max : [5]

    additional information

    key
    Additional field key

    value
    Additional field value
    membership_fee_type

    Max Length : [4]

    subscription fee type

    PRE : Prepaid
    PAD : Pay after delivery
    FREE : Free

    Create a Payment Gateway
    Request Copy
    Response Copy

    Update a Payment Gateway

    PUT /api/v2/admin/paymentgateway/{client_id}

    PUT

    Update a PG (Payment Gateway) registered for a mall.
    Update info such as PG franchise ID & whether registration fee is required.
    In order to update, Client ID of the PG app is required.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    client_id
    Required

    Max Length : [50]

    app client ID

    partner_id

    Max Length : [50]

    PG-issued store ID

    additional_information

    Array Max : [5]

    additional information

    key
    Additional field key

    value
    Additional field value
    membership_fee_type

    Max Length : [4]

    subscription fee type

    PRE : Prepaid
    PAD : Pay after delivery
    FREE : Free

    Update a Payment Gateway
    Request Copy
    Response Copy

    Delete a Payment Gateway

    DELETE /api/v2/admin/paymentgateway/{client_id}

    DELETE

    Delete a PG (Payment Gateway) registered for a mall.
    In order to delete, Client ID of PG app is required.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    client_id
    Required

    Max Length : [50]

    app client ID

    Delete a Payment Gateway
    Request Copy
    Response Copy

    Paymentgateway paymentmethods

    PG (Payment Gateway) payment methods is a feature to manage payment methods registered to the mall.
    You can create, retrieve, update & delete a payment method for a PG (Payment Gateway).

    Endpoints 
    GET /api/v2/admin/paymentgateway/{client_id}/paymentmethods
POST /api/v2/admin/paymentgateway/{client_id}/paymentmethods
PUT /api/v2/admin/paymentgateway/{client_id}/paymentmethods/{payment_method_code}
DELETE /api/v2/admin/paymentgateway/{client_id}/paymentmethods/{payment_method_code}

    Paymentgateway paymentmethods properties

    Attribute Description
    client_id

    app client ID
    payment_method_code

    payment method code
    payment_method

    Payment Method

    card: credit card
    tcash: bank transfer
    icash: virtual account
    cell: mobile
    cvs: convenience store
    deferpay: COD
    payment_method_name

    Payment method name
    payment_method_url

    payment method image path

    Retrieve a list of Payment Gateway methods

    GET /api/v2/admin/paymentgateway/{client_id}/paymentmethods

    GET

    Retrieve a payment method of a PG (Payment Gateway) registered to the mall.
    You can retrieve info such as method, code & name of a payment method.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    client_id
    Required

    Max Length : [50]

    app client ID

    Retrieve a list of Payment Gateway methods
    Request Copy
    Response Copy

    Create a Payment Gateway method

    POST /api/v2/admin/paymentgateway/{client_id}/paymentmethods

    POST

    Create a payment method for a PG (Payment Gateway) installed for a mall.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    client_id
    Required

    Max Length : [50]

    app client ID

    payment_method_code
    Required

    Max Length : [50]

    payment method code

    payment_method
    Required

    Payment Method

    card: credit card
    tcash: bank transfer
    icash: virtual account
    cell: mobile
    cvs: convenience store
    deferpay: COD

    payment_method_name
    Required

    Max Length : [50]

    Payment method name

    payment_method_url
    Required

    Max Length : [200]

    payment method image path

    Create a Payment Gateway method
    Request Copy
    Response Copy

    Update a payment method of a Payment Gateway

    PUT /api/v2/admin/paymentgateway/{client_id}/paymentmethods/{payment_method_code}

    PUT

    Update a payment method for a PG (Payment Gateway) installed for a mall.
    You may update info such as method, name, etc.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    client_id
    Required

    Max Length : [50]

    app client ID

    payment_method_code
    Required

    Max Length : [50]

    payment method code

    payment_method

    Payment Method

    card: credit card
    tcash: bank transfer
    icash: virtual account
    cell: mobile
    cvs: convenience store
    deferpay: COD

    payment_method_name

    Max Length : [50]

    Payment method name

    payment_method_url

    Max Length : [200]

    payment method image path

    Update a payment method of a Payment Gateway
    Request Copy
    Response Copy

    Delete a payment method of a Payment Gateway

    DELETE /api/v2/admin/paymentgateway/{client_id}/paymentmethods/{payment_method_code}

    DELETE

    Delete a payment method of a PG (Payment Gateway) registered to the mall.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40

    Request

    Parameter Description
    client_id
    Required

    Max Length : [50]

    app client ID

    payment_method_code
    Required

    Max Length : [50]

    payment method code

    Delete a payment method of a Payment Gateway
    Request Copy
    Response Copy

    Paymentmethods

    Retrieve payment methods installed for a mall.

    Endpoints 
    GET /api/v2/admin/paymentmethods

    Paymentmethods properties

    Attribute Description
    shop_no

    Shop Number
    code

    payment method code

    Retrieve a list of payment methods

    GET /api/v2/admin/paymentmethods

    GET

    Retrieve a list of payment methods for a mall.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    Retrieve a list of payment methods
    Request Copy
    Response Copy

    Paymentmethods paymentproviders



    Retrieve info or update display settings of a payment method set for a mall.

    Endpoints 
    GET /api/v2/admin/paymentmethods/{code}/paymentproviders
PUT /api/v2/admin/paymentmethods/{code}/paymentproviders/{name}

    Paymentmethods paymentproviders properties

    Attribute Description
    shop_no

    Shop Number
    name

    Payment gateway name
    display

    Check whether the payment method is displayed

    T: yes
    F: no

    Retrieve a list of providers by payment method

    GET /api/v2/admin/paymentmethods/{code}/paymentproviders

    GET

    Retrieve a payment method info set for a mall.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    code
    Required

    payment method code

    name

    Payment gateway name

    display

    Check whether the payment method is displayed

    T: yes
    F: no

    Retrieve a list of providers by payment method
    Request Copy
    Response Copy

    Update the display status of a payment method

    PUT /api/v2/admin/paymentmethods/{code}/paymentproviders/{name}

    PUT

    Update display settings of a payment method set for a mall.

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    code
    Required

    payment method code

    name
    Required

    Payment gateway name

    display
    Required

    Check whether the payment method is displayed

    T: yes
    F: no

    Update the display status of a payment method
    Request Copy
    Response Copy

    Points setting

    Manages setting information in regards to using the Points feature

    Endpoints 
    GET /api/v2/admin/points/setting

    Points setting properties

    Attribute Description
    shop_no

    Shop Number
    payment_period

    Points issue date
    name

    Points title
    format

    Display method
    round_unit

    Rounding unit

    F: No round-off
    0.01: to the nearest hundredth
    0.1: to the nearest tenth
    1: to the nearest one
    10: to the nearest ten
    100: to the nearest hundred
    1000: to the nearest thousand
    round_type

    Rounding method

    A: Round down
    B: Round half up
    C: Round up
    display_type

    Points format display settings

    P: Percentage
    W: Amount
    WP: Amount/Percentage
    PW: Percentage/Amount

    Retrieve points settings

    GET /api/v2/admin/points/setting

    GET

    Retrieve points setting information such as name, distribution date, unit, etc.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    Retrieve points settings
    Request Copy
    Response Copy

    Products setting

    Endpoints 
    GET /api/v2/admin/products/setting

    Products setting properties

    Attribute Description
    shop_no

    Shop Number
    calculate_price_based_on

    base for price calculation

    S: margin per cost
    A: margin per price
    P: price set for default store
    B: product price
    price_rounding_unit

    rounding place for price

    F: no round-off
    -2: to the nearest hundredth
    -1: to the nearest tenth
    0: to the nearest one
    1: to the nearest ten
    2: to the nearest hundred
    3: to the nearest thousand
    price_rounding_rule

    price rounding

    L: round down
    U: round
    C: round up

    Retrieve product settings

    GET /api/v2/admin/products/setting

    GET

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    Retrieve product settings
    Request Copy
    Response Copy

    Seo setting

    Endpoints 
    GET /api/v2/admin/seo/setting
PUT /api/v2/admin/seo/setting

    Seo setting properties

    Attribute Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1
    common_page_title

    Common page title tags
    common_page_meta_description

    Common page description tags
    favicon

    URL

    Favicon
    use_google_search_console

    Whether Google Search Console is enabled

    T: Enable
    F: Disable
    google_search_console

    Google Search Console
    use_naver_search_advisor

    Whether Naver Search Advisor is enabled

    T: Enable
    F: Disable
    naver_search_advisor

    NAVER Search Advisor
    sns_share_image

    URL

    Social Share image
    use_twitter_card

    Use Twitter Cards

    T: Enable
    F: Disable
    robots_text

    Ban search robots from PC version website
    mobile_robots_text

    Ban search robots from mobile version website
    use_missing_page_redirect

    Whether users are redirected to "page doesn't exist" page (PC)

    T: Enable
    F: Disable
    missing_page_redirect_url

    Redirect URL for "page doesn't exist" page (PC)
    mobile_use_missing_page_redirect

    Whether users are redirected to "page doesn't exist" page (Mobile)

    T: Enable
    F: Disable
    mobile_missing_page_redirect_url

    Redirect URL for "page doesn't exist" page (Mobile)
    use_sitemap_auto_update

    Whether sitemap is enabled

    T: Enable
    F: Disable
    use_rss

    Enable RSS feed

    T: Enable
    F: Disable
    display_group

    Group Name
    header_tag

    Head HTML (PC)
    footer_tag

    Body HTML (PC)
    mobile_header_tag

    Head HTML (Mobile)
    mobile_footer_tag

    Body HTML (Mobile)

    Retrieve SEO settings

    GET /api/v2/admin/seo/setting

    GET

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    Retrieve SEO settings
    Request Copy
    Response Copy

    Update store SEO settings

    PUT /api/v2/admin/seo/setting

    PUT

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    common_page_title

    Common page title tags

    common_page_meta_description

    Common page description tags

    favicon

    URL

    Favicon

    use_google_search_console

    Whether Google Search Console is enabled

    T: Enable
    F: Disable

    google_search_console

    Google Search Console

    use_naver_search_advisor

    Whether Naver Search Advisor is enabled

    T: Enable
    F: Disable

    naver_search_advisor

    NAVER Search Advisor

    sns_share_image

    URL

    Social Share image

    use_twitter_card

    Use Twitter Cards

    T: Enable
    F: Disable

    robots_text

    Ban search robots from PC version website

    mobile_robots_text

    Ban search robots from mobile version website

    use_missing_page_redirect

    Whether users are redirected to "page doesn't exist" page (PC)

    T: Enable
    F: Disable

    missing_page_redirect_url

    Redirect URL for "page doesn't exist" page (PC)

    mobile_use_missing_page_redirect

    Whether users are redirected to "page doesn't exist" page (Mobile)

    T: Enable
    F: Disable

    mobile_missing_page_redirect_url

    Redirect URL for "page doesn't exist" page (Mobile)

    use_sitemap_auto_update

    Whether sitemap is enabled

    T: Enable
    F: Disable

    use_rss

    Enable RSS feed

    T: Enable
    F: Disable

    display_group

    Group Name

    header_tag

    Head HTML (PC)

    footer_tag

    Body HTML (PC)

    mobile_header_tag

    Head HTML (Mobile)

    mobile_footer_tag

    Body HTML (Mobile)

    Update store SEO settings
    Request Copy
    Response Copy

    Shippingmanager

    Endpoints 
    GET /api/v2/admin/shippingmanager

    Shippingmanager properties

    Attribute Description
    use

    Shipping Manager activation information

    Retrieve activation information for Shipping Manager

    GET /api/v2/admin/shippingmanager

    GET

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40
    Retrieve activation information for Shipping Manager
    Request Copy
    Response Copy

    Shops

    Shops is information of multi shopping malls that are created when two or more shopping malls are operated. Multi-shopping malls can be created up to 5, and they can be created in different languages and currencies, which can be used to operate multilingual shopping malls.

    Endpoints 
    GET /api/v2/admin/shops
GET /api/v2/admin/shops/{shop_no}

    Shops properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    default

    Whether it is the basic shop

    Whether shop is default shop or not.

    T: default shop
    F: not a default shop
    shop_name

    Max Length : [255]

    Shop name

    Store name of the multi-language store
    business_country_code

    Business country code

    business_country_code

    language_code

    Language code

    Default language code of multi shopping mall.

    ko_KR: Korean
    en_US: English
    zh_CN: Chinese (Simplified)
    zh_TW: Chinese (Traditional)
    ja_JP: Japanese vi_VN : Vietnamese
    language_name

    Max Length : [20]

    Language name

    Default language name of multi shopping mall.
    currency_code

    Type : [A-Z]

    Shopping mall currency code

    Currency code of multi shopping mall.

    South Korean Won (KRW)
    United States Dollar (USD)
    Japanese Yen (JPY)
    Chinese Yuan (CNY)
    Taiwan Dollar (TWD)
    Euro (EUR)
    Brazilian Real (BRL)
    Vietnamese Dong (VND)
    currency_name

    Currency name

    Currency name of multi shopping mall.
    reference_currency_code

    Type : [A-Z]

    Reference currency code

    Reference currency code of multi shopping mall.

    South Korean Won (KRW)
    United States Dollar (USD)
    Japanese Yen (JPY)
    Chinese Yuan (CNY)
    reference_currency_name

    Reference currency name

    Reference currency name of multi shopping mall.
    pc_skin_no

    Pc skin no

    Design number of PC shopping mall.
    mobile_skin_no

    Mobile skin no

    Design number of Mobile shopping mall.
    base_domain

    Max Length : [63]

    Base domain

    Base domain.
    primary_domain

    Max Length : [63]

    Primary domain

    Representative domain of multi shopping mall.
    slave_domain

    Slave domain

    Connected domain of shopping mall.
    active

    Active

    Whether activating multi shopping mall or not.

    T: activated
    F: deactivated
    timezone

    time zone
    timezone_name

    time zone information
    date_format

    time zone date format

    Year/Month/Day : YYYY-MM-DD
    Month/Day/Year : MM-DD-YYYY
    Day/Month/Year : DD-MM-YYYY
    time_format

    time zone time format

    Hour/Minute/Second : hh:mm:ss
    Hour/Minute : hh:mm
    use_reference_currency

    Use a reference currency

    Retrieve a list of shops

    GET /api/v2/admin/shops

    GET

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40
    Retrieve a list of shops
    Request Copy
    Response Copy

    Retrieve a shop

    GET /api/v2/admin/shops/{shop_no}

    GET

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no
    Required

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    Retrieve a shop
    Request Copy
    Response Copy

    Sms setting

    Sms setting is a resource about settings for sending and receiving SMS from and to an online store.

    Endpoints 
    GET /api/v2/admin/sms/setting

    Sms setting properties

    Attribute Description
    shop_no

    Shop Number
    use_sms

    whether use SMS

    T: use
    F: do not use
    exclude_unsubscriber

    whether exclude SMS rejected recipient

    T : exclude
    F : include
    default_sender

    default sender id
    unsubscribe_phone

    Free unsubscribe phone number
    send_method

    SMS send method

    S: send SMS via split message
    L: send LMS(deduct 3 SMS remaining)

    Retrieve SMS settings

    GET /api/v2/admin/sms/setting

    GET

    This API can only be used in stores using Korean.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    Retrieve SMS settings
    Request Copy
    Response Copy

    Socials apple

    Endpoints 
    GET /api/v2/admin/socials/apple
PUT /api/v2/admin/socials/apple

    Socials apple properties

    Attribute Description
    shop_no

    Shop Number
    use_apple_login

    Enable Apple login

    T: Yes
    F: No
    client_id

    Client ID
    team_id

    Team ID
    key_id

    Key ID
    auth_key_file_name

    Auth Key filename
    use_certification

    Apple login user authentication

    T: Yes
    F: No

    Apple login sync details

    GET /api/v2/admin/socials/apple

    GET

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    Apple login sync details
    Request Copy
    Response Copy

    Apple login sync settings

    PUT /api/v2/admin/socials/apple

    PUT

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    use_apple_login

    Enable Apple login

    T: Yes
    F: No

    client_id

    Max Length : [300]

    Client ID

    team_id

    Max Length : [300]

    Team ID

    key_id

    Max Length : [300]

    Key ID

    auth_key_file_name

    Max Length : [30]

    Auth Key filename

    auth_key_file_contents

    Max Length : [300]

    Auth Key file content

    use_certification

    Apple login user authentication

    T: Yes
    F: No

    Apple login sync settings
    Request Copy
    Response Copy

    Store

    The store can get the basic information of the shopping mall such as shopping mall name, manager information, business registration number and customer center phone number of shopping mall.

    Endpoints 
    GET /api/v2/admin/store

    Store properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    shop_name

    Shop name
    mall_id

    Store ID

    Shopping mall ID. Also used in store manager's name and used in base domain.
    base_domain

    Base domain

    Auto generated and free default domain. You can access the shoopping mall with this domain.
    primary_domain

    Primary domain

    A representative domain connected to a shopping mall. It is dispalyed only when connecting representative domains.
    company_registration_no

    Company registration number

    The business registration number of the shopping mall issued in the country where the business is located.
    company_name

    Company name

    Business name or company name registered at the time of business registration.
    president_name

    CEO

    The name of the representative registered at the time of business registration.
    company_condition

    Business

    Business registered at business registration.
    company_line

    Business category

    Business category registered at business registration.
    country

    Country of business

    Name of the country where the business is located.
    country_code

    Country code
    zipcode

    Zipcode

    Postal code of your business
    address1

    Address 1

    Business address (city / county / province)
    address2

    Address 2

    Business address (street address)
    phone

    Office phone number
    fax

    Office fax number
    email

    Email
    notification_only_email

    Sender email
    mall_url

    Shopping mall address
    mail_order_sales_registration

    Report mail-order business

    Tells whether the online store has registered as a mail-order sales business.

    T:Reported
    F:Not Reported
    mail_order_sales_registration_number

    Mail-order business report number
    missing_report_reason_type

    Reason of no mail-order business report

    If you did not report mail-order business, Its reason.
    missing_report_reason

    Detailed reason of no mail-order business report

    If the reason for not report mail-order business is "other", the reason for detail.
    about_us_contents

    About us

    A brief introduction to the mall. It is displayed on the company introduction page of the shopping mall.
    company_map_url

    Company map URL

    Show a brief map of the mall. It is displayed on the company introduction page of the shopping mall.
    customer_service_phone

    Customer center service/order phone

    Customer center call number displayed on the shopping mall page.
    customer_service_email

    Customer center service/order e-mail

    Customer center contact email address displayed on shopping mall page.
    customer_service_fax

    Customer center fax number

    Customer center fax number displayed on the shopping page.
    customer_service_sms

    Customer center SMS number

    Customer center SMS number displayed on the shopping page.
    customer_service_hours

    Customer center operation time

    The customer center open hours displayed on the shopping page.
    privacy_officer_name

    Privacy officer's name

    The name of the person in charge of personal information protection displayed on the shopping mall page.
    privacy_officer_position

    Privacy officer's position
    privacy_officer_department

    Privacy officer's department
    privacy_officer_phone

    Privacy officer's phone number

    The phone number of the person in charge of privacy protection displayed on the shopping mall page.
    privacy_officer_email

    Privacy officer's email address

    The e-mail address of the person in charge of privacy protection displayed on the shopping mall page.
    contact_us_mobile

    Whether to display the service inquiry guide in mobile phone

    Whether to expose service information to mobile website.

    T: Displayed
    F: Not displayed
    contact_us_contents

    Service contact information

    Details of service contact information exposed on the product detail page.

    Retrieve store details

    GET /api/v2/admin/store

    GET

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    Retrieve store details
    Request Copy
    Response Copy

    Store accounts

    Endpoints 
    GET /api/v2/admin/store/accounts

    Store accounts properties

    Attribute Description
    shop_no

    Shop Number
    bank_account_id

    bank ID (for bank transfer without a bankbook)
    bank_name

    Bank name
    bank_code

    Max Length : [50]

    Bank code

    bank_code

    bank_account_no

    Bank account no
    bank_account_holder

    Bank account holder number
    use_account

    Use classification

    T: Use
    F: Do not use

    Retrieve a list of store bank accounts

    GET /api/v2/admin/store/accounts

    GET

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    Retrieve a list of store bank accounts
    Request Copy
    Response Copy

    Subscription shipments setting

    Endpoints 
    GET /api/v2/admin/subscription/shipments/setting
POST /api/v2/admin/subscription/shipments/setting
PUT /api/v2/admin/subscription/shipments/setting/{subscription_no}
DELETE /api/v2/admin/subscription/shipments/setting/{subscription_no}

    Subscription shipments setting properties

    Attribute Description
    shop_no

    Shop Number
    subscription_no

    subscription product number
    subscription_shipments_name

    subscription product name
    product_binding_type

    Subscription product

    A: all products
    P: selected products
    C: selected product categories
    one_time_purchase

    Allow one-time purchase

    T : Yes
    F : No
    product_list

    products selected for subscription delivery
    category_list

    product categories selected for subscription delivery
    use_discount

    Subscription Payments discount settings

    T: Used
    F: Not used
    discount_value_unit

    Discount standard

    P: discount rate
    W: discount amount
    discount_values

    Discount amount
    related_purchase_quantity

    number of products settings

    T: order quantity-based
    F: regardless of order quantity
    subscription_shipments_cycle_type

    delivery frequency option settings

    T: Used
    F: Not used
    subscription_shipments_cycle

    delivery frequency

    1W: 1 week
    2W: 2 weeks
    3W: 3 weeks
    4W: 4 weeks
    1M: 1 month
    2M: 2 months
    3M: 3 months
    4M: 4 months
    5M: 5 months
    6M: 6 months
    1Y: 1 year
    use_order_price_condition

    free shipping settings

    T: Used
    F: Not used
    order_price_greater_than

    Minimum purchase amount for free shipping
    include_regional_shipping_rate

    whether regional shipping charge included

    T: Included
    F: Not included
    shipments_start_date

    Min : [1]
    Max : [30]

    Subscription start date settings

    Retrieve a list of subscription products

    GET /api/v2/admin/subscription/shipments/setting

    GET

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    subscription_no

    subscription product number

    Retrieve a list of subscription products
    Request Copy
    Response Copy

    Create a subscription payment rule

    POST /api/v2/admin/subscription/shipments/setting

    POST

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    subscription_shipments_name
    Required

    Max Length : [255]

    subscription product name

    product_binding_type
    Required

    Subscription product

    A: all products
    P: selected products
    C: selected product categories

    one_time_purchase

    Allow one-time purchase

    T : Yes
    F : No

    DEFAULT T

    product_list

    Array Max : [10000]

    products selected for subscription delivery

    category_list

    Array Max : [1000]

    product categories selected for subscription delivery

    use_discount
    Required

    Subscription Payments discount settings

    T: Used
    F: Not used

    discount_value_unit

    Discount standard

    P: discount rate
    W: discount amount

    discount_values

    Array Max : [20]

    Discount amount

    Maximum value when discount_value_unit is P: 100
    Maximum value when discount_value_unit is W: 99999999999999

    related_purchase_quantity

    number of products settings

    T: order quantity-based
    F: regardless of order quantity

    subscription_shipments_cycle_type
    Required

    delivery frequency option settings

    T: Used
    F: Not used

    subscription_shipments_cycle
    Required

    delivery frequency

    1W: 1 week
    2W: 2 weeks
    3W: 3 weeks
    4W: 4 weeks
    1M: 1 month
    2M: 2 months
    3M: 3 months
    4M: 4 months
    5M: 5 months
    6M: 6 months
    1Y: 1 year

    use_order_price_condition
    Required

    free shipping settings

    T: Used
    F: Not used

    order_price_greater_than

    Max : [99999999999999]

    Minimum purchase amount for free shipping

    include_regional_shipping_rate

    whether regional shipping charge included

    T: Included
    F: Not included

    shipments_start_date

    Min : [1]
    Max : [30]

    Subscription start date settings

    DEFAULT 3

    Create a subscription payment rule
    Request Copy
    Response Copy

    Update subscription products

    PUT /api/v2/admin/subscription/shipments/setting/{subscription_no}

    PUT

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    subscription_no
    Required

    subscription product number

    subscription_shipments_name

    Max Length : [255]

    subscription product name

    product_binding_type

    Subscription product

    A: all products
    P: selected products
    C: selected product categories

    one_time_purchase

    Allow one-time purchase

    T : Yes
    F : No

    product_list

    Array Max : [10000]

    products selected for subscription delivery

    category_list

    Array Max : [1000]

    product categories selected for subscription delivery

    use_discount

    Subscription Payments discount settings

    T: Used
    F: Not used

    discount_value_unit

    Discount standard

    P: discount rate
    W: discount amount

    discount_values

    Array Max : [20]

    Discount amount

    related_purchase_quantity

    number of products settings

    T: order quantity-based
    F: regardless of order quantity

    subscription_shipments_cycle_type

    delivery frequency option settings

    T: Used
    F: Not used

    subscription_shipments_cycle

    delivery frequency

    1W: 1 week
    2W: 2 weeks
    3W: 3 weeks
    4W: 4 weeks
    1M: 1 month
    2M: 2 months
    3M: 3 months
    4M: 4 months
    5M: 5 months
    6M: 6 months
    1Y: 1 year

    use_order_price_condition

    free shipping settings

    T: Used
    F: Not used

    order_price_greater_than

    Max : [99999999999999]

    Minimum purchase amount for free shipping

    include_regional_shipping_rate

    whether regional shipping charge included

    T: Included
    F: Not included

    shipments_start_date

    Min : [1]
    Max : [30]

    Subscription start date settings

    Update subscription products
    Request Copy
    Response Copy

    Delete subscription products

    DELETE /api/v2/admin/subscription/shipments/setting/{subscription_no}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    subscription_no
    Required

    subscription product number

    Delete subscription products
    Request Copy
    Response Copy

    Taxmanager

    Feature on tax manager (MSA) activation info

    Endpoints 
    GET /api/v2/admin/taxmanager

    Taxmanager properties

    Attribute Description
    use

    Tax Manager activation information

    Retrieve activation information for Tax Manager

    GET /api/v2/admin/taxmanager

    GET

    Retrieve tax manager usage info

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40
    Retrieve activation information for Tax Manager
    Request Copy
    Response Copy

    Users

    Users can operate the shopping mall along with the representative admin user of the shopping mall.
    You can operate a shopping mall within the authority granted by the representative admin user.

    Retrieve a single user or multiple users registered in the mall as a list.

    Endpoints 
    GET /api/v2/admin/users
GET /api/v2/admin/users/{user_id}

    Users properties

    Attribute Description
    user_id

    Admin ID

    Sub-admin ID
    user_name

    Admin name

    Sub-admin name
    phone

    Phone Number

    Office phone number

    Phone number of sub operator.
    email

    Email

    Email

    Email address of sub operator.
    ip_restriction_type

    Restriction on the IP access

    Whether use IP restriction or not.

    T: Use
    F: Do not use
    admin_type

    Operator category

    Whether administor is representative operator or sub operator.

    P: Representative operator
    A: Sub-operator
    last_login_date

    timezone

    Last login date
    shop_no

    Min : [1]

    Shop Number
    nick_name

    Nick name

    Nick name of operator.
    nick_name_icon_type

    Nickname icon type of supplier operator

    Register nick name icon. You may register manually or may choose sample.

    D: manually register icon
    S: register sample icon
    nick_name_icon_url

    Nickname icon url of supplier operator
    board_exposure_setting

    exposure setting for board
    memo

    Memo
    available

    Use classification

    T: Use
    F: Do not use
    multishop_access_authority

    Multi-shopping mall access authority

    T: Allow
    F: Do not allow
    menu_access_authority

    Menu access authority
    detail_authority_setting

    Detailed authority setting
    ip_access_restriction

    Restriction on the IP access
    access_permission

    Authority to permit the access

    T: permission always granted regardless of access permitted time setting

    Retrieve a list of admin users

    GET /api/v2/admin/users

    GET

    Retrieve users registered in the mall as a list.
    Retrieve information such as user ID, user name, phone number, etc.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    search_type

    Search type

    member_id: member ID
    name: member name

    keyword

    Keyword

    admin_type

    Operator category

    P: Representative operator
    A: Sub-operator

    Retrieve admin user details

    GET /api/v2/admin/users/{user_id}

    GET

    Retrieve a user registered in the mall as a list.
    Retrieve information such as user name, phone number, email, etc.

    Specification

    Property Description
    SCOPE mall.read_store
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    user_id

    Admin ID

    Retrieve admin user details
    Request Copy
    Response Copy

    Product

    Bundleproducts

    Endpoints 
    GET /api/v2/admin/bundleproducts
GET /api/v2/admin/bundleproducts/{product_no}
POST /api/v2/admin/bundleproducts
PUT /api/v2/admin/bundleproducts/{product_no}
DELETE /api/v2/admin/bundleproducts/{product_no}

    Bundleproducts properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    product_no

    Product number

    A unique serial number assigned to a product. This number cannot be duplicated.
    product_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Product code

    A code assigned to a product by the system. This code cannot be duplicated.
    bundle_product_components

    composite product information
    custom_product_code

    Max Length : [40]

    Custom product code

    A code assigned to a product by the store admin. The code can be used by store admins who need their own separate code to manage products for inventory management or other reasons.
    product_name

    Max Length : [250]

    Product name

    Name of the product. This is the basic information to identify products and can be a query for searching for products. It can be entered in the HTML form.
    eng_product_name

    Max Length : [250]

    English name of product

    Product name in English. It can be used for international shipping.
    supply_product_name

    Max Length : [250]

    Supplier product name

    Product name entered by a supplier. The supplier can enter any name it needs to identify products. This name does not affect Product name.
    internal_product_name

    Max Length : [50]

    internal product name
    model_name

    Max Length : [100]

    Model name

    Model of the product
    display

    Whether display

    Whether the product is displayed on the store.
    If it is, it is diaplayed on the selected categories and on the home page.
    If it is not, it is not displayed on the store and customers cannot have access to and buy the product.

    T: Display
    F: Do not display
    selling

    whether selling

    Whether the product is for sale.
    If the product is archived while being displayed on the store, the product is marked as [out-of-stock] and customers cannot buy it.
    If the product is for sale while not on display, customers still cannot buy it as they do not have access to it.

    T: Sell
    F: Do not sell
    product_condition

    Product condition

    Condition of the product

    N: New
    B: Returned
    R: Off-season
    U: Preowned
    E: Display model
    F: Refurbished
    S: Scratched
    product_used_month

    Max : [2147483647]

    Months of using the used product
    summary_description

    Max Length : [255]

    Product Summary Description

    Summary description of the product. It is displayed on the product layout page. Can be entered in HTML format. You can choose to show or hide the product summary in [Products>Product data display>Settings].
    product_tag

    Product tag

    Search terms for searching or categorizing products (hashtags)
    price_content

    Max Length : [20]

    Alternative phrase of the selling price

    Text that replaces price. Can be used when a product is temporarily out-of-stock or unavailable.
    buy_limit_by_product

    whether purchase restriction individual setting

    T: use
    F: do not use
    buy_limit_type

    Purchase limitation

    Whether or not to restrict purchase from guest accounts

    N: Purchase is only available to customer accounts + Buy button is hidden
    M: Purchase is only available to customer accounts + Buy button is shown
    F: No purchase restrictions
    O: Purchase is only available to specific customer accounts + Buy button is hidden
    D: Purchase is only available to specific customer accounts + Buy button is shown
    buy_group_list

    customer tiers allowed to purchase the relevant product
    buy_member_id_list

    Authorized customer ID
    repurchase_restriction

    repurchase restriction

    T : restrict repurchase
    F : do not restrict repurchase
    single_purchase_restriction

    single purchase restriction

    T : restrict single purchase
    F : do not restrict on single purchase
    points_by_product

    whether use mileage individual setting

    F : use default setting
    T : individual setting
    points_setting_by_payment

    mileage individual setting - lower level item > basic setting mileage or mileage setting according to payment method

    B : Use the default reserve setting
    C : Earn based on the payment method
    points_amount

    Mileage setting
    except_member_points

    Mileage exception

    T : exclude setting an additional mileage accumulation for member group
    F : do not setting an additional mileage accumulation for member group
    adult_certification

    Age verification

    Whether the product requires adult certification. Customer needs to be authenticated to purchase products that require adult certification.

    T: Used
    F: Not used
    detail_image

    Detail image

    Detail image' showing on the product detail page.
    list_image

    List image

    List image' showing on the product category page, main page, product search result page.
    tiny_image

    Tiny list image height

    Small list image' showing on the recently viewed page.
    small_image

    Reduced image

    Reduced image' showing on the bottom side of the product detail page.
    use_naverpay

    whether use Naver Pay

    T: Used
    F: Not used
    naverpay_type

    Naver Pay sales type

    C : Naver Pay + Shopping Mall Products at the same time
    O : Naver Pay only products
    icon_show_period

    Period for showing icon

    Period for showing icon.
    icon

    Array Max : [5]

    List of icon

    Icon displays at the product. This icon can use a purpose of emphsize selling.
    hscode

    HS code

    HS code used for customs duties when shipped overseas. Must enter the correct number for international shipment clearance.

    ※ HScode : The Harmonized Commodity Description and Coding System, also known as the Harmonized System (HS) of tariff nomenclature is an internationally standardized system of names and numbers to classify traded products. It came into effect in 1988 and has since been developed and maintained by the World Customs Organization (WCO) (formerly the Customs Co-operation Council), an independent intergovernmental organization based in Brussels, Belgium, with over 200 member countries.
    product_weight

    Weight of product

    Weight of whole product. Total weight including product, box, and packing weight is necessary for shipping.
    product_material

    Material of product

    The material of the item. You should enter each material and percentage of composing material if the product is has a multiple material.
    created_date

    timezone

    Created date

    Date when product registered.
    updated_date

    timezone

    Updated date

    Date when product modified.
    english_product_material

    English product material

    English version of a material of product. When you using an overseas delivery company, you may be required information of a material of the clothes.
    cloth_fabric

    Fabric of product

    In case cloth products using a Japanese courier service, material information may required for some shipping companies.

    woven: Woven
    knit: Knit
    list_icon

    Recommend / sold out / new icon expose flag

    Either showing recommend / sold out / new icon will be exposed or not.

    ※ sold out icon

    ● Showing that the product is sold out
    ● Displays out of stock if mall using stock management function

    ※ recommend / new icon

    ● If the item is displayed in the area of category or the recommendation product on the main page or new product, shows the icon as it set.
    sold_out

    Whether sold out or stock is available

    T: Out-of-stock
    F: No out-of-stock
    discountprice

    Product discount sale price Resource


    Can search with using embed parameter.
    decorationimages

    Decoration Image Resource


    Can search with using embed parameter.
    benefits

    Benefits Resource


    Can search with using embed parameter.
    additionalimages

    Array Max : [20]

    additional image resource


    Can search with using embed parameter.
    exposure_limit_type

    types of customers allowed to view the relevant product

    A: display to all
    M: display to customers only
    exposure_group_list

    customer tiers allowed to view the relevant product
    bundle_product_sales

    bundle discount information
    category

    Category number

    Category of the product. Product is marked with this category.
    project_no

    planned exhibition number
    description

    Detail description of product

    Detail description of product. You may input description with HTML.
    mobile_description

    Mobile version of product description

    Mobile version of product description. Replace product description to the mobile version when customer access a mobile shopping mall.
    separated_mobile_description

    add mobile version

    T: add mobile version product details
    F: apply PC version product details
    additional_image

    Array Max : [20]

    Additional image

    'Additional image' showing on the bottom side of the product detail page. Displayed at similar location with 'Reduced image' and can see 'Additional image' when mouse over at PC version or swipe at mobile version.
    payment_info

    Payment info

    Guidance for payment method. You may input this with HTML.
    shipping_info

    Shipping info

    Guidance for shipping method. You may input this with HTML.
    exchange_info

    Exchange info

    Guidance for exchange and return method. You may input this with HTML.
    service_info

    Service info

    Guidance for service warranty information. You may input this with HTML.
    country_hscode

    HS code by country

    HS code used for customs duties when shipped overseas. You must enter the correct number for international shipment clearance.
    Since the HS code standard differs from country to country, it is necessary to input the code according to the country.
    simple_description

    Simple Product Description

    Simple description of product. Can Exposed at product display screen. You may input description with HTML.
    shipping_calculation

    Shipping calculation type

    A: Auto M: Manual
    shipping_fee_by_product

    Shipping fee by product

    Set whether shipping fee will be charged separately or commonly.
    If this set as FALSE, shipping fee will be charged commonly.

    T: Used
    F: Not used
    shipping_method

    Shipping method

    Following is the method when 'individual_delivery' is TRUE

    01: regular delivery
    02: fast service (document only)
    03: regular mail (document only)
    04: delivery in person
    05: delivery in person with bike or truck (within several hours)
    06: other
    07: cargo delivery
    08: pickup at a store
    09: delivery does not necessary
    prepaid_shipping_fee

    Whether prepaid shipping fee

    C: Pay after delivery
    P: Prepaid
    B: Select Prepaid/Pay after delivery
    shipping_period

    Shipping period

    (When using 'Shipping charge individually') Average transit time for make a delivery.
    shipping_scope

    Shipping information

    Shows whether can only deliver domestically or can deliver to overseas too.

    Cannot set the type when 'Shipping charge individually' is FALSE.

    A: Domestic only
    C: Export only
    B: Can deliver both inland and overseas
    shipping_area

    Max Length : [255]

    Shipping area

    (When using 'Shipping charge individually') Available shipping region.
    shipping_fee_type

    Shipping charge

    (When using 'Shipping charge individually') Type of shipping charge.

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity
    shipping_rates

    Charge shipping by section

    If shipping_fee_type is R or N, you can set the shipping cost by defining shipping_fee in the array.

    If shipping_fee_type is M, D, W, C, you can set the shipping interval by defining the following in the array.
    shipping_rates_min: Shipping interval start
    shipping_rates_max: Shipping interval end
    shipping_fee: shipping
    clearance_category_eng

    English name of product

    Product classification information to use for the purpose of overseas customs clearance.

    'clearance category kor' will be automatically translated into English.

    The translated English product name will be sent in the name of the overseas invoice.
    clearance_category_kor

    Korean product category for overseas customs clearance

    Product name as Korean
    clearance_category_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Clearance category code
    additional_information

    Additional information list

    You may add additional information other than basic information.
    image_upload_type

    Image type

    Image type when uploading image.

    The uploaded detail image would resized and set as list image, small list image, reduced image when you set the image as "Representative image"

    The uploaded detail image would neither resized or set as list image, small list image, reduced image when you set the image as "Individual image"

    ※ EC Global can not use C because it does not support FTP

    A: Register a representative image.
    B: Register an individual image.
    C: Register through Web FTP.
    main

    whether display at main

    Displays main display number when display products at main page such as "recommend product" or "new".
    relational_product

    Array Max : [200]

    Related product

    Related or similar product of selected product. Registered related product display the bottom of the product detail page.
    memos

    Memos Resource


    Can search with using embed parameter.
    hits

    Product hits Resource


    Can search with using embed parameter.
    seo

    Product Seo Resource


    Can search with using embed parameter.
    tags

    Product Tag Resource


    Can search with using embed parameter.

    Retrieve a list of bundles

    GET /api/v2/admin/bundleproducts

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    discountprice
    embed

    Product discount sale price Resource


    Can search with using embed parameter.

    decorationimages
    embed

    Decoration Image Resource


    Can search with using embed parameter.

    benefits
    embed

    Benefits Resource


    Can search with using embed parameter.

    additionalimages
    embed

    additional image resource


    Can search with using embed parameter.

    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no

    Product number

    Number of a product.

    You can search multiple item with ,(comma)

    display

    Whether display

    T: Display
    F: Do not display

    selling

    whether selling

    T: Sell
    F: Do not sell

    product_code

    Product code

    You can search multiple item with ,(comma)

    product_tag

    Product tag

    You can search multiple item with ,(comma)

    custom_product_code

    Custom product code

    You can search multiple item with ,(comma)

    product_name

    Product name

    You can search multiple item with ,(comma)

    eng_product_name

    English name of product

    You can search multiple item with ,(comma)

    supply_product_name

    Supplier product name

    You can search multiple item with ,(comma)

    internal_product_name

    internal product name

    You can search multiple item with ,(comma)

    model_name

    Model name

    You can search multiple item with ,(comma)

    price_min

    Minimum price

    price_max

    Maximum price

    created_start_date

    timezone

    Registered date start

    created_end_date

    timezone

    Registered date end

    updated_start_date

    timezone

    Updated date start

    updated_end_date

    timezone

    Updated date end

    category

    Category number

    category_unapplied

    Unapplied Category

    T : Search for products that category unapplied

    include_sub_category

    include sub category

    T: Included

    product_weight

    Weight of product

    additional_information_key

    additional information key

    additional_information_value

    additional information value

    sort

    Sort order

    created_date: Created Date
    updated_date: Updated Date
    product_name: Product Name

    order

    Order by

    asc: Ascending
    desc: Descending

    offset

    Max : [8000]

    Start location of list

    Set the start location of search result.

    DEFAULT 0

    limit

    Min : [1]~Max : [100]

    Limit

    Set the maximum number of search result.
    Example) input '10' shows only '10' result

    DEFAULT 10

    Retrieve a bundle

    GET /api/v2/admin/bundleproducts/{product_no}

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    Number of a product.

    discountprice
    embed

    Product discount sale price Resource


    Can search with using embed parameter.

    decorationimages
    embed

    Decoration Image Resource


    Can search with using embed parameter.

    benefits
    embed

    Benefits Resource


    Can search with using embed parameter.

    memos
    embed

    Memos Resource


    Can search with using embed parameter.

    hits
    embed

    Product hits Resource


    Can search with using embed parameter.

    seo
    embed

    Product Seo Resource


    Can search with using embed parameter.

    tags
    embed

    Product Tag Resource


    Can search with using embed parameter.

    additionalimages
    embed

    additional image resource


    Can search with using embed parameter.

    Retrieve a bundle
    Request Copy
    Response Copy

    Create a bundle

    POST /api/v2/admin/bundleproducts

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_name
    Required

    Max Length : [250]

    Product name

    Name of product.

    bundle_product_components
    Required

    composite product information

    product_no
    Required
    composite product number

    purchase_quantity
    Required
    number of purchased bundles
    bundle_product_sales
    Required

    bundle discount information

    discount_value
    Required
    bundle discount price

    discount_type
    Required
    bundle discount type
    P: percentage-based
    V: fixed price-based

    discount_round_unit
    bundle discount round-off unit
    F: no round-off
    -2: to the nearest hundredth
    -1: to the nearest tenth
    0: to the nearest one
    1: to the nearest ten
    2: to the nearest hundred
    3: to the nearest thousand

    discount_round_type
    bundle discount round-off method
    F: round down
    R: round off
    C: round up
    display

    Whether display

    Whether display or not.

    T: Display
    F: Do not display

    DEFAULT F

    add_category_no

    Category no

    Register your product in the category you want to display using the category number

    category_no
    Required
    category number

    recommend
    whether a product is added to a recommended product category
    T: added
    F: not added
    DEFAULT F

    new
    whether a product is added to a new product category
    T: added
    F: not added
    DEFAULT F
    custom_product_code

    Max Length : [40]

    Custom product code

    You may assign this code manually in case of stock management or other reasons.

    eng_product_name

    Max Length : [250]

    English name of product

    Name of product in english.

    supply_product_name

    Max Length : [250]

    Supplier product name

    internal_product_name

    Max Length : [50]

    internal product name

    model_name

    Max Length : [100]

    Model name

    Model name of product.

    use_naverpay

    whether use Naver Pay

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    naverpay_type

    Naver Pay sales type

    This cannot be used on Cafe24 Vietnam, Philippines.

    C : Naver Pay + Shopping Mall Products at the same time
    O : Naver Pay only products

    product_weight

    Min : [0]~Max : [999999.99]

    Weight of product

    description

    Detail description of product

    Detailed description of product.

    mobile_description

    Mobile version of product description

    Mobile version of product description. Replace product description to the mobile version when customer access a mobile shopping mall.

    summary_description

    Max Length : [255]

    Product Summary Description

    simple_description

    Simple Product Description

    product_tag

    Array Max : [50]

    Product tag

    Tag for search product.

    payment_info

    Payment info

    Payment method guidance.

    shipping_info

    Shipping info

    Shipping method guidance.

    exchange_info

    Exchange info

    Exchange/return method guidance.

    service_info

    Service info

    Service query / information guidance.

    icon

    Array Max : [5]

    List of icon

    Register icon.

    hscode

    Max Length : [20]

    HS code

    Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping)

    shipping_scope

    Shipping information

    Shows whether can only deliver domestically or can deliver to overseas too.

    Cannot set the type when 'Shipping charge individually' is FALSE.

    ※ Must required "C" in EC Global shopping mall.

    This cannot be used on Cafe24 Vietnam, Philippines.

    A: Domestic only
    C: Export only
    B: Can deliver both inland and overseas

    DEFAULT A

    shipping_method

    Shipping method

    Shipping method(when shipping individually).

    01: regular delivery
    02: fast service (document only)
    03: regular mail (document only)
    04: delivery in person
    05: delivery in person with bike or truck (within several hours)
    06: other
    07: cargo delivery
    08: pickup at a store
    09: delivery does not necessary

    DEFAULT 01

    shipping_fee_by_product

    Shipping fee by product

    Shipping charge individually.

    T: Individual delivery
    F: Standard delivery

    DEFAULT F

    shipping_area

    Max Length : [255]

    Shipping area

    Shipping area.

    shipping_period

    Array Max : [2]

    Shipping period

    Transit time.

    minimum
    minimum date range
    DEFAULT 1

    maximum
    maximum date range
    DEFAULT 7
    shipping_fee_type

    Shipping charge

    Shipping charge. Type of shipping charge when using 'Shipping charge individually'.

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity

    DEFAULT T

    shipping_rates

    Array Max : [200]

    Shipping rates

    If shipping_fee_type is R or N, you can set the shipping cost by defining shipping_fee in the array.

    If shipping_fee_type is M, D, W, C, you can set the shipping interval by defining the following in the array.
    shipping_rates_min: Shipping interval start
    shipping_rates_max: Shipping interval end
    shipping_fee: shipping

    prepaid_shipping_fee

    Whether prepaid shipping fee

    This cannot be used on Cafe24 Vietnam, Philippines.

    C: Pay after delivery
    P: Prepaid
    B: Select Prepaid/Pay after delivery

    DEFAULT B

    clearance_category_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Clearance category code

    Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping)
    clearance_category_code

    detail_image

    Detail image

    Detail image.

    list_image

    List image

    List image.

    tiny_image

    Tiny list image height

    small_image

    Reduced image

    image_upload_type

    Image type

    Image type.

    ※ EC Global can not use C because it does not support FTP

    A: Register a representative image.
    B: Register an individual image.
    C: Register through Web FTP.

    DEFAULT A

    additional_information

    Additional information list

    Additional item.

    key
    Required
    Additional field key

    value
    Additional field value
    price_content

    Max Length : [20]

    Alternative phrase of the selling price

    buy_limit_by_product

    whether purchase restriction individual setting

    T: use
    F: do not use

    DEFAULT F

    buy_limit_type

    Purchase limitation

    N: Purchase is only available to customer accounts + Buy button is hidden
    M: Purchase is only available to customer accounts + Buy button is shown
    F: No purchase restrictions
    O: Purchase is only available to specific customer accounts + Buy button is hidden
    D: Purchase is only available to specific customer accounts + Buy button is shown

    DEFAULT F

    buy_group_list

    customer tiers allowed to purchase the relevant product

    buy_member_id_list

    Authorized customer ID

    repurchase_restriction

    repurchase restriction

    T : restrict repurchase
    F : do not restrict repurchase

    DEFAULT F

    single_purchase_restriction

    single purchase restriction

    T : restrict single purchase
    F : do not restrict on single purchase

    DEFAULT F

    points_by_product

    whether use mileage individual setting

    F : use default setting
    T : individual setting

    DEFAULT F

    points_setting_by_payment

    mileage individual setting - lower level item > basic setting mileage or mileage setting according to payment method

    B : Use the default reserve setting
    C : Earn based on the payment method

    points_amount

    Mileage setting

    except_member_points

    Mileage exception

    T : exclude setting an additional mileage accumulation for member group
    F : do not setting an additional mileage accumulation for member group

    DEFAULT F

    main

    whether display at main

    Displays main display number when display products at main page such as "recommend product" or "new".

    relational_product

    Array Max : [200]

    Related product

    Related or similar product of selected product. Registered related product display the bottom of the product detail page.

    product_no
    Required
    Product number

    interrelated
    Required
    whether a related product as one-way or two-way
    T: one-way
    F: two-way
    product_material

    Material of product

    The material of the item. You should enter each material and percentage of composing material if the product is has a multiple material.

    english_product_material

    English product material

    English version of a material of product. When you using an overseas delivery company, you may be required information of a material of the clothes.

    cloth_fabric

    Fabric of product

    In case cloth products using a Japanese courier service, material information may required for some shipping companies.

    woven: Woven
    knit: Knit

    additional_image

    Additional image

    Additional image' showing on the bottom side of the product detail page. Displayed at similar location with 'Reduced image' and can see 'Additional image' when mouse over at PC version or swipe at mobile version.

    Up to 20 'Additional image' can be uploaded.

    adult_certification

    Age verification

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    DEFAULT F

    exposure_limit_type

    types of customers allowed to view the relevant product

    A: display to all
    M: display to customers only

    DEFAULT A

    exposure_group_list

    customer tiers allowed to view the relevant product

    Create a bundle
    Request Copy
    Response Copy

    Update a bundle

    PUT /api/v2/admin/bundleproducts/{product_no}

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    product_name

    Max Length : [250]

    Product name

    Name of product.

    bundle_product_components

    composite product information

    product_no
    Required
    composite product number

    purchase_quantity
    Required
    number of purchased bundles
    bundle_product_sales

    bundle discount information

    discount_value
    Required
    bundle discount price

    discount_type
    Required
    bundle discount type
    P: percentage-based
    V: fixed price-based

    discount_round_unit
    bundle discount round-off unit
    F: no round-off
    -2: to the nearest hundredth
    -1: to the nearest tenth
    0: to the nearest one
    1: to the nearest ten
    2: to the nearest hundred
    3: to the nearest thousand

    discount_round_type
    bundle discount round-off method
    F: round down
    R: round off
    C: round up
    display

    Whether display

    You can choose product should be displayed or not.

    T: Display
    F: Do not display

    product_condition

    Product condition

    N: New
    B: Returned
    R: Off-season
    U: Preowned
    E: Display model
    F: Refurbished
    S: Scratched

    product_used_month

    Max : [2147483647]

    Months of using the used product

    Used month for the product when product_condition is used product.

    add_category_no

    Category no

    Enter a category number to add a specific product category to the product

    category_no
    Required
    category number

    recommend
    whether a product is added to a recommended product category
    T: added
    F: not added
    DEFAULT F

    new
    whether a product is added to a new product category
    T: added
    F: not added
    DEFAULT F
    delete_category_no

    Deleted classification number

    Enter a category number to delete a specific product category to the product

    custom_product_code

    Max Length : [40]

    Custom product code

    You may assign this code manually in case of stock management or other reasons.

    eng_product_name

    Max Length : [250]

    English name of product

    Name of product in english.

    supply_product_name

    Max Length : [250]

    Supplier product name

    internal_product_name

    Max Length : [50]

    internal product name

    model_name

    Max Length : [100]

    Model name

    Model name of product.

    use_naverpay

    whether use Naver Pay

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    naverpay_type

    Naver Pay sales type

    This cannot be used on Cafe24 Vietnam, Philippines.

    C : Naver Pay + Shopping Mall Products at the same time
    O : Naver Pay only products

    product_weight

    Min : [0]~Max : [999999.99]

    Weight of product

    description

    Detail description of product

    Detailed description of product.

    mobile_description

    Mobile version of product description

    Mobile version of product description. Replace product description to the mobile version when customer access a mobile shopping mall.

    summary_description

    Max Length : [255]

    Product Summary Description

    Summary description of product.

    simple_description

    Simple Product Description

    Simple description of product.

    product_tag

    Array Max : [50]

    Product tag

    Tag for search product.

    payment_info

    Payment info

    Payment method guidance.

    shipping_info

    Shipping info

    Shipping method guidance.

    exchange_info

    Exchange info

    Exchange/return method guidance.

    service_info

    Service info

    Service query / information guidance.

    icon

    Array Max : [5]

    List of icon

    Register icon.

    use_icon_exposure_term

    whether use show date

    T: Used
    F: Not used

    icon_exposure_begin_datetime

    start date of show_date

    icon_exposure_end_datetime

    end date of show_date

    hscode

    Max Length : [20]

    HS code

    Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping)

    shipping_scope

    Shipping information

    Shows whether can only deliver domestically or can deliver to overseas too.

    Cannot set the type when 'Shipping charge individually' is FALSE.

    This cannot be used on Cafe24 Vietnam, Philippines.

    A: Domestic only
    C: Export only
    B: Can deliver both inland and overseas

    prepaid_shipping_fee

    Whether prepaid shipping fee

    This cannot be used on Cafe24 Vietnam, Philippines.

    C: Pay after delivery
    P: Prepaid
    B: Select Prepaid/Pay after delivery

    shipping_method

    Shipping method

    Shipping method(when shipping individually).

    01: regular delivery
    02: fast service (document only)
    03: regular mail (document only)
    04: delivery in person
    05: delivery in person with bike or truck (within several hours)
    06: other
    07: cargo delivery
    08: pickup at a store
    09: delivery does not necessary

    shipping_fee_by_product

    Shipping fee by product

    Shipping charge individually.

    T: Individual delivery
    F: Standard delivery

    shipping_area

    Max Length : [255]

    Shipping area

    Shipping area.

    shipping_period

    Array Max : [2]

    Shipping period

    Transit time.

    minimum
    minimum date range
    DEFAULT 1

    maximum
    maximum date range
    DEFAULT 7
    shipping_fee_type

    Shipping charge

    Shipping charge. Type of shipping charge when using 'Shipping charge individually'.

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity

    shipping_rates

    Shipping rates

    If shipping_fee_type is R or N, you can set the shipping cost by defining shipping_fee in the array.

    If shipping_fee_type is M, D, W, C, you can set the shipping interval by defining the following in the array.
    shipping_rates_min: Shipping interval start
    shipping_rates_max: Shipping interval end
    shipping_fee: shipping

    clearance_category_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Clearance category code

    Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping)
    clearance_category_code

    detail_image

    Detail image

    Detail image.

    list_image

    List image

    List image.

    tiny_image

    Tiny list image height

    Reduced image.

    small_image

    Reduced image

    Small list image.

    image_upload_type

    Image type

    Image type.

    ※ EC Global can not use C because it does not support FTP

    A: Register a representative image.
    B: Register an individual image.
    C: Register through Web FTP.

    additional_information

    Additional information list

    Additional item.

    key
    Required
    Additional field key

    value
    Additional field value
    price_content

    Max Length : [20]

    Alternative phrase of the selling price

    buy_limit_by_product

    whether purchase restriction individual setting

    T: use
    F: do not use

    buy_limit_type

    Purchase limitation

    N: Purchase is only available to customer accounts + Buy button is hidden
    M: Purchase is only available to customer accounts + Buy button is shown
    F: No purchase restrictions
    O: Purchase is only available to specific customer accounts + Buy button is hidden
    D: Purchase is only available to specific customer accounts + Buy button is shown

    buy_group_list

    customer tiers allowed to purchase the relevant product

    buy_member_id_list

    Authorized customer ID

    repurchase_restriction

    repurchase restriction

    T : restrict repurchase
    F : do not restrict repurchase

    single_purchase_restriction

    single purchase restriction

    T : restrict single purchase
    F : do not restrict on single purchase

    points_by_product

    whether use mileage individual setting

    F : use default setting
    T : individual setting

    points_setting_by_payment

    mileage individual setting - lower level item > basic setting mileage or mileage setting according to payment method

    B : Use the default reserve setting
    C : Earn based on the payment method

    points_amount

    Mileage setting

    except_member_points

    Mileage exception

    T : exclude setting an additional mileage accumulation for member group
    F : do not setting an additional mileage accumulation for member group

    main

    whether display at main

    Displays main display number when display products at main page such as "recommend product" or "new".

    relational_product

    Array Max : [200]

    Related product

    Related or similar product of selected product. Registered related product display the bottom of the product detail page.

    product_no
    Product number

    interrelated
    Required
    whether a related product as one-way or two-way
    T: one-way
    F: two-way
    product_material

    Material of product

    The material of the item. You should enter each material and percentage of composing material if the product is has a multiple material.

    english_product_material

    English product material

    English version of a material of product. When you using an overseas delivery company, you may be required information of a material of the clothes.

    cloth_fabric

    Fabric of product

    In case cloth products using a Japanese courier service, material information may required for some shipping companies.

    woven: Woven
    knit: Knit

    additional_image

    Additional image

    Additional image' showing on the bottom side of the product detail page. Displayed at similar location with 'Reduced image' and can see 'Additional image' when mouse over at PC version or swipe at mobile version.

    Up to 20 'Additional image' can be uploaded.

    adult_certification

    Age verification

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    exposure_limit_type

    types of customers allowed to view the relevant product

    A: display to all
    M: display to customers only

    exposure_group_list

    customer tiers allowed to view the relevant product

    Delete a bundle

    DELETE /api/v2/admin/bundleproducts/{product_no}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Delete a bundle
    Request Copy
    Response Copy

    Categories products

    A relational resource that lets you retrieve or update product display order or general display settings.

    Endpoints 
    GET /api/v2/admin/categories/{category_no}/products
GET /api/v2/admin/categories/{category_no}/products/count
POST /api/v2/admin/categories/{category_no}/products
PUT /api/v2/admin/categories/{category_no}/products
DELETE /api/v2/admin/categories/{category_no}/products/{product_no}

    Categories products properties

    Attribute Description
    shop_no

    Shop Number
    product_no

    Product number

    System assigned code. This code cannot be duplicated.
    sequence_no

    display order
    auto_sort

    whether to use automatic sorting
    sold_out

    Whether sold out or stock is available
    fixed_sort

    whether fixed
    not_for_sale

    whether not for sale
    display_group

    Min : [1]~Max : [3]

    detailed product category

    1 : Regular product
    2 : Recommend product
    3 : New product

    DEFAULT 1
    sequence

    Min : [1]~Max : [999998]

    Display order

    Retrieve a list of products by category

    GET /api/v2/admin/categories/{category_no}/products

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    category_no
    Required

    Category number

    display_group
    Required

    Min : [1]~Max : [3]

    detailed product category

    1 : Regular product
    2 : Recommend product
    3 : New product

    limit

    Min : [1]~Max : [50000]

    Limit

    DEFAULT 50000

    Retrieve a count of products by category

    GET /api/v2/admin/categories/{category_no}/products/count

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    category_no
    Required

    Category number

    display_group
    Required

    Min : [1]~Max : [3]

    detailed product category

    1 : Regular product
    2 : Recommend product
    3 : New product

    Retrieve a count of products by category
    Request Copy
    Response Copy

    Add products to a category

    POST /api/v2/admin/categories/{category_no}/products

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    category_no
    Required

    Category number

    display_group

    Min : [1]~Max : [3]

    detailed product category

    1 : Regular product
    2 : Recommend product
    3 : New product

    DEFAULT 1

    product_no
    Required

    Product number

    Add products to a category
    Request Copy
    Response Copy

    Update a product in product category

    PUT /api/v2/admin/categories/{category_no}/products

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    category_no
    Required

    Category number

    display_group
    Required

    Min : [1]~Max : [3]

    detailed product category

    1 : Regular product
    2 : Recommend product
    3 : New product

    product_no
    Required

    Product number

    sequence

    Min : [1]~Max : [999999]

    Display order

    auto_sort

    whether to use automatic sorting

    T : Use automatic arrangement
    F : Do not use automatic arrangement

    fixed_sort

    whether fixed

    T : Use designated display order
    F : Do not use designated display order

    Update a product in product category
    Request Copy
    Response Copy

    Delete a product by category

    DELETE /api/v2/admin/categories/{category_no}/products/{product_no}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    category_no
    Required

    Category number

    product_no
    Required

    Product number

    display_group

    Min : [1]~Max : [3]

    detailed product category

    If a product is marked as [Not on display], it will not be displayed in new products or recommeded products section as well.

    1 : Regular product
    2 : Recommend product
    3 : New product

    DEFAULT 1

    Delete a product by category
    Request Copy
    Response Copy

    Mains products

    A relational resource to the Mains resource about main category products’ display order.

    Endpoints 
    GET /api/v2/admin/mains/{display_group}/products
GET /api/v2/admin/mains/{display_group}/products/count
POST /api/v2/admin/mains/{display_group}/products
PUT /api/v2/admin/mains/{display_group}/products
DELETE /api/v2/admin/mains/{display_group}/products/{product_no}

    Mains products properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    product_no

    Product number
    product_name

    Product name
    fixed_sort

    whether fixed

    Retrieve a list of products in main category

    GET /api/v2/admin/mains/{display_group}/products

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    display_group
    Required

    main category number

    Retrieve a count of products in main category

    GET /api/v2/admin/mains/{display_group}/products/count

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    display_group
    Required

    main category number

    Retrieve a count of products in main category
    Request Copy
    Response Copy

    Set main category products

    POST /api/v2/admin/mains/{display_group}/products

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    display_group
    Required

    main category number

    product_no
    Required

    Product number

    Set main category products
    Request Copy
    Response Copy

    Update fixed sorting of products in main category

    PUT /api/v2/admin/mains/{display_group}/products

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    display_group
    Required

    main category number

    product_no
    Required

    Product number

    Rank of product display will designated for requested order.

    fix_product_no

    Fixed product number

    Designate product for fixed rank.

    Update fixed sorting of products in main category
    Request Copy
    Response Copy

    Delete a product in main category

    DELETE /api/v2/admin/mains/{display_group}/products/{product_no}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    display_group
    Required

    main category number

    product_no
    Required

    Product number

    Delete a product in main category
    Request Copy
    Response Copy

    Products



    Product' represents goods that sells at shopping mall. Product API can register, search, modify, and delete product. (delete function will be provide.)

    Products has the following Resource as embedded Resource:
    ● Variants
    ● Hits
    ● Memos
    ● SEO

    Endpoints 
    GET /api/v2/admin/products
GET /api/v2/admin/products/count
GET /api/v2/admin/products/{product_no}
POST /api/v2/admin/products
PUT /api/v2/admin/products/{product_no}
DELETE /api/v2/admin/products/{product_no}

    Products properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    product_no

    Product number

    System assigned code. This code cannot be duplicated.
    product_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Product code

    System assigned code. This code cannot be duplicated.
    custom_product_code

    Max Length : [40]

    Custom product code

    You may assign this code manually in case of stock management or other reasons.
    product_name

    Max Length : [250]

    Product name

    Name of product. Basic information to search the product and seperate each product. You may input this with HTML.
    eng_product_name

    Max Length : [250]

    English name of product

    English name of product. Necessary when shipping to abroad.
    supply_product_name

    Max Length : [250]

    Supplier product name

    Supplier registered name of the product. Supplier may assign this name manually for some reasons. This name does not affect "Name of product".
    internal_product_name

    Max Length : [50]

    internal product name
    model_name

    Max Length : [100]

    Model name

    Model name of product
    price_excluding_tax

    product price (before VAT)
    price

    Product price

    Selling price. Price that before applying coupon or other benefits.

    At the time of product create, all multi-shopping mall's products have the same price. If you want to enter a different price for each multi-shopping mall, you can enter the price differently by modifying the product.

    ※ Price of product when automatically calculated = [ Value of supply + (Value of supply * Rate of margin) + addtional cost ]
    retail_price

    Product retail price

    General price of the product in market. This is used to compare the price of a shopping mall and to emphasize the price of a shopping mall.
    supply_price

    Product supply price

    Value of supply. You may calculate price using "supply_price" and "margin_rate".
    display

    Whether display

    User can choose product should be displayed or not. If product is not displayed, customer can't access product thus cannot buy the product.

    T: Display
    F: Do not display
    selling

    whether selling

    User can choose product status should be selling or not. If product is not selling, customer can still access product but cannot buy the product since the product will be displayed as "Sold out".

    If display is FALSE and selling is TRUE, customer can't access product thus cannot buy the product.

    T: Sell
    F: Do not sell
    product_condition

    Product condition

    Displays condition of product

    N: New
    B: Returned
    R: Off-season
    U: Preowned
    E: Display model
    F: Refurbished
    S: Scratched
    product_used_month

    Max : [2147483647]

    Months of using the used product
    summary_description

    Max Length : [255]

    Product Summary Description

    Summary description of product. Can Exposed at product display screen. You may input description with HTML.
    product_tag

    Array Max : [50]

    Product tag

    Search tags.
    margin_rate

    Min : [-999.99]~Max : [999.99]

    Margin rate

    Rate of margin. You may calculate price using "supply_price" and "margin_rate". In API, margin rate is used only for reperence purpose only.
    tax_calculation

    Tax calculation type

    A: Auto M: Manual
    tax_type

    Taxation category

    Tax type information of product.

    Tax product : VAT, Sales tax, or other tax is included

    Tax free product : Tax free product such as un-processed agriculture products, fishery products, animal products, books, or etc.

    Products for tax free may differ from country to country.

    Zero tax product : Applicable as 0% rate of VAT.

    A: Taxable goods
    B: Duty-free goods
    C: Small goods
    tax_rate

    Min : [0]~Max : [100]

    Tax rate
    price_content

    Max Length : [20]

    Alternative phrase of the selling price

    Price will be replaced by this text when sold-out or unavailable for some reasons.
    buy_limit_by_product

    whether purchase restriction individual setting

    T: use
    F: do not use
    buy_limit_type

    Purchase limitation

    Limit purchase as below information.

    N: Purchase is only available to customer accounts + Buy button is hidden
    M: Purchase is only available to customer accounts + Buy button is shown
    F: No purchase restrictions
    O: Purchase is only available to specific customer accounts + Buy button is hidden
    D: Purchase is only available to specific customer accounts + Buy button is shown
    buy_group_list

    customer tiers allowed to purchase the relevant product
    buy_member_id_list

    Authorized customer ID
    repurchase_restriction

    repurchase restriction

    T : restrict repurchase
    F : do not restrict repurchase
    single_purchase_restriction

    single purchase restriction

    T : restrict single purchase
    F : do not restrict on single purchase
    buy_unit_type

    Type of Purchase unit

    If the purchase unit of the product is set to 1 or more, the setting of whether the purchase unit is the item unit or the product unit

    P: Based on product
    O: Based on quantity
    buy_unit

    Minimum unit per purchase

    Minimum unit per purchase.

    Ex ) If product's minimum unit per purchase is 3, customer can only buy the product as multiple number of 3.
    order_quantity_limit_type

    Criteria of order quantity restriction

    If you limit the order quantity of the product, you can set whether the limit should be based on item or product unit.

    P: Based on product
    O: Based on quantity
    minimum_quantity

    Max : [2147483647]

    Minimum quantity per purchase

    Minimum quantity per purchase. Customer cannot buy the product below the minimum quantity.
    maximum_quantity

    Max : [2147483647]

    Maximum quantity per purchase

    Maximum quantity per purchase. Customer cannot buy the product above the maximum quantity.

    If the maximum order quantity is "no limit", it is displayed as "0".
    points_by_product

    individual settings for points

    F : use default setting
    T : individual setting
    points_setting_by_payment

    points settings by payment method

    B : Use the default reserve setting
    C : Earn based on the payment method
    points_amount

    points settings information
    except_member_points

    omit additional points issued based on customer tiers

    T : exclude setting an additional mileage accumulation for member group
    F : do not setting an additional mileage accumulation for member group
    product_volume

    product volume information
    adult_certification

    Age verification

    Whether the product requires adult certification. Customer needs to be authenticated to purchase products that require adult certification.

    T: Used
    F: Not used
    detail_image

    Detail image

    Detail image' showing on the product detail page.
    list_image

    List image

    List image' showing on the product category page, main page, product search result page.
    tiny_image

    Tiny list image height

    Small list image' showing on the recently viewed page.
    small_image

    Reduced image

    Reduced image' showing on the bottom side of the product detail page.
    use_naverpay

    whether use Naver Pay

    T: Used
    F: Not used
    naverpay_type

    Naver Pay sales type

    C : Naver Pay + Shopping Mall Products at the same time
    O : Naver Pay only products
    manufacturer_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Manufacturer code

    Code uses for designate specific manufacturer. This code generated automatically when register a new manufacturer.

    Set as default code(M0000000) if doesn't input.
    trend_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Trend code

    Code uses for designate specific trend. This code generated automatically when register a new trend.

    Set as default code(T0000000) if doesn't input.
    brand_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Brand code

    Code uses for designate specific brand. This code generated automatically when register a new brand.

    Set as default code(B0000000) if doesn't input.
    supplier_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Supplier code

    Code uses for designate specific supplier. This code generated automatically when register a new supplier.
    made_date

    Date of manufacture

    Date of manufacture of the product.
    release_date

    Date of release

    Date of release of the product.
    expiration_date

    Array Max : [2]

    Expiration date

    Indicate the expiration date of intangible goods such as gift certificates or tickets or type goods such as food or cosmetics.
    origin_classification

    Origin classification

    Distinguish the origin of a product.

    F: domestic
    T: abroad
    E: other
    origin_place_no

    Origin place no

    List the origin number List all Origin by API
    If origin_classification is F (domestic), it is possible to enter origin only if foreign (foreign) is "F".
    If origin_classification is T (overseas), it is possible to enter origin only if foreign (foreign) is "T".
    origin_place_value

    Max Length : [30]

    Extra information for code of origin

    You may add additional information if 'origin_place_code' is 1800.
    made_in_code

    Origin country code
    icon_show_period

    Period for showing icon

    Period for showing icon.
    icon

    Array Max : [5]

    List of icon

    Icon displays at the product. This icon can use a purpose of emphsize selling.
    hscode

    HS code

    HS code used for customs duties when shipped overseas. Must enter the correct number for international shipment clearance.

    ※ HScode : The Harmonized Commodity Description and Coding System, also known as the Harmonized System (HS) of tariff nomenclature is an internationally standardized system of names and numbers to classify traded products. It came into effect in 1988 and has since been developed and maintained by the World Customs Organization (WCO) (formerly the Customs Co-operation Council), an independent intergovernmental organization based in Brussels, Belgium, with over 200 member countries.
    product_weight

    Weight of product

    Weight of whole product. Total weight including product, box, and packing weight is necessary for shipping.
    product_material

    Material of product

    The material of the item. You should enter each material and percentage of composing material if the product is has a multiple material.
    created_date

    timezone

    Created date

    Date when product registered.
    updated_date

    timezone

    Updated date

    Date when product modified.
    english_product_material

    English product material

    English version of a material of product. When you using an overseas delivery company, you may be required information of a material of the clothes.
    cloth_fabric

    Fabric of product

    In case cloth products using a Japanese courier service, material information may required for some shipping companies.

    woven: Woven
    knit: Knit
    list_icon

    Recommend / sold out / new icon expose flag

    Either showing recommend / sold out / new icon will be exposed or not.

    ※ sold out icon

    ● Showing that the product is sold out
    ● Displays out of stock if mall using stock management function

    ※ recommend / new icon

    ● If the item is displayed in the area of category or the recommendation product on the main page or new product, shows the icon as it set.
    approve_status

    Approve request result

    N: New request for approval
    E: request for approval updated
    C: Approval complete
    R: Approval rejected
    I: Approval in progress
    Empty Value: Never requested
    classification_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Classification code

    Custom classification code for the purpost of self-classification.

    Default : C000000A
    sold_out

    Whether sold out or stock is available

    T: Out-of-stock
    F: No out-of-stock
    additional_price

    Additional amount of the selling price
    discountprice

    Product discount sale price Resource


    Can search with using embed parameter.
    decorationimages

    Decoration Image Resource


    Can search with using embed parameter.
    benefits

    Benefits Resource


    Can search with using embed parameter.
    options

    Product Option Resource


    Can search with using embed parameter.
    variants

    Variants Resource


    Can search with using embed parameter.
    clearance_category_eng

    English name of product

    Product classification information to use for the purpose of overseas customs clearance.

    'clearance category kor' will be automatically translated into English.

    The translated English product name will be sent in the name of the overseas invoice.
    clearance_category_kor

    Korean product category for overseas customs clearance

    Product name as Korean
    clearance_category_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Clearance category code

    clearance_category_code

    additionalimages

    additional image resource


    Can search with using embed parameter.
    exposure_limit_type

    types of customers allowed to view the relevant product

    A: display to all
    M: display to customers only
    exposure_group_list

    customer tiers allowed to view the relevant product
    set_product_type

    Product bundle type

    C: integral type. S: assembled type
    use_kakaopay

    Whether to use Kakao Pay

    T: Used
    F: Not used
    shipping_fee_by_product

    Shipping fee by product

    Set whether shipping fee will be charged separately or commonly.
    If this set as FALSE, shipping fee will be charged commonly.

    T: Used
    F: Not used
    shipping_fee_type

    Shipping charge

    (When using 'Shipping charge individually') Type of shipping charge.

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity
    main

    whether display at main

    Displays main display number when display products at main page such as "recommend product" or "new".
    memos

    Memos Resource


    Can search with using embed parameter.
    hits

    Product hits Resource


    Can search with using embed parameter.
    seo

    Product Seo Resource


    Can search with using embed parameter.
    category

    Category number

    Category of the product. Product is marked with this category.
    project_no

    planned exhibition number
    description

    Detail description of product

    Detail description of product. You may input description with HTML.
    mobile_description

    Mobile version of product description

    Mobile version of product description. Replace product description to the mobile version when customer access a mobile shopping mall.
    separated_mobile_description

    add mobile version

    T: add mobile version product details
    F: apply PC version product details
    translated_description

    Translation information of product details
    payment_info

    Payment info

    Guidance for payment method. You may input this with HTML.
    shipping_info

    Shipping info

    Guidance for shipping method. You may input this with HTML.
    exchange_info

    Exchange info

    Guidance for exchange and return method. You may input this with HTML.
    service_info

    Service info

    Guidance for service warranty information. You may input this with HTML.
    product_tax_type_text

    Vat tax info

    Displays text set at VAT text setting menu.
    country_hscode

    HS code by country

    HS code used for customs duties when shipped overseas. You must enter the correct number for international shipment clearance.
    Since the HS code standard differs from country to country, it is necessary to input the code according to the country.
    simple_description

    Simple Product Description

    Simple description of product. Can Exposed at product display screen. You may input description with HTML.
    tags

    Product Tag Resource


    Can search with using embed parameter.
    has_option

    Whether the option is used

    Shows product either has an option or not. Product with option offer various choices such as size, color, and flavors.

    T: use option
    F: do not use option
    option_type

    Type of option

    Shows type of option when "has_option" is TRUE.

    ● combination all-selected : Shows combination of 'all options' in 'a single selecbox'(button or radio button).
    ● combination separate-selected : Customer can choose 'options' at 'each selectbox'(button or radio button) and make 'a combination of option' based on 'the name of option'.
    ● linked with product : The way how to show type of option is similar to 'combination types' but this type can choose both 'necessary option' and 'selectable option'. This type can make 'unlimited combinations of options'.
    ● independently selectable : Customer can select 'each indepentent options'. 'Each option' will be generated as 'each variant'.

    C: Combination integration option
    S: Combination separation option
    E: Product connection
    F: Independent selection
    shipping_calculation

    Shipping calculation type

    A: Auto M: Manual
    shipping_method

    Shipping method

    Following is the method when 'individual_delivery' is TRUE

    01: regular delivery
    02: fast service (document only)
    03: regular mail (document only)
    04: delivery in person
    05: delivery in person with bike or truck (within several hours)
    06: other
    07: cargo delivery
    08: pickup at a store
    09: delivery does not necessary
    prepaid_shipping_fee

    Whether prepaid shipping fee

    C: Pay after delivery
    P: Prepaid
    B: Select Prepaid/Pay after delivery
    shipping_period

    Shipping period

    (When using 'Shipping charge individually') Average transit time for make a delivery.
    shipping_scope

    Shipping information

    Shows whether can only deliver domestically or can deliver to overseas too.

    Cannot set the type when 'Shipping charge individually' is FALSE.

    A: Domestic only
    C: Export only
    B: Can deliver both inland and overseas
    shipping_area

    Max Length : [255]

    Shipping area

    (When using 'Shipping charge individually') Available shipping region.
    shipping_rates

    Charge shipping by section

    If shipping_fee_type is R or N, you can set the shipping cost by defining shipping_fee in the array.

    If shipping_fee_type is M, D, W, C, you can set the shipping interval by defining the following in the array.
    shipping_rates_min: Shipping interval start
    shipping_rates_max: Shipping interval end
    shipping_fee: shipping
    origin_place_code

    Code of origin

    Code of origin
    additional_information

    Additional information list

    You may add additional information other than basic information.
    image_upload_type

    Image type

    Image type when uploading image.

    The uploaded detail image would resized and set as list image, small list image, reduced image when you set the image as "Representative image"

    The uploaded detail image would neither resized or set as list image, small list image, reduced image when you set the image as "Individual image"

    ※ EC Global can not use C because it does not support FTP

    A: Register a representative image.
    B: Register an individual image.
    C: Register through Web FTP.
    relational_product

    Array Max : [200]

    Related product

    Related or similar product of selected product. Registered related product display the bottom of the product detail page.
    select_one_by_option

    Whether select only one by option

    When using 'independently selectable' option type and this set as TRUE, customer can select only 1 item per option.
    If this set as FALSE, customer can select multiple items per option.

    ※ This Flag Is Only Available When Using 'Independently Selectable' Option Type.

    T: Use
    F: Do not use
    translated_additional_description

    Translated additional description
    additional_image

    Array Max : [20]

    Additional image

    'Additional image' showing on the bottom side of the product detail page. Displayed at similar location with 'Reduced image' and can see 'Additional image' when mouse over at PC version or swipe at mobile version.

    Retrieve a list of products

    GET /api/v2/admin/products

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    discountprice
    embed

    Product discount sale price Resource


    Can search with using embed parameter.

    decorationimages
    embed

    Decoration Image Resource


    Can search with using embed parameter.

    benefits
    embed

    Benefits Resource


    Can search with using embed parameter.

    options
    embed

    Product Option Resource


    Can search with using embed parameter.

    variants
    embed

    Variants Resource

    Up to 100 variants can be retrieved per product.
    Either custom product code (custom_product_code) or custom variant code (custom_variant_code) is required.
    Can search with using embed parameter.

    additionalimages
    embed

    additional image resource


    Can search with using embed parameter.

    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no

    Product number

    Number of a product.

    You can search multiple item with ,(comma)

    display

    Whether display

    Search for products that displayed or not.

    selling

    whether selling

    Search for products that sell or not.

    product_name

    Product name

    Search for products of which names include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    product_code

    Product code

    Search for products of which product codes include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    brand_code

    Brand code

    Search for products with matching brand codes.

    You can search multiple item with ,(comma)

    manufacturer_code

    Manufacturer code

    Search for products with matching manufacturer code.

    You can search multiple item with ,(comma)

    supplier_code

    Supplier code

    Search for products with matching supplier code.

    You can search multiple item with ,(comma)

    trend_code

    Trend code

    Search for products with matching trend code.

    You can search multiple item with ,(comma)

    product_tag

    Product tag

    Search for products of which product search terms or tags include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    custom_product_code

    Custom product code

    Search for products of which custom product codes include the search query you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    custom_variant_code

    Custom variants code

    You can search multiple item with ,(comma)

    price_min

    Minimum price

    Search for products that price is over a certain range.

    price_max

    Maximum price

    Search for products that price is below a certain range.

    retail_price_min

    Min : [0]
    Max : [2147483647]

    Minimum retail price

    Search for products that retail price is over a certain range.

    retail_price_max

    Min : [0]
    Max : [2147483647]

    Maximim retail price

    Search for products that retail price is below a certain range.

    supply_price_min

    Minimum supply price

    Search for products that supply price is over a certain range.

    supply_price_max

    Maximum supply price

    Search for products that supply price is below a certain range.

    created_start_date

    timezone

    Registered date start

    Search for products added after the search start date. Must be used with a search end date. If the start date is the same as the end date, results will be retrieved based on the date.

    created_end_date

    timezone

    Registered date end

    Search for products added before the search end date. Must be used with a search start date. If the end date is the same as the start date, only results will be retrieved based on the date.

    updated_start_date

    timezone

    Updated date start

    Search for products edited after the search start date. Must be used with a search end date. If the start date is the same as the end date, results will be retrieved based on the date.

    updated_end_date

    timezone

    Updated date end

    Search for products edited before the search end date. Must be used with a search start date. If the end date is the same as the start date, results will be retrieved based on the date.

    category

    Category number

    Search for items that displayed at a certain category.

    eng_product_name

    English name of product

    Search for products of which product names (English) include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    supply_product_name

    Supplier product name

    Search for products of which product names (supplier) include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    internal_product_name

    internal product name

    You can search multiple item with ,(comma)

    model_name

    Model name

    Search for products of which model names include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    product_condition

    Product condition

    Search for products of specific condition.

    You can search multiple item with ,(comma)

    origin_place_value

    Origin

    Extra information for code of origin. You may add additional information if 'origin_place_code' is 1800.

    You can search multiple item with ,(comma)

    stock_quantity_max

    Maximum stock search

    Search for items that product stock is below a certain value.

    stock_quantity_min

    Minimum stock search

    Search for variants that product stock is above a certain value.

    If a product has several items, it searches if any of the items meet the condition.

    stock_safety_max

    Search of maximum safety inventory quantity

    stock_safety_min

    Search of minimum safety inventory quantity

    product_weight

    Weight of product

    Search for items that weigh certain kilograms.

    You can search multiple item with ,(comma)

    classification_code

    Classification code

    You can search multiple item with ,(comma)

    use_inventory

    whether use inventory

    Whether use inventory management or not at the variants of the products.

    T: Use
    F: Do not use

    category_unapplied

    Unapplied Category

    Search for products that category unapplied.

    T : Search for products that category unapplied

    include_sub_category

    include sub category

    Search for products that include sub category.

    T: Included

    additional_information_key

    additional information key

    Search for products that has specific additional information. In order to search, key and value is necessary.

    additional_information_value

    additional information value

    Search for products that has specific additional information. In order to search, key and value is necessary.

    approve_status

    Approval Status

    N: Approval request (New product) status
    E: Approval request (Product modification) status
    C: Approved status
    R: Rejected status
    I: Checking status

    since_product_no

    Min : [0]
    Max : [2147483647]

    Search after a certain product number

    Search products from after a certain product number. Can search regardless of offset.

    ※ Cannot use below parameter when using this search condition.

    product_no
    sort
    order
    offset

    product_bundle

    Product bundle

    T: Use
    F: Do not use

    sort

    Sort order

    created_date: Created Date
    updated_date: Updated Date
    product_name: Product Name

    order

    Order by

    asc: Ascending
    desc: Descending

    offset

    Max : [5000]

    Start location of list

    Set the start location of search result.

    DEFAULT 0

    limit

    Min : [1]~Max : [100]

    Limit

    Set the maximum number of search result.
    Example) input '10' shows only '10' result

    DEFAULT 10

    Retrieve a count of products

    GET /api/v2/admin/products/count

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no

    Product number

    Number of a product.

    You can search multiple item with ,(comma)

    display

    Whether display

    Search for products that displayed or not.

    selling

    whether selling

    Search for products that sell or not.

    product_name

    Product name

    Search for products of which names include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    product_code

    Product code

    System assigned code. This code cannot be duplicated.

    You can search multiple item with ,(comma)

    brand_code

    Brand code

    Search for products with matching brand codes.

    You can search multiple item with ,(comma)

    manufacturer_code

    Manufacturer code

    Search for products with matching manufacturer code.

    You can search multiple item with ,(comma)

    supplier_code

    Supplier code

    Search for products with matching supplier code.

    You can search multiple item with ,(comma)

    trend_code

    Trend code

    Search for products with matching trend code.

    You can search multiple item with ,(comma)

    product_tag

    Product tag

    Search for products of which product search terms or tags include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    custom_product_code

    Custom product code

    Search for products of which custom product codes include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    custom_variant_code

    Custom variants code

    You can search multiple item with ,(comma)

    price_min

    Minimum price

    Search for products that price is over a certain range.

    price_max

    Maximum price

    Search for products that price is below a certain range.

    retail_price_min

    Min : [0]
    Max : [2147483647]

    Minimum retail price

    Search for products that retail price is over a certain range.

    retail_price_max

    Min : [0]
    Max : [2147483647]

    Maximim retail price

    Search for products that retail price is below a certain range.

    supply_price_min

    Minimum supply price

    Search for products that supply price is over a certain range.

    supply_price_max

    Maximum supply price

    Search for products that supply price is below a certain range.

    created_start_date

    timezone

    Registered date start

    Search for products added after the search start date. Must be used with a search end date. If the start date is the same as the end date, results will be retrieved based on the date.

    created_end_date

    timezone

    Registered date end

    Search for products added before the search end date. Must be used with a search start date. If the end date is the same as the start date, results will be retrieved based on the date.

    updated_start_date

    timezone

    Updated date start

    Search for products edited after the search start date. Must be used with a search end date. If the start date is the same as the end date, results will be retrieved based on the date.

    updated_end_date

    timezone

    Updated date end

    Search for products edited before the search end date. Must be used with a search start date. If the end date is the same as the start date, results will be retrieved based on the date.

    category

    Category number

    Search for items that displayed at a certain category.

    eng_product_name

    English name of product

    Search for products of which product names (English) include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    supply_product_name

    Supplier product name

    Search for products of which product names (supplier) include the search query that you enter. The search query is case-insensitive.

    You can search multiple item with ,(comma)

    internal_product_name

    internal product name

    You can search multiple item with ,(comma)

    model_name

    Model name

    Search for products of which model names contain the search term that you enter. The search term is case-insensitive.

    You can search multiple item with ,(comma)

    product_condition

    Product condition

    Search for products of specific condition.

    You can search multiple item with ,(comma)

    origin_place_value

    Origin

    Extra information for code of origin. You may add additional information if 'origin_place_code' is 1800.

    You can search multiple item with ,(comma)

    stock_quantity_max

    Maximum stock search

    Search for items that product stock is below a certain value.

    stock_quantity_min

    Minimum stock search

    Search for variants that product stock is above a certain value.

    If a product has several items, it searches if any of the items meet the condition.

    stock_safety_max

    Search of maximum safety inventory quantity

    stock_safety_min

    Search of minimum safety inventory quantity

    product_weight

    Weight of product

    Search for items that weigh certain kilograms.

    You can search multiple item with ,(comma)

    classification_code

    Classification code

    Search for products with matching custom classification code.

    You can search multiple item with ,(comma)

    use_inventory

    whether use inventory

    Whether use inventory management or not at the variants of the products.

    T: Use
    F: Do not use

    category_unapplied

    Unapplied Category

    Search for products that category unapplied.

    T : Search for products that category unapplied

    include_sub_category

    include sub category

    Search for products that include sub category.

    T: Included

    additional_information_key

    additional information key

    Search for products that has specific additional information. In order to search, key and value is necessary.

    additional_information_value

    additional information value

    Search for products that has specific additional information. In order to search, key and value is necessary.

    approve_status

    Approval Status

    N: Approval request (New product) status
    E: Approval request (Product modification) status
    C: Approved status
    R: Rejected status
    I: Checking status

    since_product_no

    Min : [0]
    Max : [2147483647]

    Search after a certain product number

    Search products from after a certain product number. Can search regardless of offset.

    ※ Cannot use below parameter when using this search condition.

    product_no
    sort
    order
    offset

    product_bundle

    Product bundle

    T: Use
    F: Do not use

    Retrieve a count of products
    Request Copy
    Response Copy

    Retrieve a product resource

    GET /api/v2/admin/products/{product_no}

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    Number of a product.

    variants
    embed

    Variants Resource


    Can search with using embed parameter.

    memos
    embed

    Memos Resource


    Can search with using embed parameter.

    hits
    embed

    Product hits Resource


    Can search with using embed parameter.

    seo
    embed

    Product Seo Resource


    Can search with using embed parameter.

    tags
    embed

    Product Tag Resource


    Can search with using embed parameter.

    options
    embed

    Product Option Resource


    Can search with using embed parameter.

    discountprice
    embed

    Product discount sale price Resource


    Can search with using embed parameter.

    decorationimages
    embed

    Decoration Image Resource


    Can search with using embed parameter.

    benefits
    embed

    Benefits Resource


    Can search with using embed parameter.

    additionalimages
    embed

    additional image resource


    Can search with using embed parameter.

    Retrieve a product resource
    Request Copy
    Response Copy

    Create a product

    POST /api/v2/admin/products

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    display

    Whether display

    Whether display or not.

    T: Display
    F: Do not display

    DEFAULT F

    selling

    whether selling

    Whether selling or not.

    T: Sell
    F: Do not sell

    DEFAULT F

    product_condition

    Product condition

    N: New
    B: Returned
    R: Off-season
    U: Preowned
    E: Display model
    F: Refurbished
    S: Scratched

    DEFAULT N

    product_used_month

    Max : [2147483647]

    Months of using the used product

    Used month for the product when product_condition is used product.

    add_category_no

    Category no

    Register your product in the category you want to display using the category number

    category_no
    Required
    category number

    recommend
    whether a product is added to a recommended product category
    T: added
    F: not added
    DEFAULT F

    new
    whether a product is added to a new product category
    T: added
    F: not added
    DEFAULT F
    custom_product_code

    Max Length : [40]

    Custom product code

    You may assign this code manually in case of stock management or other reasons.

    product_name
    Required

    Max Length : [250]

    Product name

    Name of product.

    eng_product_name

    Max Length : [250]

    English name of product

    Name of product in english.

    supply_product_name

    Max Length : [250]

    Supplier product name

    internal_product_name

    Max Length : [50]

    internal product name

    model_name

    Max Length : [100]

    Model name

    Model name of product.

    price_excluding_tax

    Min : [0]~Max : [2147483647]

    product price (before VAT)

    If the base for price calculation (calculated_price_based_on) is "B (product price)" when retrieving product settings (GET:/products/setting), price_excluding_tax, not Price, should be used.

    price

    Min : [0]~Max : [2147483647]

    Product price

    Price of product.

    retail_price

    Min : [0]~Max : [2147483647]

    Product retail price

    supply_price
    Required

    Min : [0]~Max : [2147483647]

    Product supply price

    Value of supply. You may calculate price using "supply_price" and "margin_rate". In API, supply_price is used for reference purpose only.

    has_option

    Whether the option is used

    Has an option or not.

    T: use option
    F: do not use option

    DEFAULT F

    options

    Option

    name
    Required
    Option name

    value
    Required
    Option value
    use_naverpay

    whether use Naver Pay

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    naverpay_type

    Naver Pay sales type

    This cannot be used on Cafe24 Vietnam, Philippines.

    C : Naver Pay + Shopping Mall Products at the same time
    O : Naver Pay only products

    manufacturer_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Manufacturer code

    Manufacturer code.

    DEFAULT M0000000

    trend_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Trend code

    DEFAULT T0000000

    brand_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Brand code

    DEFAULT B0000000

    supplier_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Supplier code

    shipping_fee: shipping

    DEFAULT S0000000

    product_weight

    Min : [0]~Max : [999999.99]

    Weight of product

    made_date

    Date of manufacture

    release_date

    Date of release

    expiration_date

    Array Max : [2]

    Expiration date

    Expiration date.

    start_date
    Start date of the term of validity

    end_date
    End date of the term of validity
    description

    Detail description of product

    Detailed description of product.

    mobile_description

    Mobile version of product description

    Mobile version of product description. Replace product description to the mobile version when customer access a mobile shopping mall.

    summary_description

    Max Length : [255]

    Product Summary Description

    shipping_rates_max: Shipping interval end

    simple_description

    Simple Product Description

    If shipping_fee_type is M, D, W, C, you can set the shipping interval by defining the following in the array.

    translated_description

    Translation information of product details

    product_tag

    Array Max : [50]

    Product tag

    Tag for search product.

    payment_info

    Payment info

    Payment method guidance.

    shipping_info

    Shipping info

    Shipping method guidance.

    exchange_info

    Exchange info

    Exchange/return method guidance.

    service_info

    Service info

    Service query / information guidance.

    icon

    Array Max : [5]

    List of icon

    Register icon.

    hscode

    Max Length : [20]

    HS code

    Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping)

    country_hscode

    Array Max : [29]

    HS code by country

    shipping_scope

    Shipping information

    Shows whether can only deliver domestically or can deliver to overseas too.

    Cannot set the type when 'Shipping charge individually' is FALSE.

    ※ Must required "C" in EC Global shopping mall.

    This cannot be used on Cafe24 Vietnam, Philippines.

    A: Domestic only
    C: Export only
    B: Can deliver both inland and overseas

    shipping_method

    Shipping method

    Shipping method(when shipping individually).

    01: regular delivery
    02: fast service (document only)
    03: regular mail (document only)
    04: delivery in person
    05: delivery in person with bike or truck (within several hours)
    06: other
    07: cargo delivery
    08: pickup at a store
    09: delivery does not necessary

    shipping_fee_by_product

    Shipping fee by product

    Shipping charge individually.

    T: Individual delivery
    F: Standard delivery

    DEFAULT F

    shipping_area

    Max Length : [255]

    Shipping area

    Shipping area.

    shipping_period

    Array Max : [2]

    Shipping period

    Transit time.

    minimum
    minimum date range
    DEFAULT 1

    maximum
    maximum date range
    DEFAULT 7
    shipping_fee_type

    Shipping charge

    Shipping charge. Type of shipping charge when using 'Shipping charge individually'.

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity

    shipping_rates

    Array Max : [200]

    Shipping rates

    If shipping_fee_type is R or N, you can set the shipping cost by defining shipping_fee in the array.

    If shipping_fee_type is M, D, W, C, you can set the shipping interval by defining the following in the array.
    shipping_rates_min: Shipping interval start
    shipping_rates_max: Shipping interval end
    shipping_fee: shipping

    shipping_rates_min
    minimum value in range for shipping fee charge option

    shipping_rates_max
    maximum value in range for shipping fee charge option

    shipping_fee
    shipping fee
    prepaid_shipping_fee

    Whether prepaid shipping fee

    This cannot be used on Cafe24 Vietnam, Philippines.

    C: Pay after delivery
    P: Prepaid
    B: Select Prepaid/Pay after delivery

    clearance_category_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Clearance category code

    Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping)
    clearance_category_code

    detail_image

    Detail image

    Detail image.

    list_image

    List image

    List image.

    tiny_image

    Tiny list image height

    Reduced image.

    small_image

    Reduced image

    shipping_rates_min: Shipping interval start

    image_upload_type

    Image type

    Image type.

    ※ EC Global can not use C because it does not support FTP

    A: Register a representative image.
    B: Register an individual image.
    C: Register through Web FTP.

    DEFAULT A

    additional_information

    Additional information list

    Additional item.

    key
    Required
    Additional field key

    value
    Additional field value
    price_content

    Max Length : [20]

    Alternative phrase of the selling price

    buy_limit_by_product

    whether purchase restriction individual setting

    T: use
    F: do not use

    DEFAULT F

    buy_limit_type

    Purchase limitation

    N: Purchase is only available to customer accounts + Buy button is hidden
    M: Purchase is only available to customer accounts + Buy button is shown
    F: No purchase restrictions
    O: Purchase is only available to specific customer accounts + Buy button is hidden
    D: Purchase is only available to specific customer accounts + Buy button is shown

    DEFAULT F

    buy_group_list

    customer tiers allowed to purchase the relevant product

    buy_member_id_list

    Authorized customer ID

    repurchase_restriction

    repurchase restriction

    T : restrict repurchase
    F : do not restrict repurchase

    DEFAULT F

    single_purchase_restriction

    single purchase restriction

    T : restrict single purchase
    F : do not restrict on single purchase

    DEFAULT F

    buy_unit_type

    Type of Purchase unit

    If the purchase unit of the product is set to 1 or more, the setting of whether the purchase unit is the item unit or the product unit

    P: Based on product
    O: Based on quantity

    DEFAULT O

    buy_unit

    Max : [2147483647]

    Minimum unit per purchase

    Unit of order.

    DEFAULT 1

    order_quantity_limit_type

    Criteria of order quantity restriction

    If you limit the order quantity of the product, you can set whether the limit should be based on item or product unit.

    P: Based on product
    O: Based on quantity

    DEFAULT O

    minimum_quantity

    Max : [2147483647]

    Minimum quantity per purchase

    Minimum quantity per purchase. Customer cannot buy the product below the minimum quantity.

    DEFAULT 1

    maximum_quantity

    Max : [2147483647]

    Maximum quantity per purchase

    Maximum quantity per purchase. Customer cannot buy the product above the maximum quantity.

    Enter "0" to enter the maximum quantity of orders as "no limit"

    DEFAULT 0

    points_by_product

    individual settings for points

    F : use default setting
    T : individual setting

    DEFAULT F

    points_setting_by_payment

    points settings by payment method

    B : Use the default reserve setting
    C : Earn based on the payment method

    points_amount

    points settings information

    payment_method
    payment method of mileage
    naverpay : naver pay
    smilepay : smile pay
    kakaopay : kakao pay
    payco : payco
    paynow : paynow
    kpay : k pay
    icash : virtual account
    deposit : deposit
    tcash : real time bank transfer
    cell : mobile phone
    card : card
    mileage : mileage
    cash : bank transfer

    points_rate
    Points issuance rate

    points_unit_by_payment
    unit of points by payment method
    P : percent unit
    W : Won unit
    except_member_points

    omit additional points issued based on customer tiers

    T : exclude setting an additional mileage accumulation for member group
    F : do not setting an additional mileage accumulation for member group

    DEFAULT F

    product_volume

    product volume information

    use_product_volume
    Use product volume

    product_width
    width

    product_height
    depth

    product_length
    height
    origin_classification

    Origin classification

    Distinguish the origin of a product.

    F: domestic
    T: abroad
    E: other

    origin_place_no

    Origin place no

    List the origin number Retrieve a list of origins by API
    If origin_classification is F (domestic), it is possible to enter origin only if foreign (foreign) is "F".
    If origin_classification is T (overseas), it is possible to enter origin only if foreign (foreign) is "T".

    origin_place_value

    Max Length : [30]

    Extra information for code of origin

    Extra information for code of origin. You may add additional information if 'origin_place_code' is 1800.

    made_in_code

    Origin country code

    A two-digit country code for country of origin
    Country code can be used instead of country of origin number (origin_place_no) and country of origin category (origin_classification).

    main

    whether display at main

    Displays main display number when display products at main page such as "recommend product" or "new".

    relational_product

    Array Max : [200]

    Related product

    Related or similar product of selected product. Registered related product display the bottom of the product detail page.

    product_no
    Required
    Product number

    interrelated
    Required
    whether a related product as one-way or two-way
    T: one-way
    F: two-way
    product_material

    Material of product

    The material of the item. You should enter each material and percentage of composing material if the product is has a multiple material.

    english_product_material

    English product material

    English version of a material of product. When you using an overseas delivery company, you may be required information of a material of the clothes.

    cloth_fabric

    Fabric of product

    In case cloth products using a Japanese courier service, material information may required for some shipping companies.

    woven: Woven
    knit: Knit

    classification_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Classification code

    additional_price

    Max : [2147483647]

    Additional amount of the selling price

    Additional price is added amount to price in addition to supply price and margin rate. In API, additional price is used only for reperence purpose only.

    margin_rate

    Min : [-999.99]~Max : [999.99]

    Margin rate

    Rate of margin. You may calculate price using "supply_price" and "margin_rate". In API, margin rate is used only for reperence purpose only.

    tax_type

    Taxation category

    Tax type information of product.

    Tax product : VAT, Sales tax, or other tax is included

    Tax free product : Tax free product such as un-processed agriculture products, fishery products, animal products, books, or etc.

    Products for tax free may differ from country to country.

    Zero tax product : Applicable as 0% rate of VAT.

    A: Taxable goods
    B: Duty-free goods
    C: Small goods

    tax_rate

    Min : [0]~Max : [100]

    Tax rate

    additional_image

    Additional image

    Additional image' showing on the bottom side of the product detail page. Displayed at similar location with 'Reduced image' and can see 'Additional image' when mouse over at PC version or swipe at mobile version.

    Up to 20 'Additional image' can be uploaded.

    adult_certification

    Age verification

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    DEFAULT F

    exposure_limit_type

    types of customers allowed to view the relevant product

    A: display to all
    M: display to customers only

    DEFAULT A

    exposure_group_list

    customer tiers allowed to view the relevant product

    use_kakaopay

    Whether to use Kakao Pay

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    Create a product
    Request Copy
    Response Copy

    Update a product

    PUT /api/v2/admin/products/{product_no}

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    display

    Whether display

    You can choose product should be displayed or not.

    T: Display
    F: Do not display

    selling

    whether selling

    Whether selling or not.

    T: Sell
    F: Do not sell

    product_condition

    Product condition

    N: New
    B: Returned
    R: Off-season
    U: Preowned
    E: Display model
    F: Refurbished
    S: Scratched

    product_used_month

    Max : [2147483647]

    Months of using the used product

    Used month for the product when product_condition is used product.

    add_category_no

    Category no

    Enter a category number to add a specific product category to the product

    category_no
    Required
    category number

    recommend
    whether a product is added to a recommended product category
    T: added
    F: not added
    DEFAULT F

    new
    whether a product is added to a new product category
    T: added
    F: not added
    DEFAULT F
    delete_category_no

    Deleted classification number

    Enter a category number to delete a specific product category to the product

    custom_product_code

    Max Length : [40]

    Custom product code

    You may assign this code manually in case of stock management or other reasons.

    product_name

    Max Length : [250]

    Product name

    Name of product.

    eng_product_name

    Max Length : [250]

    English name of product

    Name of product in english.

    supply_product_name

    Max Length : [250]

    Supplier product name

    internal_product_name

    Max Length : [50]

    internal product name

    model_name

    Max Length : [100]

    Model name

    Model name of product.

    price_excluding_tax

    Min : [0]~Max : [2147483647]

    product price (before VAT)

    If the base for price calculation (calculated_price_based_on) is "B (product price)" when retrieving product settings (GET:/products/setting), price_excluding_tax, not Price, should be used.

    price

    Min : [0]~Max : [2147483647]

    Product price

    Price of product.

    retail_price

    Min : [0]~Max : [2147483647]

    Product retail price

    supply_price

    Min : [0]~Max : [2147483647]

    Product supply price

    Value of supply. You may calculate price using "supply_price" and "margin_rate". In API, supply_price is used for reference purpose only.

    has_option

    Whether the option is used

    Has an option or not.

    F: Option not used

    use_naverpay

    whether use Naver Pay

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    naverpay_type

    Naver Pay sales type

    This cannot be used on Cafe24 Vietnam, Philippines.

    C : Naver Pay + Shopping Mall Products at the same time
    O : Naver Pay only products

    manufacturer_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Manufacturer code

    Manufacturer code.

    trend_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Trend code

    brand_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Brand code

    supplier_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Supplier code

    Supplier code.

    product_weight

    Min : [0]~Max : [999999.99]

    Weight of product

    made_date

    Date of manufacture

    release_date

    Date of release

    expiration_date

    Array Max : [2]

    Expiration date

    Expiration date.

    start_date
    Start date of the term of validity

    end_date
    End date of the term of validity
    description

    Detail description of product

    Detailed description of product.

    mobile_description

    Mobile version of product description

    Mobile version of product description. Replace product description to the mobile version when customer access a mobile shopping mall.

    translated_description

    Translation information of product details

    translated_additional_description

    Translated additional description

    summary_description

    Max Length : [255]

    Product Summary Description

    Summary description of product.

    simple_description

    Simple Product Description

    Simple description of product.

    product_tag

    Array Max : [50]

    Product tag

    Tag for search product.

    payment_info

    Payment info

    Payment method guidance.

    shipping_info

    Shipping info

    Shipping method guidance.

    exchange_info

    Exchange info

    Exchange/return method guidance.

    service_info

    Service info

    Service query / information guidance.

    icon

    Array Max : [5]

    List of icon

    use_icon_exposure_term

    whether use show date

    T: Used
    F: Not used

    icon_exposure_begin_datetime

    start date of show_date

    icon_exposure_end_datetime

    end date of show_date

    hscode

    Max Length : [20]

    HS code

    Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping)

    country_hscode

    Array Max : [29]

    HS code by country

    shipping_scope

    Shipping information

    Shows whether can only deliver domestically or can deliver to overseas too.

    Cannot set the type when 'Shipping charge individually' is FALSE.

    This cannot be used on Cafe24 Vietnam, Philippines.

    A: Domestic only
    C: Export only
    B: Can deliver both inland and overseas

    shipping_method

    Shipping method

    Shipping method(when shipping individually).

    01: regular delivery
    02: fast service (document only)
    03: regular mail (document only)
    04: delivery in person
    05: delivery in person with bike or truck (within several hours)
    06: other
    07: cargo delivery
    08: pickup at a store
    09: delivery does not necessary

    shipping_fee_by_product

    Shipping fee by product

    Shipping charge individually.

    T: Individual delivery
    F: Standard delivery

    shipping_area

    Max Length : [255]

    Shipping area

    Shipping area.

    shipping_period

    Shipping period

    Transit time.

    minimum
    minimum date range
    DEFAULT 1

    maximum
    maximum date range
    DEFAULT 7
    shipping_fee_type

    Shipping charge

    Shipping charge. Type of shipping charge when using 'Shipping charge individually'.

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity

    shipping_rates

    Array Max : [200]

    Shipping rates

    If shipping_fee_type is R or N, you can set the shipping cost by defining shipping_fee in the array.

    If shipping_fee_type is M, D, W, C, you can set the shipping interval by defining the following in the array.
    shipping_rates_min: Shipping interval start
    shipping_rates_max: Shipping interval end
    shipping_fee: shipping

    shipping_rates_min
    minimum value in range for shipping fee charge option

    shipping_rates_max
    maximum value in range for shipping fee charge option

    shipping_fee
    shipping fee
    prepaid_shipping_fee

    Whether prepaid shipping fee

    This cannot be used on Cafe24 Vietnam, Philippines.

    C: Pay after delivery
    P: Prepaid
    B: Select Prepaid/Pay after delivery

    clearance_category_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Clearance category code

    Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping)
    clearance_category_code

    detail_image

    Detail image

    Detail image.

    list_image

    List image

    List image.

    tiny_image

    Tiny list image height

    Reduced image.

    small_image

    Reduced image

    Small list image.

    image_upload_type

    Image type

    Image type.

    ※ EC Global can not use C because it does not support FTP

    A: Register a representative image.
    B: Register an individual image.
    C: Register through Web FTP.

    additional_information

    Additional information list

    Additional item.

    key
    Required
    Additional field key

    value
    Additional field value
    price_content

    Max Length : [20]

    Alternative phrase of the selling price

    buy_limit_by_product

    whether purchase restriction individual setting

    T: use
    F: do not use

    buy_limit_type

    Purchase limitation

    N: Purchase is only available to customer accounts + Buy button is hidden
    M: Purchase is only available to customer accounts + Buy button is shown
    F: No purchase restrictions
    O: Purchase is only available to specific customer accounts + Buy button is hidden
    D: Purchase is only available to specific customer accounts + Buy button is shown

    buy_group_list

    customer tiers allowed to purchase the relevant product

    buy_member_id_list

    Authorized customer ID

    repurchase_restriction

    repurchase restriction

    T : restrict repurchase
    F : do not restrict repurchase

    single_purchase_restriction

    single purchase restriction

    T : restrict single purchase
    F : do not restrict on single purchase

    buy_unit_type

    Type of Purchase unit

    If the purchase unit of the product is set to 1 or more, the setting of whether the purchase unit is the item unit or the product unit

    P: Based on product
    O: Based on quantity

    buy_unit

    Max : [2147483647]

    Minimum unit per purchase

    Unit of order.

    order_quantity_limit_type

    Criteria of order quantity restriction

    If you limit the order quantity of the product, you can set whether the limit should be based on item or product unit.

    P: Based on product
    O: Based on quantity

    minimum_quantity

    Max : [2147483647]

    Minimum quantity per purchase

    Minimum quantity for order.

    maximum_quantity

    Max : [2147483647]

    Maximum quantity per purchase

    Maximum quantity per purchase. Customer cannot buy the product above the maximum quantity.

    If you modify the minimum quantity per purchase, you must modify the maximum order quantity together.

    Enter "0" to enter the maximum quantity of orders as "no limit"

    points_by_product

    individual settings for points

    F : use default setting
    T : individual setting

    points_setting_by_payment

    points settings by payment method

    B : Use the default reserve setting
    C : Earn based on the payment method

    points_amount

    points settings information

    payment_method
    payment method of mileage
    naverpay : naver pay
    smilepay : smile pay
    kakaopay : kakao pay
    payco : payco
    paynow : paynow
    kpay : k pay
    icash : virtual account
    deposit : deposit
    tcash : real time bank transfer
    cell : mobile phone
    card : card
    mileage : mileage
    cash : bank transfer

    points_rate
    Points issuance rate

    points_unit_by_payment
    unit of points by payment method
    P : percent unit
    W : Won unit
    except_member_points

    omit additional points issued based on customer tiers

    T : exclude setting an additional mileage accumulation for member group
    F : do not setting an additional mileage accumulation for member group

    product_volume

    product volume information

    use_product_volume
    Use product volume

    product_width
    width

    product_height
    depth

    product_length
    height
    origin_classification

    Origin classification

    Distinguish the origin of a product.

    F: domestic
    T: abroad
    E: other

    origin_place_no

    Origin place no

    List the origin number List all Origin by API
    If origin_classification is F (domestic), it is possible to enter origin only if foreign (foreign) is "F".
    If origin_classification is T (overseas), it is possible to enter origin only if foreign (foreign) is "T".

    origin_place_value

    Max Length : [30]

    Extra information for code of origin

    Extra information for code of origin. You may add additional information if 'origin_place_code' is 1800.

    made_in_code

    Origin country code

    A two-digit country code for country of origin
    Country code can be used instead of country of origin number (origin_place_no) and country of origin category (origin_classification).

    main

    whether display at main

    Displays main display number when display products at main page such as "recommend product" or "new".

    relational_product

    Array Max : [200]

    Related product

    Related or similar product of selected product. Registered related product display the bottom of the product detail page.

    product_no
    Product number

    interrelated
    Required
    whether a related product as one-way or two-way
    T: one-way
    F: two-way
    product_material

    Material of product

    The material of the item. You should enter each material and percentage of composing material if the product is has a multiple material.

    english_product_material

    English product material

    English version of a material of product. When you using an overseas delivery company, you may be required information of a material of the clothes.

    cloth_fabric

    Fabric of product

    In case cloth products using a Japanese courier service, material information may required for some shipping companies.

    woven: Woven
    knit: Knit

    classification_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Classification code

    additional_price

    Max : [2147483647]

    Additional amount of the selling price

    Additional price is added amount to price in addition to supply price and margin rate. In API, additional price is used only for reperence purpose only.

    margin_rate

    Min : [-999.99]~Max : [999.99]

    Margin rate

    Rate of margin. You may calculate price using "supply_price" and "margin_rate". In API, margin rate is used only for reperence purpose only.

    tax_type

    Taxation category

    Tax type information of product.

    Tax product : VAT, Sales tax, or other tax is included

    Tax free product : Tax free product such as un-processed agriculture products, fishery products, animal products, books, or etc.

    Products for tax free may differ from country to country.

    Zero tax product : Applicable as 0% rate of VAT.

    A: Taxable goods
    B: Duty-free goods
    C: Small goods

    tax_rate

    Min : [0]~Max : [100]

    Tax rate

    additional_image

    Additional image

    Additional image' showing on the bottom side of the product detail page. Displayed at similar location with 'Reduced image' and can see 'Additional image' when mouse over at PC version or swipe at mobile version.

    Up to 20 'Additional image' can be uploaded.

    adult_certification

    Age verification

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    exposure_limit_type

    types of customers allowed to view the relevant product

    A: display to all
    M: display to customers only

    exposure_group_list

    customer tiers allowed to view the relevant product

    use_kakaopay

    Whether to use Kakao Pay

    This cannot be used on Cafe24 Vietnam, Philippines.

    T: Used
    F: Not used

    Delete a product

    DELETE /api/v2/admin/products/{product_no}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Delete a product
    Request Copy
    Response Copy

    Products additionalimages

    Products additionalimages, a child resource of Products, lets you retrieve additional images of a product.

    Endpoints 
    POST /api/v2/admin/products/{product_no}/additionalimages
PUT /api/v2/admin/products/{product_no}/additionalimages

    Products additionalimages properties

    Attribute Description
    shop_no

    Shop Number
    additional_image

    Additional image

    Create an additional product image

    POST /api/v2/admin/products/{product_no}/additionalimages

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    additional_image
    Required

    Additional image

    ● Maximum number of requests: 20
    ● Maximum file size: 5MB
    ● Maximum file size per request : 30MB

    Create an additional product image
    Request Copy
    Response Copy

    Update an additional product image

    PUT /api/v2/admin/products/{product_no}/additionalimages

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    additional_image
    Required

    Additional image

    ● Maximum number of requests: 20
    ● Maximum file size: 5MB
    ● Maximum file size per request : 30MB

    Update an additional product image
    Request Copy
    Response Copy

    Products approve

    API which can only be used when mall using products approval function.

    Endpoints 
    GET /api/v2/admin/products/{product_no}/approve
POST /api/v2/admin/products/{product_no}/approve
PUT /api/v2/admin/products/{product_no}/approve

    Products approve properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    status
    Required

    Approval status

    Approval status of the product requested.

    N: Approval request (New product) status
    E: Approval request (Product modification) status
    C: Approved status
    R: Rejected status
    I: Checking status
    Empty Value: Not requested
    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Retrieve a product approval status

    GET /api/v2/admin/products/{product_no}/approve

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Retrieve a product approval status
    Request Copy
    Response Copy

    Create a product approval request

    POST /api/v2/admin/products/{product_no}/approve

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    user_id
    Required

    Supplier operator ID

    ID of supplier operator who requested

    Create a product approval request
    Request Copy
    Response Copy

    Update a product approval status

    PUT /api/v2/admin/products/{product_no}/approve

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    user_id
    Required

    Supplier operator ID

    ID of supplier operator who requested

    status
    Required

    Approval status

    Approval status of the product requested.

    C: Approved status
    R: Rejected status
    I: Checking status

    Update a product approval status
    Request Copy
    Response Copy

    Products decorationimages

    This resource lets you add special images to products displayed on a store. This resource lets you retrieve decorative images from a store and add them to a certain product, or retrieve the images already added to a product.

    This resource can only be used as a child resource of the Products resource.

    Endpoints 
    GET /api/v2/admin/products/decorationimages
GET /api/v2/admin/products/{product_no}/decorationimages
POST /api/v2/admin/products/{product_no}/decorationimages
PUT /api/v2/admin/products/{product_no}/decorationimages
DELETE /api/v2/admin/products/{product_no}/decorationimages/{code}

    Products decorationimages properties

    Attribute Description
    code

    code of decoration image
    path

    Decoration Image URL
    shop_no

    Shop Number
    use_show_date

    whether use show date

    T: Use
    F: Do not use
    show_start_date

    timezone

    start date of show_date
    show_end_date

    timezone

    end date of show_date
    image_list

    list of decoration image

    Retrieve a list of decoration images

    GET /api/v2/admin/products/decorationimages

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40
    Retrieve a list of decoration images
    Request Copy
    Response Copy

    Retrieve a list of product decoration images

    GET /api/v2/admin/products/{product_no}/decorationimages

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Retrieve a list of product decoration images
    Request Copy
    Response Copy

    Set decoration images for a product

    POST /api/v2/admin/products/{product_no}/decorationimages

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    use_show_date

    whether use show date

    T: Use
    F: Do not use

    show_start_date

    timezone

    start date of show_date

    show_end_date

    timezone

    end date of show_date

    image_list
    Required

    list of decoration image

    code
    decoration image code

    path
    decoration image path

    image_horizontal_position
    decoration image horizontal value

    image_vertical_position
    decoration image vertical value
    Set decoration images for a product
    Request Copy
    Response Copy

    Update product decoration images

    PUT /api/v2/admin/products/{product_no}/decorationimages

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    use_show_date

    whether use show date

    T: Use
    F: Do not use

    show_start_date

    timezone

    start date of show_date

    show_end_date

    timezone

    end date of show_date

    image_list
    Required

    list of decoration image

    code
    decoration image code

    path
    decoration image path

    image_horizontal_position
    decoration image horizontal value

    image_vertical_position
    decoration image vertical value

    Remove a product decoration image

    DELETE /api/v2/admin/products/{product_no}/decorationimages/{code}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    code
    Required

    code of decoration image

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Remove a product decoration image
    Request Copy
    Response Copy

    Products discountprice

    A resource about product's discount price. You can retrieve the discount price of products under the Benefits resource.

    This resource can only be used as a child resource of the Products resource. You can use the embed parameter in sending a request to retrieve product's discount price in one call.

    Endpoints 
    GET /api/v2/admin/products/{product_no}/discountprice

    Products discountprice properties

    Attribute Description
    pc_discount_price

    PC discount price
    mobile_discount_price

    Mobile discount price
    app_discount_price

    Discounted price (App)

    Retrieve a product discounted price

    GET /api/v2/admin/products/{product_no}/discountprice

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    Retrieve a product discounted price
    Request Copy
    Response Copy

    Products hits

    Product Views (Hits) is a measure of how much your products are viewed by your shopping mall customers. You can see how many products your customers are viewing most by checking product views.
    Product views can only be used in the Products subset as a embedded Resource.

    Endpoints 
    GET /api/v2/admin/products/{product_no}/hits/count

    Retrieve a count of product views

    GET /api/v2/admin/products/{product_no}/hits/count

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Retrieve a count of product views
    Request Copy
    Response Copy

    Products icons

    A product icon is a small image that you can add next to an item to emphasize it. You can emphasize items by adding messages such as discount information, "close to sold out" on the displayed products.
    The item icon can only be used in the Products subset as a embedded Resource.

    Endpoints 
    GET /api/v2/admin/products/icons
GET /api/v2/admin/products/{product_no}/icons
POST /api/v2/admin/products/{product_no}/icons
PUT /api/v2/admin/products/{product_no}/icons
DELETE /api/v2/admin/products/{product_no}/icons/{code}

    Products icons properties

    Attribute Description
    code

    code of product icon

    Code of Icon.
    path

    Path

    URL of Icon.
    shop_no

    Shop Number
    use_show_date

    whether use show date

    T: Use
    F: Do not use
    show_start_date

    timezone

    start date of show_date
    show_end_date

    timezone

    end date of show_date
    image_list

    list of product icon

    Retrieve a list of icons

    GET /api/v2/admin/products/icons

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40
    Retrieve a list of icons
    Request Copy
    Response Copy

    Retrieve a list of product icons

    GET /api/v2/admin/products/{product_no}/icons

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    Retrieve a list of product icons
    Request Copy
    Response Copy

    Set icons for a product

    POST /api/v2/admin/products/{product_no}/icons

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    image_list
    Required

    Array Max : [5]

    list of product icon

    code
    Required
    code of product icon
    Set icons for a product
    Request Copy
    Response Copy

    Update product icons

    PUT /api/v2/admin/products/{product_no}/icons

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    use_show_date

    whether use show date

    T: Use
    F: Do not use

    show_start_date

    timezone

    start date of show_date

    show_end_date

    timezone

    end date of show_date

    image_list

    Array Max : [5]

    list of product icon

    code
    Required
    code of product icon
    Update product icons
    Request Copy
    Response Copy

    Remove a product icon

    DELETE /api/v2/admin/products/{product_no}/icons/{code}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    code
    Required

    code of product icon

    Remove a product icon
    Request Copy
    Response Copy

    Products images

    Products Images means the pictures or pictures of the products uploaded for sale. Use the Product Image API to upload an image for use in a product description, or upload an image of a product.
    Images of the products can be uploaded by encoding to Base64 code.

    Endpoints 
    POST /api/v2/admin/products/images
POST /api/v2/admin/products/{product_no}/images
DELETE /api/v2/admin/products/{product_no}/images

    Products images properties

    Attribute Description
    path

    Detail image
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    product_no

    Product number

    System assigned code. This code cannot be duplicated.
    detail_image

    Detail image

    Detail image' showing on the product detail page.
    list_image

    List image

    'List image' showing on the product category page, main page, product search result page.
    tiny_image

    Tiny list image height

    Small list image' showing on the recently viewed page.
    small_image

    Reduced image

    Reduced image' showing on the bottom side of the product detail page.

    Upload images

    POST /api/v2/admin/products/images

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 20

    Request

    Parameter Description
    image
    Required

    Detail image

    ● Maximum file size: 5MB
    ● Maximum file size per request : 30MB

    Upload images
    Request Copy
    Response Copy

    Upload product images

    POST /api/v2/admin/products/{product_no}/images

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    detail_image

    Detail image

    Detail image' showing on the product detail page.

    list_image

    List image

    'List image' showing on the product category page, main page, product search result page.

    tiny_image

    Tiny list image height

    Reduced image' showing on the bottom side of the product detail page.

    small_image

    Reduced image

    Small list image' showing on the recently viewed page.

    image_upload_type
    Required

    Image type

    You can specify the upload type, whether the image type is representative image or individual image. If you select the representative image (A), uploading the image to the detail image (detail_image) will be reflected in all other images.

    A: Register a representative image.
    B: Register an individual image.

    Upload product images
    Request Copy
    Response Copy

    Delete product images

    DELETE /api/v2/admin/products/{product_no}/images

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Delete product images
    Request Copy
    Response Copy

    Products memos

    Products Memos is a brief note that can be used as a tool for memorizing special items or communicating with operators.
    Products Memos can only be used in the Products subset as a embedded Resource.

    Endpoints 
    GET /api/v2/admin/products/{product_no}/memos
GET /api/v2/admin/products/{product_no}/memos/{memo_no}
POST /api/v2/admin/products/{product_no}/memos
PUT /api/v2/admin/products/{product_no}/memos/{memo_no}
DELETE /api/v2/admin/products/{product_no}/memos/{memo_no}

    Products memos properties

    Attribute Description
    memo_no

    Memo number

    System assigned code. This code cannot be duplicated.
    author_id

    Max Length : [20]

    Author ID

    ID of memo writer.
    created_date

    timezone

    Created date

    Written date of memo.
    memo

    Memo

    Contents of memo. You may input this with HTML..

    Retrieve a list of product memos

    GET /api/v2/admin/products/{product_no}/memos

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    offset

    Max : [8000]

    Start location of list

    DEFAULT 0

    limit

    Min : [1]~Max : [100]

    Limit

    Set the maximum number of search result.
    Example) input '10' shows only '10' result

    DEFAULT 10

    Retrieve a list of product memos
    Request Copy
    Response Copy

    Retrieve a product memo

    GET /api/v2/admin/products/{product_no}/memos/{memo_no}

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    memo_no
    Required

    Memo number

    System assigned code. This code cannot be duplicated.

    Retrieve a product memo
    Request Copy
    Response Copy

    Create a product memo

    POST /api/v2/admin/products/{product_no}/memos

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    author_id
    Required

    Max Length : [20]

    Author ID

    ID of memo writer.

    memo
    Required

    Memo

    Contents of memo. You may input this with HTML..

    Create a product memo
    Request Copy
    Response Copy

    Update a product memo

    PUT /api/v2/admin/products/{product_no}/memos/{memo_no}

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    memo_no
    Required

    Memo number

    System assigned code. This code cannot be duplicated.

    author_id
    Required

    Max Length : [20]

    Author ID

    ID of memo writer.

    memo
    Required

    Memo

    Contents of memo. You may input this with HTML..

    Update a product memo
    Request Copy
    Response Copy

    Delete a product memo

    DELETE /api/v2/admin/products/{product_no}/memos/{memo_no}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    memo_no
    Required

    Memo number

    System assigned code. This code cannot be duplicated.

    Delete a product memo
    Request Copy
    Response Copy

    Products options

    This resource allows customers to select a variant for a product that comes in different colors or sizes. This resource has the option_name property, which can for example be color or size, and the option_value property, which can for example be red or yellow. Product variants are generated based on their options when they are added to a product.

    This resource can only be used as a child resource of the Products resource.

    Endpoints 
    GET /api/v2/admin/products/{product_no}/options
POST /api/v2/admin/products/{product_no}/options
PUT /api/v2/admin/products/{product_no}/options
DELETE /api/v2/admin/products/{product_no}/options

    Products options properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.
    has_option

    Whether the option is used

    T: Use
    F: Do not use
    option_type

    Type of option

    Shows type of option when "has_option" is TRUE.

    ● combination : make 'a combination of option' based on 'the name of option'.
    ● linked with product : The way how to show type of option is similar to 'combination types' but this type can choose both 'necessary option' and 'selectable option'. This type can make 'unlimited combinations of options'.
    ● independently selectable : Customer can select 'each indepentent options'. 'Each option' will be generated as 'each variant'.

    T: Combination
    E: linked with product
    F: independently selectable
    option_list_type

    Option list type

    If you use the combined option, show the type of the combined option

    * combination all-selected : Shows combination of 'all options' in 'a single selecbox'(button or radio button).
    * combination separate-selected : Customer can choose 'options' at 'each selectbox'(button or radio button) and make 'a combination of option' based on 'the name of option'.

    If you use "linked with product" option or "independently selectable" option, S(separate selected) is used by default.

    C: Integrated type
    S: Separated type
    option_preset_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Option set code

    If you use the linked with product option, show the option preset code.
    options

    Option
    select_one_by_option

    Whether select only one by option

    When using 'independently selectable' option type and this set as TRUE, customer can select only 1 item per option.
    If this set as FALSE, customer can select multiple items per option.

    ※ This Flag Is Only Available When Using 'Independently Selectable' Option Type.

    T: Use
    F: Do not use
    option_preset_name

    Option preset name

    If you use "linked with product" option, show the name of the option set
    use_additional_option

    Whether use additional option

    T: Use
    F: Do not use
    additional_options

    Additional option
    use_attached_file_option

    Whether use attached file option

    T: Use
    F: Do not use
    attached_file_option

    Attached file option

    Retrieve a list of product options

    GET /api/v2/admin/products/{product_no}/options

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Retrieve a list of product options
    Request Copy
    Response Copy

    Create product options

    POST /api/v2/admin/products/{product_no}/options

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    has_option

    Whether the option is used

    T: Use
    F: Do not use

    option_type

    Type of option

    Enter type of option when "has_option" is TRUE.

    ● combination : make 'a combination of option' based on 'the name of option'.
    ● linked with product : The way how to show type of option is similar to 'combination types' but this type can choose both 'necessary option' and 'selectable option'. This type can make 'unlimited combinations of options'.
    ● independently selectable : Customer can select 'each indepentent options'. 'Each option' will be generated as 'each variant'.

    T: Combination
    E: linked with product
    F: independently selectable

    option_list_type

    Option list type

    If you use the combined option, enter the type of the combined option

    * combination all-selected : Shows combination of 'all options' in 'a single selecbox'(button or radio button).
    * combination separate-selected : Customer can choose 'options' at 'each selectbox'(button or radio button) and make 'a combination of option' based on 'the name of option'.

    If you use "linked with product" option or "independently selectable" option, S(separate selected) is used by default.

    S: Combination separation option
    C: Combination integration option

    options

    Option

    option_name
    Required
    Option name

    option_value Array

    option_text
    Option value

    option_image_file
    swatch

    option_color
    colorchip

    option_display_type
    Option list type
    S: select box
    P: preview
    B: text swatch
    R: radio button
    DEFAULT S
    select_one_by_option

    Whether select only one by option

    When using 'independently selectable' option type and this set as TRUE, customer can select only 1 item per option.
    If this set as FALSE, customer can select multiple items per option.

    ※ This Flag Is Only Available When Using 'Independently Selectable' Option Type.

    T: Used
    F: Not used; Existed only in the independent type; Process the selected value by option if being checked.

    option_preset_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Option set code

    option_preset_name

    Option preset name

    If you use "linked with product" option, enter the name of the option set

    use_additional_option

    Whether use additional option

    T: Use
    F: Do not use

    additional_options

    Additional option

    additional_option_name
    Required
    custom text field name

    additional_option_text_length
    Required
    character limit for custom text field
    1~30
    50
    100
    200

    required_additional_option
    Required
    whether a custom text field is required or optional
    T: required
    F: optional
    DEFAULT T
    use_attached_file_option

    Whether use attached file option

    T: Use
    F: Do not use

    attached_file_option

    Attached file option

    Create product options
    Request Copy
    Response Copy

    Update product options

    PUT /api/v2/admin/products/{product_no}/options

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    option_list_type

    Option list type

    If you use the combined option, enter the type of the combined option

    * combination all-selected : Shows combination of 'all options' in 'a single selecbox'(button or radio button).
    * combination separate-selected : Customer can choose 'options' at 'each selectbox'(button or radio button) and make 'a combination of option' based on 'the name of option'.

    If you use "linked with product" option or "independently selectable" option, S(separate selected) is used by default.

    S: Combination separation option
    C: Combination integration option

    option_preset_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Option set code

    If you use the linked with product option, enter the option preset code.

    options

    Option

    option_name
    Required
    Option name

    option_value Array

    option_text
    Option value

    option_image_file
    swatch

    option_link_image
    Option-linked image

    option_color
    colorchip

    option_display_type
    Option list type
    S: select box
    P: preview
    B: text swatch
    R: radio button
    DEFAULT S
    original_options

    Option value before modification

    option_name
    Required
    Option name

    option_value Array

    option_text
    Option value
    select_one_by_option

    Whether select only one by option

    When using 'independently selectable' option type and this set as TRUE, customer can select only 1 item per option.
    If this set as FALSE, customer can select multiple items per option.

    ※ This Flag Is Only Available When Using 'Independently Selectable' Option Type.

    T: Used
    F: Not used; Existed only in the independent type; Process the selected value by option if being checked.

    option_preset_name

    Option preset name

    If you use "linked with product" option, enter the name of the option set

    use_additional_option

    Whether use additional option

    T: Use
    F: Do not use

    additional_options

    Additional option

    additional_option_name
    Required
    custom text field name

    additional_option_text_length
    Required
    character limit for custom text field
    1~30
    50
    100
    200

    required_additional_option
    Required
    whether a custom text field is required or optional
    T: required
    F: optional
    DEFAULT T
    use_attached_file_option

    Whether use attached file option

    T: Use
    F: Do not use

    attached_file_option

    Attached file option

    Delete a product option

    DELETE /api/v2/admin/products/{product_no}/options

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Delete a product option
    Request Copy
    Response Copy

    Products seo

    Products SEO stands for Search Engine Optimization, which allows SEO APIs to better search for products or shopping malls in search engines.
    As a e,beded Resource of the product, the Products SEO API can set search engine optimization of the target product.

    Endpoints 
    GET /api/v2/admin/products/{product_no}/seo
PUT /api/v2/admin/products/{product_no}/seo

    Products seo properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    meta_title

    Browser title

    Information displayed at product's detail page. Title tag is the most basic information for search which displays at browser.
    meta_author

    Meta tag 1: Author

    Information displayed at tag in product's detail page. You may input the person who manufactured or registered the product.
    meta_description

    Meta tag 2: Description

    Information displayed at tag in product detail page. You may input the information which displays at the search result.
    meta_keywords

    Meta tag 3: Keywords

    Information displayed at tag in product detail page. You may input keywords that want to be searched.
    meta_alt

    Alt text of product image

    Alt text of product image. Image has a better change to be searched if the image has alt text. Browser can shows alt text instead of image which is advantageous for web accessibility.
    search_engine_exposure

    exposure setting for search engine

    Either expose a product at search engine or not. If this set as FALSE, the product will not exposed at search engine.

    T: Use
    F: Do not use

    Retrieve a product's SEO settings

    GET /api/v2/admin/products/{product_no}/seo

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Retrieve a product's SEO settings
    Request Copy
    Response Copy

    Update product SEO settings

    PUT /api/v2/admin/products/{product_no}/seo

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    meta_title

    Browser title

    Information displayed at product's detail page. Title tag is the most basic information for search which displays at browser.

    meta_author

    Meta tag 1: Author

    Information displayed at tag in product's detail page. You may input the person who manufactured or registered the product.

    meta_description

    Meta tag 2: Description

    Information displayed at tag in product detail page. You may input the information which displays at the search result.

    meta_keywords

    Meta tag 3: Keywords

    Information displayed at tag in product detail page. You may input keywords that want to be searched.

    meta_alt

    Alt text of product image

    Alt text of product image. Image has a better change to be searched if the image has alt text. Browser can shows alt text instead of image which is advantageous for web accessibility.

    search_engine_exposure

    exposure setting for search engine

    Either expose a product at search engine or not. If this set as FALSE, the product will not exposed at search engine.

    Update product SEO settings
    Request Copy
    Response Copy

    Products tags

    This resource is about search keywords that can be added to a product so that search by these keyword can return that product. You can add new tags to a product so that it can be searched not only by the product name or product details but also by the keywords.

    This resource can only be used as a child resource of the Products resource.

    Endpoints 
    GET /api/v2/admin/products/{product_no}/tags/count
GET /api/v2/admin/products/{product_no}/tags
POST /api/v2/admin/products/{product_no}/tags
DELETE /api/v2/admin/products/{product_no}/tags/{tag}

    Products tags properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    tags
    Required

    Product tag
    product_no

    Product number

    System assigned code. This code cannot be duplicated.
    tag

    Product tag

    Tag or keyword for product searching.

    Retrieve a count of a product's product tags

    GET /api/v2/admin/products/{product_no}/tags/count

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Retrieve a count of a product's product tags
    Request Copy
    Response Copy

    Retrieve a list of a product's product tags

    GET /api/v2/admin/products/{product_no}/tags

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Retrieve a list of a product's product tags
    Request Copy
    Response Copy

    Create product tags

    POST /api/v2/admin/products/{product_no}/tags

    POST

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    tags
    Required

    Array Max : [50]

    Product tag

    Create product tags
    Request Copy
    Response Copy

    Delete a product tag

    DELETE /api/v2/admin/products/{product_no}/tags/{tag}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    tag

    Product tag

    Tag or keyword for product searching.

    Delete a product tag
    Request Copy
    Response Copy

    Products variants

    Products Variants is the basic unit of goods sold in the shopping mall. Shopping malls usually sell the same items but different sizes or different colors to provide customers with different options.
    Products Variants has the following Resource as a embedded Resource:

    ● Inventories

    Endpoints 
    GET /api/v2/admin/products/{product_no}/variants
GET /api/v2/admin/products/{product_no}/variants/{variant_code}
PUT /api/v2/admin/products/{product_no}/variants/{variant_code}
PUT /api/v2/admin/products/{product_no}/variants
DELETE /api/v2/admin/products/{product_no}/variants/{variant_code}

    Products variants properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    variant_code

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Product item code

    System assigned code. This code cannot be duplicated.
    options

    Option
    custom_variant_code

    Max Length : [40]

    Custom variants code

    You may assign this code manually in case of stock management or other reasons.
    display

    Whether display

    Whether display the variants or not. If this set as TRUE, customer may choose the variants at product detail page or product list page. If this set as FALSE, variants will not be displayed thus cannot buy the variants.

    T: Sell
    F: Do not sell
    selling

    whether selling

    Whether display the variants or not. If this set as TRUE, customer may choose the variants at product detail page or product list page. If this set as FALSE, variants will not be displayed thus cannot buy the variants.

    T: Display
    F: Do not display
    additional_amount

    Additional price

    Additional price for purchase the variants.
    use_inventory

    whether use inventory

    T: Use
    F: Do not use
    important_inventory

    Whether it is an important inventory

    A: General inventory
    B: Important inventory
    inventory_control_type

    Inventory check criteria

    A: Upon order
    B: Upon payment
    display_soldout

    whether display sold-out

    T: Out-of-stock displayed
    F: Out-of-stock not displayed
    quantity

    Available inventory
    safety_inventory

    minimum stock level
    inventories

    Inventories Resource

    Inventory Resource of variants.
    duplicated_custom_variant_code

    Whether duplicate custom variant code

    T: Duplicated
    F: Not duplicated
    product_no

    Product number

    System assigned code. This code cannot be duplicated.

    Retrieve a list of product variants

    GET /api/v2/admin/products/{product_no}/variants

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    inventories
    embed

    Inventories Resource

    Inventory Resource of variants.
    Can search with using embed parameter.

    You can search multiple item with ,(comma)

    Retrieve a list of product variants
    Request Copy
    Response Copy

    Retrieve a product variant

    GET /api/v2/admin/products/{product_no}/variants/{variant_code}

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    variant_code
    Required

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Variant code

    inventories
    embed

    Inventories Resource


    Can search with using embed parameter.

    Retrieve a product variant
    Request Copy
    Response Copy

    Update a product variant

    PUT /api/v2/admin/products/{product_no}/variants/{variant_code}

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    variant_code
    Required

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Product item code

    System assigned code. This code cannot be duplicated.

    custom_variant_code

    Max Length : [40]

    Custom variants code

    You may assign this code manually in case of stock management or other reasons.

    display

    Whether display

    Whether display the variants or not. If this set as TRUE, customer may choose the variants at product detail page or product list page. If this set as FALSE, variants will not be displayed thus cannot buy the variants.

    T: Display
    F: Do not display

    selling

    whether selling

    Whether display the variants or not. If this set as TRUE, customer may choose the variants at product detail page or product list page. If this set as FALSE, variants will not be displayed thus cannot buy the variants.

    T: Sell
    F: Do not sell

    additional_amount

    Additional price

    Additional price for purchase the variants.

    quantity

    Available inventory

    use_inventory

    whether use inventory

    T: Use
    F: Do not use

    important_inventory

    Whether it is an important inventory

    A: General inventory
    B: Important inventory

    inventory_control_type

    Inventory check criteria

    A: Upon order
    B: Upon payment

    display_soldout

    whether display sold-out

    T: Out-of-stock displayed
    F: Out-of-stock not displayed

    safety_inventory

    minimum stock level

    Update a product variant
    Request Copy
    Response Copy

    Update multiple product variants

    PUT /api/v2/admin/products/{product_no}/variants

    PUT

    It is an variants update API which can modify several items of one product at a time.

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 100

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    variant_code
    Required

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Product item code

    custom_variant_code

    Max Length : [40]

    Custom variants code

    display

    Whether display

    T: Display
    F: Do not display

    selling

    whether selling

    T: Sell
    F: Do not sell

    additional_amount

    Additional price

    quantity

    Available inventory

    use_inventory

    whether use inventory

    T: Use
    F: Do not use

    important_inventory

    Whether it is an important inventory

    A: General inventory
    B: Important inventory

    inventory_control_type

    Inventory check criteria

    A: Upon order
    B: Upon payment

    display_soldout

    whether display sold-out

    T: Out-of-stock displayed
    F: Out-of-stock not displayed

    safety_inventory

    minimum stock level

    Delete a product variant

    DELETE /api/v2/admin/products/{product_no}/variants/{variant_code}

    DELETE

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40

    Request

    Parameter Description
    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    variant_code
    Required

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Product item code

    System assigned code. This code cannot be duplicated.

    Delete a product variant
    Request Copy
    Response Copy

    Products variants inventories

    Products Variants Inventories refers to the quantity of eligible items available for sale. Products Variants Inventories is available for each variant. If the variants sold out over than Products Variants Inventories, the product becomes out of stock status.

    Endpoints 
    GET /api/v2/admin/products/{product_no}/variants/{variant_code}/inventories
PUT /api/v2/admin/products/{product_no}/variants/{variant_code}/inventories

    Products variants inventories properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    variant_code

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Variant code

    System assigned code. This code cannot be duplicated.
    use_inventory

    whether use inventory

    Whether use inventory management or not at the variants. You may input inventory when using inventory management option. If the set as FALSE, you may sell product regardless of inventory and cannot use 'Available inventory', 'Inventory check criteria', 'Soldout display' attributes.

    T: Use
    F: Do not use
    important_inventory

    Whether it is an important inventory

    Whether the inventory is important or not. Mall can use this information as a data for search.

    A: General inventory
    B: Important inventory
    inventory_control_type

    Inventory check criteria

    Decide when the inventory will be deducted. You may set inventory deduction criteria differently.

    Order criteria : Inventory deducted when order made. When customer choose to pay with account transfer, the inventory deducted before money transferred.
    Payment criteria : Inventory deducted when payment made. When customer choose to pay with account transfer, the inventory deducted after money transferred.

    A: Upon order
    B: Upon payment
    display_soldout

    whether display sold-out

    Whether display 'Sold out' when if the product use the inventory option. If this set as TRUE(display sold-out), customer cannot purchase the product after displayed as 'Sold out'. 'Sold out' icon will be displayed on the product after every variants being sold out.
    If this set as FALSE(do not display sold-out), customer can purchase the product and inventory will be shown as negative(-).

    T: Out-of-stock displayed
    F: Out-of-stock not displayed
    quantity

    Available inventory

    Available inventory to sale. The number will deduct when order or payment made. Available inventory counted to shows 'Sold out' or not.
    safety_inventory

    minimum stock level
    origin_code

    Shipping origin code

    Retrieve inventory details of a product variant

    GET /api/v2/admin/products/{product_no}/variants/{variant_code}/inventories

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    variant_code
    Required

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Variant code

    Variants code for search sales volume.

    Retrieve inventory details of a product variant
    Request Copy
    Response Copy

    Update a product variant inventory

    PUT /api/v2/admin/products/{product_no}/variants/{variant_code}/inventories

    PUT

    Specification

    Property Description
    SCOPE mall.write_product
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    variant_code
    Required

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Variant code

    System assigned code. This code cannot be duplicated.

    use_inventory

    whether use inventory

    Whether use inventory management or not at the variants. You may input inventory when using inventory management option. If the set as FALSE, you may sell product regardless of inventory and cannot use 'Available inventory', 'Inventory check criteria', 'Soldout display' attributes.

    T: Use
    F: Do not use

    important_inventory

    Whether it is an important inventory

    Whether the inventory is important or not. Mall can use this information as a data for search.

    A: General inventory
    B: Important inventory

    inventory_control_type

    Inventory check criteria

    Decide when the inventory will be deducted. You may set inventory deduction criteria differently.

    Order criteria : Inventory deducted when order made. When customer choose to pay with account transfer, the inventory deducted before money transferred.
    Payment criteria : Inventory deducted when payment made. When customer choose to pay with account transfer, the inventory deducted after money transferred.

    A: Upon order
    B: Upon payment

    display_soldout

    whether display sold-out

    Whether display 'Sold out' when if the product use the inventory option. If this set as TRUE(display sold-out), customer cannot purchase the product after displayed as 'Sold out'. 'Sold out' icon will be displayed on the product after every variants being sold out.
    If this set as FALSE(do not display sold-out), customer can purchase the product and inventory will be shown as negative(-).

    T: Out-of-stock displayed
    F: Out-of-stock not displayed

    quantity

    Available inventory

    Available inventory to sale. The number will deduct when order or payment made. Available inventory counted to shows 'Sold out' or not.

    safety_inventory

    minimum stock level

    origin_code

    Shipping origin code

    Update a product variant inventory
    Request Copy
    Response Copy

    Order

    Cancellation

    Endpoints 
    GET /api/v2/admin/cancellation/{claim_code}
POST /api/v2/admin/cancellation
PUT /api/v2/admin/cancellation

    Cancellation properties

    Attribute Description
    shop_no

    Shop Number
    order_id

    Order ID
    claim_code

    Cancellation number
    claim_reason_type

    division

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others
    claim_reason

    Reason
    refund_method

    Refund method
    refund_reason

    Remarks
    order_price_amount

    Purchase amount
    refund_amount

    refund amount
    shipping_fee

    shipping fee
    return_ship_type

    Return shipping cost classification
    defer_commission

    Postpayment Fee
    partner_discount_amount

    Affiliate discount cancellation amount
    add_discount_amount

    Extra discount discount by product
    member_grade_discount_amount

    Membership Discount Discount Amount
    shipping_discount_amount

    Shipping discount cancellation amount
    coupon_discount_amount

    Coupon discount cancellation amount
    point_used

    Reimbursement Return Used
    credit_used

    Deposit Refund Used
    undone

    Undo

    T: Yes
    F: No
    undone_reason_type

    Reason for undoing

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others
    undone_reason

    Reason for undoing (Details)
    expose_order_detail

    display reason in order details

    T: yes
    F: no
    exposed_undone_reason

    Reason for undoing (Storefront)
    items

    Order item code
    include_tax

    Include tax in prices

    T: Yes
    F: No
    tax

    Tax information
    status

    Order status

    canceled : canceled
    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover
    add_memo_too

    add to admin memo

    T: Enable
    F: Disable

    Retrieve an order cancellation

    GET /api/v2/admin/cancellation/{claim_code}

    GET

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    claim_code
    Required

    Cancellation number

    Retrieve an order cancellation
    Request Copy
    Response Copy

    Create multiple order cancellations

    POST /api/v2/admin/cancellation

    POST

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 100

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    status
    Required

    Order status

    canceled : canceled

    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover

    DEFAULT F

    recover_coupon

    restore a coupon

    Unavailable for marketplace or NAVER Pay order cancellations

    T : Recover
    F : Do not recover

    DEFAULT F

    recover_coupon_no

    Coupon number to be recovered

    add_memo_too

    add to admin memo

    Unavailable for marketplace or NAVER Pay order cancellations

    T: Enable
    F: Disable

    DEFAULT F

    reason

    Max Length : [2000]

    reason for cancellation

    claim_reason_type

    type of reason for cancellation

    Unavailable for marketplace or NAVER Pay order cancellations

    A: change of mind
    B: shipping delay
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    G: dissatisfied with service
    H: out of stock
    I: others

    naverpay_cancel_reason_type

    reason for NAVER Pay order cancellation

    Unavailable for Cafe24 store or marketplace order cancellations

    This cannot be used on Cafe24 Vietnam, Philippines.

    51 : change of mind
    52 : change color or size
    53 : bought by mistake
    54 : dissatisfied with service or product
    55 : delay in shipping
    56 : out of stock
    60 : different from product details

    refund_method_code

    Refund method

    T : cash
    F : credit card
    M : points
    G : bank transfer
    C : mobile
    D : credits
    Z : COD
    O : digital wallet balance
    V : convenience store
    I : others

    combined_refund_method

    Mixed refund methods

    When credit card, bank transfer or mobile payment is selected as refund method (refund_method_code), another payment method that will be used to receive refunds for an order paid with multiple payment methods can be selected.

    Note that when the refund amount is smaller than the amount paid via payment gateway, total refund will be processed via the main payment method.

    T : cash
    M : points
    D : credits

    refund_bank_code

    code assigned to bank for refunds

    Required when refund method (refund_method) is set as cash (T)

    refund_bank_code

    Required for Korean stores
    Available only when refund method (refund_method) is set as cash (T)
    Unavailable for marketplace or NAVER Pay order cancellations

    refund_bank_name

    Max Length : [250]

    Bank name

    Required when refund method (refund_method) is set as cash (T)

    Required for international stores

    Available only when refund method (refund_method) is set as cash (T)
    Unavailable for marketplace or NAVER Pay order cancellations

    refund_bank_account_no

    Refund account number

    Available only when refund method (refund_method) is set as cash (T)
    Unavailable for marketplace or NAVER Pay order cancellations

    refund_bank_account_holder

    Max Length : [15]

    Refund Account Account Holder's Name

    items

    Order item code

    order_item_code
    Required
    Order item code

    quantity
    Required
    Available inventory
    Create multiple order cancellations
    Request Copy
    Response Copy

    Change cancellation details in bulk

    PUT /api/v2/admin/cancellation

    PUT

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 10

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    claim_code
    Required

    Cancellation number

    recover_inventory
    Required

    Inventory Recovery

    T : Recover
    F : Do not recover

    undone
    Required

    Undo

    T : 철회함

    add_memo_too
    Required

    add to admin memo

    T: Enable
    F: Disable

    undone_reason_type
    Required

    Reason for undoing

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others

    undone_reason

    Max Length : [2000]

    Reason for undoing (Details)

    expose_order_detail
    Required

    display reason in order details

    T: yes
    F: no

    exposed_undone_reason

    Max Length : [2000]

    Reason for undoing (Storefront)

    Change cancellation details in bulk
    Request Copy
    Response Copy

    Cancellationrequests

    Endpoints 
    POST /api/v2/admin/cancellationrequests
PUT /api/v2/admin/cancellationrequests

    Cancellationrequests properties

    Attribute Description
    shop_no

    Shop Number
    order_id

    Order ID
    items

    list of items
    undone

    Rejected to accept
    order_item_code

    Order item code

    Create a cancellation request for multiple items

    POST /api/v2/admin/cancellationrequests

    POST

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 100

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    reason_type
    Required

    type of reason for cancellation

    A: change of mind
    B: shipping delay
    G: dissatisfied with service
    I: others

    reason
    Required

    Max Length : [2000]

    reason for cancellation

    refund_bank_code

    code assigned to bank for refunds

    Required when refund method (refund_method) is set as cash (T)

    refund_bank_code

    Required for Korean stores
    Available only when refund method (refund_method) is set as cash (T)
    Unavailable for marketplace or NAVER Pay order cancellations

    refund_bank_name

    Max Length : [250]

    Bank name

    refund_bank_account_no

    Refund account number

    refund_bank_account_holder

    Max Length : [15]

    Refund Account Account Holder's Name

    items

    list of items

    order_item_code
    Required
    Order item code

    quantity
    Required
    Available inventory
    Create a cancellation request for multiple items
    Request Copy
    Response Copy

    Reject a cancellation request for multiple items

    PUT /api/v2/admin/cancellationrequests

    PUT

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 100

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    order_item_code
    Required

    Order item code

    undone
    Required

    Rejected to accept

    T: Yes

    reason_type

    type of reason

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others

    reason

    Max Length : [2000]

    Reason

    display_reject_reason

    Display reason in [Storefront>My Orders]

    T: yes
    F: no

    DEFAULT F

    reject_reason

    Max Length : [2000]

    reason for rejection

    Reject a cancellation request for multiple items
    Request Copy
    Response Copy

    Cashreceipt

    Endpoints 
    GET /api/v2/admin/cashreceipt
POST /api/v2/admin/cashreceipt
PUT /api/v2/admin/cashreceipt/{cashreceipt_no}

    Cashreceipt properties

    Attribute Description
    cashreceipt_no

    Cash receipt number
    approval_no

    Approval Number
    request_date

    Date requested
    order_id

    Order ID
    member_id

    Member id
    name

    Requester
    order_price_amount

    Purchase amount
    vat

    VAT
    subtotal

    Subtotal
    order_status

    Order status

    Awaiting payment: unpaid
    Non delivered: unshipped
    In transit: shipping
    Awaiting shipment: standby
    Delivered: shipped
    Partially canceled: partially_canceled
    Canceled: canceled
    status

    status

    Requested: request
    Awaiting issuance: await_issuance
    Issued: issued
    Issuance rejected: issuance_rejected
    Request canceled: canceled_request
    Issuance canceled: canceled_issuance
    Issuance failed: failed_issuance
    pg_name

    Requested payment gateway
    cash_bill_no

    Cash receipt serial number
    type

    Issuance type

    Individual: personal
    Business: business
    company_registration_no

    Company registration number
    cellphone

    Mobile
    tax_amount

    Tax amount
    tax_free_amount

    Deductions
    supply_price

    Total cost

    Retrieve a list of cash receipts

    GET /api/v2/admin/cashreceipt

    GET

    This API can only be used in stores using Korean.

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    start_date
    Required

    timezone

    Search Start Date

    end_date
    Required

    timezone

    Search End Date

    order_id

    Order ID

    Order ID

    You can search multiple item with ,(comma)

    approval_no

    Max Length : [9]

    Approval Number

    name

    Max Length : [20]

    Requester

    member_id

    Max Length : [20]

    Member id

    status

    status

    All: all
    Requested: request
    Issued: issued
    Request canceled: canceled_request
    Issuance canceled: canceled_issuance
    Issuance failed: failed_issuance

    DEFAULT all

    limit

    Min : [1]~Max : [500]

    Limit

    DEFAULT 10

    offset

    Max : [8000]

    Start location of list

    DEFAULT 0

    Retrieve a list of cash receipts
    Request Copy
    Response Copy

    Create a cash receipt

    POST /api/v2/admin/cashreceipt

    POST

    This API can only be used in stores using Korean.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    order_id
    Required

    Order ID

    Order ID

    type
    Required

    Issuance type

    Individual: personal
    Business: business

    company_registration_no

    Business Number
    Max Length : [10]

    Company registration number

    cellphone

    Mobile
    Max Length : [11]

    Mobile

    Create a cash receipt
    Request Copy
    Response Copy

    Update a cash receipt

    PUT /api/v2/admin/cashreceipt/{cashreceipt_no}

    PUT

    This API can only be used in stores using Korean.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    cashreceipt_no
    Required

    Min : [1]

    Cash receipt number

    order_id
    Required

    Order ID

    Order ID

    type

    Issuance type

    Individual: personal
    Business: business

    company_registration_no

    Business Number
    Max Length : [10]

    Company registration number

    cellphone

    Mobile
    Max Length : [11]

    Mobile

    Update a cash receipt
    Request Copy
    Response Copy

    Cashreceipt cancellation

    Endpoints 
    PUT /api/v2/admin/cashreceipt/{cashreceipt_no}/cancellation

    Cashreceipt cancellation properties

    Attribute Description
    cashreceipt_no

    Cash receipt number
    order_id

    Order ID
    status

    status

    Request canceled: canceled_request
    Issuance canceled: canceled_issuance

    Update a cash receipt cancellation

    PUT /api/v2/admin/cashreceipt/{cashreceipt_no}/cancellation

    PUT

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    cashreceipt_no
    Required

    Min : [1]

    Cash receipt number

    order_id
    Required

    Order ID

    Order ID

    type
    Required

    Cancellation type

    Cancel request: request
    Cancel issuance: issue

    Update a cash receipt cancellation
    Request Copy
    Response Copy

    Collectrequests

    Endpoints 
    PUT /api/v2/admin/collectrequests/{request_no}

    Collectrequests properties

    Attribute Description
    shop_no

    Shop Number
    request_no

    Request number
    order_id

    Order ID
    order_item_code

    Order item code
    shipping_company_name

    Collection shipping company name
    collect_tracking_no

    Collection tracking number

    Update a collection request

    PUT /api/v2/admin/collectrequests/{request_no}

    PUT

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 30
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    request_no
    Required

    Request number

    collect_tracking_no
    Required

    Max Length : [30]

    Collection tracking number

    Update a collection request
    Request Copy
    Response Copy

    Draftorders

    Endpoints 
    POST /api/v2/admin/draftorders

    Draftorders properties

    Attribute Description
    shop_no

    Shop Number
    order_id

    주문 번호
    payment_amount

    가주문 가격 정보
    order_from_mobile

    Mobile type

    T: Made on mobile
    F: Was not made on mobile

    DEFAULT F
    payment_method

    Max Length : [10]

    payment method code

    cash : deposit without a bankbook
    card : credit card
    cell : mobile
    tcash : bank transfer
    icash : virtual account
    prepaid : digital wallet balance
    credit : credits
    point : points
    pointfy : transferable points
    cvs : convenience store
    cod : COD
    coupon : coupon
    market_discount : market discount
    etc : others
    items

    Order item list

    Create a draft order

    POST /api/v2/admin/draftorders

    POST

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 10

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    member_id

    Max Length : [20]

    Member id

    order_from_mobile

    Mobile type

    T: Mobile order
    F: PC order

    DEFAULT F

    payment_method

    Max Length : [10]

    payment method code

    cash: bank deposit
    card: credit card
    icash: virtual transfer
    tcash : bank transfer
    cell: mobile
    deferpay: collect on delivery (COD)
    point: points

    order_place_id

    Type : [a-zA-Z0-9_-]
    Max Length : [40]

    order channel

    self: PC store (for Cafe24 orders only)
    mobile: mobile web (for Cafe24 orders only)
    mobile_d: mobile app (for Cafe24 orders only)

    country_code

    Country code

    payment_gateway_name

    Max Length : [20]

    PG name

    receiver_name
    Required

    Max Length : [100]

    Receiver name

    receiver_name_en

    Max Length : [100]

    Receiver name (English)

    receiver_name_furigana

    Max Length : [100]

    Receiver name (Pronunciation)

    receiver_phone
    Required

    Receiver phone number

    receiver_cellphone
    Required

    Receiver mobile phone number

    receiver_zipcode

    Length Min : [2]~Max : [14]

    Receiver zip code

    receiver_address1

    Recipient address 1

    receiver_address2

    Recipient address 2

    receiver_city

    city

    receiver_state

    state/region

    shipping_message

    Shipping message

    buyer_name
    Required

    Max Length : [100]

    Orderer name

    buyer_email

    Email

    Buyer Email

    buyer_phone

    Buyer phone number

    buyer_cellphone

    Buyer mobile number

    buyer_zipcode
    Required

    Length Min : [2]~Max : [14]

    Orderer zip code

    buyer_address1
    Required

    Max Length : [250]

    Customer address 1

    buyer_address2
    Required

    Customer address 2

    no_shipping_required

    Shipping address doesn't exist

    T: No
    F: Yes

    DEFAULT F

    buyer_ip

    IP

    Orderer IP

    transaction_id

    Max Length : [100]

    Card transaction ID

    bank_code

    Type : [a-z0-9_-]

    Bank code

    bank_account_no

    Max Length : [30]

    Bank account no

    bank_account_owner_name

    Max Length : [100]

    Bank account holder number

    shipping_type

    Delivery type

    A: Domestic
    B: Overseas

    send_order_message

    Whether to send a new order guide message

    T: send SMS
    F: do not send SMS

    DEFAULT F

    send_payment_guide_message

    Whether to send a deposit guide message

    T: send SMS
    F: do not send SMS

    DEFAULT F

    send_order_email

    Whether to send a new order guide mail

    T: send SMS
    F: do not send SMS

    DEFAULT F

    clearance_information_type

    customs clearance information

    I: ID
    P: Passport number
    C: Personal Customs Clearance Code

    clearance_information

    customs clearance information

    self_payment_cancel

    allowed to cancel with API

    T: yes
    F: no

    DEFAULT F

    self_payment_cancel_url

    cancel with API URL

    items

    Order item list

    product_no
    Required
    Product number

    product_code
    Required
    Product code

    option_id
    Required
    Option ID

    quantity
    Required
    Order quantity

    product_bundle
    Product bundle
    T: Use
    F: Do not use

    prepaid_shipping_fee
    Whether prepaid shipping fee
    P: Prepayment
    C: Pay after delivery

    product_bundle_no
    Set product number
    Create a draft order
    Request Copy
    Response Copy

    Exchange

    Accept exchange request & update exchange status of an order

    Endpoints 
    GET /api/v2/admin/exchange/{claim_code}
POST /api/v2/admin/exchange
PUT /api/v2/admin/exchange

    Exchange properties

    Attribute Description
    shop_no

    Shop Number
    order_id

    Order ID
    claim_code

    Return number
    claim_reason_type

    division

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others
    claim_reason

    Reason
    claim_due_date

    Estimated exchange date
    receiver

    Receiver
    reshipping_detail

    reshipping details
    pickup

    Pickup - Address
    additional_payment

    Additional payment
    return_invoice_no

    return tracking number
    return_shipping_company_name

    return shipping carrier
    refund_method

    Refund method
    refund_reason

    Remarks
    order_price_amount

    Purchase amount
    refund_amount

    refund amount
    shipping_fee

    shipping fee
    return_ship_type

    Return shipping cost classification
    defer_commission

    Postpayment Fee
    partner_discount_amount

    Affiliate discount cancellation amount
    add_discount_amount

    Extra discount discount by product
    member_grade_discount_amount

    Membership Discount Discount Amount
    shipping_discount_amount

    Shipping discount cancellation amount
    coupon_discount_amount

    Coupon discount cancellation amount
    point_used

    Reimbursement Return Used
    credit_used

    Deposit Refund Used
    undone

    Undo

    T: Yes
    F: No
    undone_reason_type

    Reason for undoing

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others
    undone_reason

    Reason for undoing (Details)
    expose_order_detail

    display reason in order details

    T: yes
    F: no
    exposed_undone_reason

    Reason for undoing (Storefront)
    items

    Order item code
    exchanged_items

    Exchanged items
    include_tax

    Include tax in prices

    T: Yes
    F: No
    tax

    Tax information
    status

    Order status

    accept: accept exchange request
    collected: picked up
    exchanged: complete
    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover
    exchanged_after_collected

    exchange status after pickup

    T: Used
    F: Not used
    add_memo_too

    add to admin memo

    T: Enable
    F: Disable
    pickup_completed

    Whether pickup is complete

    T: Yes
    F: No

    Retrieve an exchange

    GET /api/v2/admin/exchange/{claim_code}

    GET

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    claim_code
    Required

    Exchange number

    Retrieve an exchange
    Request Copy
    Response Copy

    Create multiple exchanges

    POST /api/v2/admin/exchange

    POST

    Register a status as either accepted or complete for an exchange request.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 100

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    status
    Required

    Order status

    accepted: Exchange request accepted
    exchanged: Exchanged

    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover

    DEFAULT F

    add_memo_too

    add to admin memo

    T: Enable
    F: Disable

    DEFAULT F

    items

    Order item code

    order_item_code
    Required
    Order item code

    quantity
    Required
    Available inventory

    exchange_variant_code
    Exchange product variant code (when exchanging for a different option of the same product)
    same_product
    Required

    exchange status

    T: exchange for the same product
    F: exchange for another product

    Create multiple exchanges
    Request Copy
    Response Copy

    Update multiple order exchanges

    PUT /api/v2/admin/exchange

    PUT

    Edit a specific order for which an exchange has been requested.
    Withdraw multiple exchange requests, enter reasons for withdrawal and restore inventories.
    Should a collection request submitted be no longer valid, you must contact the courier directly to cancel the request.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 10

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    claim_code
    Required

    Exchange number

    status

    Order status

    exchanged: Exchanged

    pickup_completed

    Whether pickup is complete

    T: Yes
    F: No

    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover

    exchanged_after_collected

    exchange status after pickup

    T: Used
    F: Not used

    items

    Order item code

    order_item_code
    Order item code
    undone

    Undo

    T : 철회함

    add_memo_too

    add to admin memo

    T: Enable
    F: Disable

    undone_reason_type

    Reason for undoing

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others

    undone_reason

    Max Length : [2000]

    Reason for undoing (Details)

    expose_order_detail

    display reason in order details

    T: yes
    F: no

    exposed_undone_reason

    Max Length : [2000]

    Reason for undoing (Storefront)

    Update multiple order exchanges
    Request Copy
    Response Copy

    Exchangerequests

    Endpoints 
    POST /api/v2/admin/exchangerequests
PUT /api/v2/admin/exchangerequests

    Exchangerequests properties

    Attribute Description
    shop_no

    Shop Number
    order_id

    Order ID
    items

    list of items
    exchange_request_no

    exchange request number
    undone

    Rejected to accept
    order_item_code

    Order item code
    additional_payment_gateway_cancel

    추가 PG 취소

    Bulk exchange request API

    POST /api/v2/admin/exchangerequests

    POST

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 100

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    reason_type
    Required

    type of reason

    A: Change of mind
    E: Unsatisfactory product
    K: Defective product
    J: Shipping error
    I: Others

    reason
    Required

    Max Length : [2000]

    Reason for exchange

    request_pickup

    request pickup

    T: Request pickup
    F: Send directly

    pickup

    pickup location details

    name
    Required
    Name

    phone
    Office phone number

    cellphone
    Required
    Mobile

    zipcode
    Required
    Zipcode

    address1
    Required
    Address 1

    address2
    Required
    Address 2
    tracking_no

    Max Length : [30]

    return tracking number

    shipping_company_name

    Max Length : [30]

    return shipping carrier

    refund_bank_code

    code assigned to bank for refunds

    refund_bank_name

    Max Length : [250]

    Bank name

    refund_bank_account_no

    Refund account number

    refund_bank_account_holder

    Max Length : [15]

    Refund Account Account Holder's Name

    items

    list of items

    order_item_code
    Required
    Order item code

    quantity
    Required
    Available inventory
    exchange_items

    Products for exchange

    product_no
    Required
    Product number

    variant_code
    Required
    Product item code

    quantity
    Required
    Available inventory
    Bulk exchange request API
    Request Copy
    Response Copy

    Reject an exchange request for multiple items

    PUT /api/v2/admin/exchangerequests

    PUT

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 100

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    order_item_code
    Required

    Order item code

    undone
    Required

    Rejected to accept

    T: Yes

    reason_type

    type of reason

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others

    reason

    Max Length : [2000]

    Reason

    display_reject_reason

    Display reason in [Storefront>My Orders]

    T: yes
    F: no

    DEFAULT F

    reject_reason

    Max Length : [2000]

    reason for rejection

    Reject an exchange request for multiple items
    Request Copy
    Response Copy

    Labels

    Endpoints 
    POST /api/v2/admin/labels

    Labels properties

    Attribute Description
    shop_no

    Shop Number
    name

    Order label name
    order_item_code

    Order item code

    Create multiple order labels

    POST /api/v2/admin/labels

    POST

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 10

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    name
    Required

    Order label name

    order_item_code
    Required

    Order item code

    Create multiple order labels
    Request Copy
    Response Copy

    Orders

    Orders Resource

    Order is a request from a shopping mall customer to a shopping mall to purchase a product. The shop operator will deliver the goods to the shopping mall customer based on the order information that has been paid. The order information includes information about the orderer who made the order and payment, and the recipient information for shipping the item.

    The order has the following Resource as embedded Resource.
    ● Items
    ● Recipient Information

    Endpoints 
    GET /api/v2/admin/orders
GET /api/v2/admin/orders/{order_id}
GET /api/v2/admin/orders/count
POST /api/v2/admin/orders
PUT /api/v2/admin/orders
PUT /api/v2/admin/orders/{order_id}

    Orders properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    currency

    Currency

    Currecy unit of a mall.
    order_id

    Order ID
    market_id

    Market id

    Unique ID of a market for distinguish each website in case customer purchase through price comparison site.
    market_order_no

    Market order number
    member_id

    Member id
    member_email

    customer email
    member_authentication

    Member authentication

    Member authentication type. Customer divided as 4 types based on member authentication.

    T: authorized
    B: special treatment member J: under 14
    billing_name

    Billing name

    Name of billing. May differ from orderer name or recipient name.
    bank_code

    Bank code

    bank_code

    bank_code_name

    Bank name
    payment_method

    payment method code

    Code of payment method that orderer used for payment.

    cash : deposit without a bankbook
    card : credit card
    cell : mobile
    tcash : bank transfer
    icash : virtual account
    prepaid : digital wallet balance
    credit : credits
    point : points
    pointfy : transferable points
    cvs : convenience store
    cod : COD
    coupon : coupon
    market_discount : market discount
    etc : others
    payment_method_name

    Payment method name

    Name of payment method that orderer used for payment.
    payment_gateway_name

    Payment gateway name

    Name of payment gateway that orderer used for payment.
    sub_payment_method_name

    International payment method name
    sub_payment_method_code

    International payment method code

    sub_payment_method_code

    transaction_id

    Card transaction ID
    paid

    Paid

    Whether or not the order was paid for

    T: Paid
    F: Unpaid
    M: Partially paid
    canceled

    Whether the order is canceled

    T: Canceled
    F: Not Canceled
    M: Partially canceled
    order_date

    timezone

    Ordered date
    first_order

    First order

    Whether the order is the first order from the customer or not.

    T: First order
    F: Not first order
    payment_date

    timezone

    Payment date
    order_from_mobile

    Mobile type

    whether order made on mobile

    T: Made on mobile
    F: Was not made on mobile
    use_escrow

    Whether to use Escrow

    whether customer used escrow or not

    T: Used escrow
    F: Do not used escrow
    group_no_when_ordering

    Customer group number when ordering
    initial_order_amount

    initial payment details
    actual_order_amount

    final payment details
    bank_account_no

    Bank account no

    Bank account number of shooping mall of the specific order.
    bank_account_owner_name

    Bank account holder number
    market_seller_id

    marketplace vendor ID
    payment_amount

    Order total
    cancel_date

    timezone

    Order cancellation date
    order_place_name

    Order path text
    order_place_id

    Available order path
    payment_confirmation

    Whether payment is confirmed

    T: confirmed payment
    F: payment does not confirmed
    commission

    Transaction fee
    postpay

    Whether postpaid

    T: Payment after delivery
    F: No payment after delivery
    admin_additional_amount

    manually input amount
    additional_shipping_fee

    Additional shipping fee
    international_shipping_insurance

    International shipping insurance
    additional_handling_fee

    Additional handling fee
    shipping_type

    Delivery type

    Shipping delivery type. Whether domestic shipping or abroad shipping.

    A: Domestic
    B: Overseas
    shipping_type_text

    Delivery type

    Description of shipping type. Whether domestic shipping or abroad shipping.
    shipping_status

    Delivery status

    F: Awaiting shipment
    M: In transit
    T: Delivered
    W: Shipment on hold
    X: Awaiting confirmation
    wished_delivery_date

    Desired delivery date
    wished_delivery_time

    Desired delivery time
    wished_carrier_id

    Desired courier code
    wished_carrier_name

    name of preferred shipping carrier
    return_confirmed_date

    timezone

    Return approval time
    total_supply_price

    Total supply price
    naver_point

    NAVER points
    additional_order_info_list

    Additional order info
    store_pickup

    Store pickup

    T: Store pickup
    F: No store pickup
    easypay_name

    Easypay payment gateway name
    loan_status

    Loan status

    OK : GOOD
    NG : NOT GOOD
    ER : ERROR
    subscription

    subscription payment

    T: subscription payment
    F: not a subscription payment
    items

    Item Resource
    receivers

    Receiver Resource


    Can search with using embed parameter.
    buyer

    Orderer Resource


    Can search with using embed parameter.
    shipping_fee_detail

    Shipping fee information
    regional_surcharge_detail

    Regional surcharge details
    return

    Return Details Resource


    Can search with using embed parameter.
    cancellation

    Cancellation details Resource


    Can search with using embed parameter.
    exchange

    Exchange details Resource


    Can search with using embed parameter.
    multiple_addresses

    Multi-address order

    T: Yes (Multi-address order)
    F: No (Single-address order)
    exchange_rate

    Exchange rate
    first_payment_method

    initial payment method code

    cash : deposit without a bankbook
    card : credit card
    cell : mobile
    tcash : bank transfer
    icash : virtual account
    prepaid : digital wallet balance
    credit : credits
    point : points
    pointfy : transferable points
    cvs : convenience store
    cod : COD
    etc : others
    naverpay_payment_information

    NaverPay PG payment information

    P: PG payment
    N: NaverPay
    include_tax

    Include tax in prices

    T: Yes
    F: No
    tax_detail

    Tax details
    service_type

    Order service type

    rental : rental order
    service_data

    order service data
    customer_group_no_when_ordering

    Customer group number when ordering

    Customer group number when order occurred.
    benefits

    Benefits Resource


    Can search with using embed parameter.
    coupons

    Coupon Resource


    Can search with using embed parameter.
    refunds

    refund details resource


    Can search with using embed parameter.
    total_discount_amount

    Total discount
    process_status

    Order status

    prepare: preparing for shipment
    prepareproduct: order in progress
    hold: shipment on hold
    unhold: removed from held off shipments
    order_item_code

    Order item code
    purchase_confirmation

    Whether the order was confirmed as received
    collect_points

    Whether points are recaptured

    Retrieve a list of orders

    GET /api/v2/admin/orders

    GET

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    items
    embed

    Item Resource


    Can search with using embed parameter.

    receivers
    embed

    Receiver Resource


    Can search with using embed parameter.

    buyer
    embed

    Orderer Resource


    Can search with using embed parameter.

    return
    embed

    Return Details Resource


    Can search with using embed parameter.

    cancellation
    embed

    Cancellation details Resource


    Can search with using embed parameter.

    exchange
    embed

    Exchange details Resource


    Can search with using embed parameter.

    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    start_date

    timezone

    Search Start Date

    start date for search

    end_date

    timezone

    Search End Date

    Search end date for specific search criteria.
    Must use with 'start_date' simultaneously.
    Search only on specific date if search start and end dates are the same.
    example) 2018-12-31 23:59:59

    order_id

    Order ID

    Order ID

    You can search multiple item with ,(comma)

    order_status

    Order status

    Order status. Each status has its own code.

    You can search multiple item with ,(comma)

    N00: awaiting payment
    N10: order in progress
    N20: preparing for shipment
    N21: awaiting shipment
    N22: shipment on hold
    N30: in transit
    N40: delivered
    N50: Purchase confirmed
    C00: cancellation requested
    C10: cancellation accepted - admin
    C34: cancellation in progress – awaiting refund
    C36: cancellation in progress – refund on hold
    C40: canceled
    C47: canceled before payment - customer
    C48: canceled before payment – auto-canceled
    C49: canceled before payment - admin
    R00: return requested
    R10: return accepted
    R12: return on hold
    R13: return accepted - picked up (automatic)
    R30: return in progress – awaiting pickup
    R34: return in progress – awaiting refund
    R36: return in progress - refund on hold
    R40: returned - refunded
    E00: exchange requested
    E10: exchange accepted
    N01: exchange accepted – replacement
    E12: exchange on hold
    E13: exchange accepted - picked up (automatic)
    E20: exchange postponed
    E30: exchange in progress - awaiting pickup
    E32: exchange in progress - awaiting payment
    E34: exchange in progress – awaiting refund
    E36: exchange in progress – refund on hold
    E40: exchanged

    payment_status

    Payment status

    F: Awaiting payment
    M: Awaiting additional payment
    T: Payment confirmed (manually)
    A: Payment confirmed (automatically)
    P: Payment complete

    member_type

    Member type

    Whether member or not. Each has its own code.

    2: Member
    3: Nonmember

    group_no

    Group number

    buyer_name

    Buyer name

    Name of orderer. May differ from billing name or recipient name.

    receiver_name

    Receiver name

    Name of recipient. May differ from orderer name or billing name.

    name_furigana

    Receiver name (Pronunciation)

    receiver_address

    Receiver address

    Address of recipient. May differ from orderer address or billing address.

    member_id

    Member id

    member id

    member_email

    customer email

    product_no

    Product number

    System assigned code. This code cannot be duplicated.

    product_code

    Product code

    System assigned code. This code cannot be duplicated.

    date_type

    Date type

    Date type for search. Default is date of order.

    order_date : Ordered date
    pay_date : Paid date
    shipbegin_date : Shipped date
    shipend_date : Delivered date
    cancel_date : Order cancelled date
    place_date : Order placed date
    updatereceiver_date : Receiver information modified date
    cancel_request_date : Cancellation requested date
    cancel_accept_date : Cancellation accepted date
    cancel_complete_date : Cancelled date
    exchange_request_date : Exchange requested date
    exchange_accept_date : Exchange accepted date
    exchange_complete_date : Exchanged date
    return_request_date : Return requested date
    return_accept_date : Return accepted approved date
    return_complete_date : Returned date
    purchaseconfirmation_date : Purchase confirmation date

    DEFAULT order_date

    supplier_id

    Supplier id

    You can search multiple item with ,(comma)

    order_place_id

    Available order path

    You can search multiple item with ,(comma)

    cafe24:Cafe24
    mobile:mobile web
    mobile_d:mobile app
    NCHECKOUT:NAVER Pay
    inpark:Interpark
    auction:Auction
    sk11st:11th Street
    gmarket:Gmarket
    coupang:Coupang
    shopn:Smart store

    buyer_cellphone

    Buyer mobile number

    buyer_phone

    Buyer phone number

    buyer_email

    Buyer Email

    inflow_path

    sales funnel

    subscription

    subscription payment

    T: subscription payment
    F: not a subscription payment

    market_order_no

    Type : [a-zA-Z0-9_-]
    Max Length : [40]

    Market order number

    You can search multiple item with ,(comma)

    market_cancel_request

    marketplace order cancellation

    T: cancellation requested marketplace order

    payment_method

    payment method code

    You can search multiple item with ,(comma)

    cash : deposit without a bankbook
    card : credit card
    tcash : bank transfer
    cell : mobile
    deferpay : COD
    cvs : convenience store
    point : digital wallet balance
    mileage : points
    deposit : credits
    etc : others

    payment_gateway_name

    Payment gateway name

    You can search multiple item with ,(comma)

    market_seller_id

    marketplace vendor ID

    discount_method

    Discount method

    You can search multiple item with ,(comma)

    point: points
    credit: credits
    coupon: coupon
    market_discount: marketplace discount
    discount_code: promo code

    discount_code

    Promo code

    carrier_id

    Min : [1]

    shipping carrier ID

    labels

    주문 라벨

    You can search multiple item with ,(comma)

    limit

    Min : [1]~Max : [1000]

    Limit

    Set the maximum number of search result.
    Example) input '10' shows only '10' result

    DEFAULT 10

    offset

    Max : [15000]

    Start location of list

    DEFAULT 0

    Retrieve an order

    GET /api/v2/admin/orders/{order_id}

    GET

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    Order ID

    items
    embed

    Item Resource


    Can search with using embed parameter.

    receivers
    embed

    Receiver Resource


    Can search with using embed parameter.

    buyer
    embed

    Orderer Resource


    Can search with using embed parameter.

    benefits
    embed

    Benefits Resource


    Can search with using embed parameter.

    coupons
    embed

    Coupon Resource


    Can search with using embed parameter.

    return
    embed

    Return Details Resource


    Can search with using embed parameter.

    cancellation
    embed

    Cancellation details Resource


    Can search with using embed parameter.

    exchange
    embed

    Exchange details Resource


    Can search with using embed parameter.

    refunds
    embed

    refund details resource


    Can search with using embed parameter.

    Retrieve an order
    Request Copy
    Response Copy

    Retrieve a count of orders

    GET /api/v2/admin/orders/count

    GET

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    start_date

    timezone

    Search Start Date

    Search start date for specific search criteria.
    Must use with 'end_date' simultaneously.
    Search only on specific date if search start and end dates are the same.
    example) 2018-12-31 00:00:00

    end_date

    timezone

    Search End Date

    Search end date for searching orders. Must be used with a search start date.

    order_id

    Order ID

    Order ID

    You can search multiple item with ,(comma)

    order_status

    Order status

    Order status. Each status has its own code.

    You can search multiple item with ,(comma)

    N00: awaiting payment
    N10: order in progress
    N20: preparing for shipment
    N21: awaiting shipment
    N22: shipment on hold
    N30: in transit
    N40: delivered
    N50: Purchase confirmed
    C00: cancellation requested
    C10: cancellation accepted - admin
    C34: cancellation in progress – awaiting refund
    C36: cancellation in progress – refund on hold
    C40: canceled
    C47: canceled before payment - customer
    C48: canceled before payment – auto-canceled
    C49: canceled before payment - admin
    R00: return requested
    R10: return accepted
    R12: return on hold
    R13: return accepted - picked up (automatic)
    R30: return in progress – awaiting pickup
    R34: return in progress – awaiting refund
    R36: return in progress - refund on hold
    R40: returned - refunded
    E00: exchange requested
    E10: exchange accepted
    N01: exchange accepted – replacement
    E12: exchange on hold
    E13: exchange accepted - picked up (automatic)
    E20: exchange postponed
    E30: exchange in progress - awaiting pickup
    E32: exchange in progress - awaiting payment
    E34: exchange in progress – awaiting refund
    E36: exchange in progress – refund on hold
    E40: exchanged

    payment_status

    Payment status

    F: Awaiting payment
    M: Awaiting additional payment
    T: Payment confirmed (manually)
    A: Payment confirmed (automatically)
    P: Payment complete

    member_type

    Member type

    Customer settings. Different codes are assigned to customers and guests.

    2: Member
    3: Nonmember

    group_no

    Group number

    buyer_name

    Buyer name

    Name of customer who orders the product. It may be different from the name of the depositor or the recipient.

    receiver_name

    Receiver name

    Name of the recipient. May differ from the address of the customer or the depositor

    name_furigana

    Receiver name (Pronunciation)

    receiver_address

    Receiver address

    Address of the recipient. May differ from the address of the customer or the depositor

    member_id

    Member id

    Customer ID

    member_email

    customer email

    product_no

    Product number

    Product number

    product_code

    Product code

    Search for products of which product codes include the search query that you enter. The search query is case-insensitive.

    date_type

    Date type

    Date filter type for search. The default value is date of order.

    order_date : Ordered date
    pay_date : Paid date
    shipbegin_date : Shipped date
    shipend_date : Delivered date
    cancel_date : Order cancelled date
    place_date : Order placed date
    updatereceiver_date : Receiver information modified date
    cancel_request_date : Cancellation requested date
    cancel_accept_date : Cancellation accepted date
    cancel_complete_date : Cancelled date
    exchange_request_date : Exchange requested date
    exchange_accept_date : Exchange accepted date
    exchange_complete_date : Exchanged date
    return_request_date : Return requested date
    return_accept_date : Return accepted approved date
    return_complete_date : Returned date
    purchaseconfirmation_date : Purchase confirmation date

    DEFAULT order_date

    supplier_id

    Supplier id

    You can search multiple item with ,(comma)

    order_place_id

    Available order path

    You can search multiple item with ,(comma)

    cafe24:Cafe24
    mobile:mobile web
    mobile_d:mobile app
    NCHECKOUT:NAVER Pay
    inpark:Interpark
    auction:Auction
    sk11st:11th Street
    gmarket:Gmarket
    coupang:Coupang
    shopn:Smart store

    buyer_cellphone

    Buyer mobile number

    buyer_phone

    Buyer phone number

    buyer_email

    Buyer Email

    inflow_path

    sales funnel

    subscription

    subscription payment

    T: subscription payment
    F: not a subscription payment

    market_order_no

    Type : [a-zA-Z0-9_-]
    Max Length : [40]

    Market order number

    You can search multiple item with ,(comma)

    market_cancel_request

    marketplace order cancellation

    T: cancellation requested marketplace order

    payment_method

    payment method code

    You can search multiple item with ,(comma)

    cash : deposit without a bankbook
    card : credit card
    tcash : bank transfer
    cell : mobile
    deferpay : COD
    cvs : convenience store
    point : digital wallet balance
    mileage : points
    deposit : credits
    etc : others

    payment_gateway_name

    Payment gateway name

    You can search multiple item with ,(comma)

    market_seller_id

    marketplace vendor ID

    discount_method

    Discount method

    You can search multiple item with ,(comma)

    point: points
    credit: credits
    coupon: coupon
    market_discount: marketplace discount
    discount_code: promo code

    discount_code

    Promo code

    carrier_id

    Min : [1]

    shipping carrier ID

    labels

    주문 라벨

    You can search multiple item with ,(comma)

    Retrieve a count of orders
    Request Copy
    Response Copy

    Create an order

    POST /api/v2/admin/orders

    POST

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 10

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    order_type
    Required

    order type

    openmarket: Marketplace order
    self: Online store order
    tollgate: Tollgate order
    externalpay: External order with payment made

    market_seller_id

    marketplace vendor ID

    paid
    Required

    Paid

    T: Payment completed
    F: Before payment

    payment_request

    request a payment

    T: yes
    F: no

    DEFAULT F

    order_place_id

    Type : [a-zA-Z0-9_-]
    Max Length : [40]

    order channel

    self: PC store (for Cafe24 orders only)
    mobile: mobile web (for Cafe24 orders only)
    mobile_d: mobile app (for Cafe24 orders only)

    inflow_id

    Max Length : [40]

    Inflow Channel ID

    market_order_no

    Type : [a-zA-Z0-9_-]
    Max Length : [40]

    Market order number

    member_id

    Max Length : [20]

    Member id

    guest_password

    guest orders password

    buyer_name
    Required

    Max Length : [100]

    Orderer name

    buyer_zipcode
    Required

    Length Min : [2]~Max : [14]

    Orderer zip code

    buyer_address1
    Required

    Max Length : [250]

    Customer address 1

    buyer_address2
    Required

    Customer address 2

    buyer_phone

    Buyer phone number

    buyer_cellphone

    Buyer mobile number

    buyer_email

    Email

    Buyer Email

    no_shipping_required

    Shipping address doesn't exist

    T: No
    F: Yes

    DEFAULT F

    buyer_ip

    IP

    Orderer IP

    receiver_name
    Required

    Max Length : [100]

    Receiver name

    receiver_name_en

    Max Length : [100]

    Receiver name (English)

    receiver_name_furigana

    Max Length : [100]

    Receiver name (Pronunciation)

    receiver_zipcode

    Length Min : [2]~Max : [14]

    Receiver zip code

    receiver_address1

    Recipient address 1

    receiver_address2

    Recipient address 2

    receiver_city

    city

    receiver_state

    state/region

    receiver_phone
    Required

    Receiver phone number

    receiver_cellphone
    Required

    Receiver mobile phone number

    shipping_message

    Shipping message

    billing_name
    Required

    Billing name

    payment_amount
    Required

    Order total

    shipping_fee
    Required

    shipping fee

    payment_method

    Max Length : [10]

    payment method code

    cash: bank deposit
    card: credit card
    icash: virtual transfer
    tcash : bank transfer
    cell: mobile
    deferpay: collect on delivery (COD)
    point: points

    bank_code

    Type : [a-z0-9_-]

    Bank code

    bank_account_no

    Max Length : [30]

    Bank account no

    bank_account_owner_name

    Max Length : [100]

    Bank account holder number

    payment_gateway_name

    Max Length : [20]

    PG name

    transaction_id

    Max Length : [100]

    Card transaction ID

    sub_payment_method_code

    Max Length : [10]

    International payment method code

    sub_payment_method_code

    additional_discount_name

    Max Length : [255]

    name of benefit

    additional_discount_price

    Additional discount price

    shipping_type
    Required

    Delivery type

    Shipping delivery type. Whether domestic shipping or abroad shipping.

    A: Domestic
    B: Overseas

    country_code

    Country code

    order_from_mobile

    Mobile type

    T: Mobile order
    F: PC order

    DEFAULT F

    wished_delivery_date

    Date

    Desired delivery date

    wished_delivery_date_asap

    the earliest possible delivery date

    T: Use
    F: Do not use

    wished_delivery_start_hour

    Min : [0]~Max : [23]

    Desired delivery start time

    wished_delivery_end_hour

    Min : [0]~Max : [23]

    Desired delivery completion time

    wished_delivery_hour_asap

    the earliest possible delivery time

    T: Use
    F: Do not use

    send_order_message

    Whether to send a new order guide message

    T: send SMS
    F: do not send SMS

    DEFAULT F

    send_payment_guide_message

    Whether to send a deposit guide message

    T: send SMS
    F: do not send SMS

    DEFAULT F

    send_order_email

    Whether to send a new order guide mail

    T: send SMS
    F: do not send SMS

    DEFAULT F

    open_market_status

    market status check for 'payment complete' / 'after order'

    10: Before order
    20: After order

    market_order_info

    marketplace other information

    include_not_mall_product
    Required

    settings for including unsynced products

    T: Use
    F: Do not use

    update_inventory
    Required

    settings for reduction from inventory

    T: Deduct
    F: Do not deduct

    subscription

    subscription payment

    T: subscription payment
    F: not a subscription payment

    DEFAULT F

    order_date

    Date

    Ordered date

    payment_date

    Date

    Payment date

    clearance_information_type

    customs clearance information

    I: ID
    P: Passport number
    C: Personal Customs Clearance Code

    clearance_information

    customs clearance information

    self_payment_cancel

    allowed to cancel with API

    T: yes
    F: no

    DEFAULT F

    self_payment_cancel_url

    cancel with API URL

    shipping_tax_rate

    Min : [0]~Max : [100]

    Shipping fee tax rate

    shipping_tax_amount

    Shipping fee tax amount

    items

    Order item list

    market_item_sequence
    list of external product variants in order

    market_item_no
    Number by external item

    product_code
    Required
    Product code

    product_no
    Required
    Product number

    product_name
    Required
    Product name

    options
    Option

    option_id
    Required
    Option ID

    quantity
    Required
    Order quantity

    supply_price
    Product supply price

    product_price
    Required
    Product price

    option_price
    Option price

    hs_code
    HS code

    supplier_id
    Supplier id

    individual_shipping_fee
    Individual shipping fee

    shipping_fee_type
    Shipping charge
    X: Basic shipping
    T: Individual shipping (Free shipping)
    M: Individual shipping (Flat rate or purchase amount based shipping rate)
    D: Individual shipping (Shipping rate based on purchase amount)
    W: Individual shipping (Shipping rate based on weight)
    C: Individual shipping (Shipping rate based on quantity)
    N: Individual shipping (Shipping rate based on quantity)
    F: Individual shipping (Cash on Delivery)
    DEFAULT X

    product_tax_type
    Tax classify by products
    A: Taxable
    B: Tax-free C: Nontaxable

    tax_rate
    Tax rate

    tax_amount
    Tax amount

    tax_round_unit
    Truncation setting when calculating tax amount
    F: Round down
    R: Round half up
    C: Round up

    supplier_transaction_type
    Supplier transaction type
    D: Cost-based
    P: Sales-based commission

    commission
    Supplier tax rate

    discount_price
    discount

    market_additional_product_id
    additional composition product for Market

    market_custom_variant_code
    online marketplace custom variant code

    additional_option_values Array

    key
    Additional option key value

    type
    Additional option type

    name
    Additional option name

    value
    Additional option value
    Create an order
    Request Copy
    Response Copy

    Update status for multiple orders

    PUT /api/v2/admin/orders

    PUT

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 100

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    process_status

    Order status

    prepare: preparing for shipment
    prepareproduct: order in progress
    hold: shipment on hold
    unhold: removed from held off shipments

    order_item_code

    Order item code

    purchase_confirmation

    Whether the order was confirmed as received

    T: Yes
    F: Confirmation retracted

    collect_points

    Whether points are recaptured

    T: Yes
    F: No

    DEFAULT F

    Update an order status

    PUT /api/v2/admin/orders/{order_id}

    PUT

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    process_status

    Order status

    prepare: preparing for shipment
    prepareproduct: order in progress
    hold: shipment on hold
    unhold: removed from held off shipments

    order_item_code

    Order item code

    purchase_confirmation

    Whether the order was confirmed as received

    T: Yes
    F: Confirmation retracted

    collect_points

    Whether points are recaptured

    T: Yes
    F: No

    DEFAULT F

    Orders autocalculation

    Endpoints 
    DELETE /api/v2/admin/orders/{order_id}/autocalculation

    Orders autocalculation properties

    Attribute Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1
    order_id

    Order ID

    Remove auto calculation setting of an order

    DELETE /api/v2/admin/orders/{order_id}/autocalculation

    DELETE

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    Order ID

    Remove auto calculation setting of an order
    Request Copy
    Response Copy

    Orders benefits

    Endpoints 
    GET /api/v2/admin/orders/benefits

    Orders benefits properties

    Attribute Description
    shop_no

    Shop Number
    order_id

    Order ID
    order_item_code

    Order item code
    benefit_no

    number of benefit
    benefit_title

    type of benefit
    benefit_name

    name of benefit
    benefit_code

    Benefit code
    benefit_percent

    Benefit ratio
    benefit_value

    Benefit amount

    Retrieve a list of order benefits applied to an order

    GET /api/v2/admin/orders/benefits

    GET

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    Order ID

    You can search multiple item with ,(comma)

    limit

    Min : [1]~Max : [500]

    Limit

    DEFAULT 10

    offset

    Max : [8000]

    Start location of list

    DEFAULT 0

    Retrieve a list of order benefits applied to an order
    Request Copy
    Response Copy

    Orders buyer

    A resource about a customer’s name, contact information, and address. You can only use this resource as a child resource of the Order resource.

    Endpoints 
    GET /api/v2/admin/orders/{order_id}/buyer
PUT /api/v2/admin/orders/{order_id}/buyer

    Orders buyer properties

    Attribute Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages
    member_id

    Member id
    member_group_no

    customer group number when ordered

    Customer group number.
    name

    Buyer name

    Name of recipient. May differ from orderer name or billing name.
    names_furigana

    orderer name in Japanese Furigana
    email

    Buyer Email

    email of the customer
    phone

    Buyer phone number

    Phone number of a buyer.
    cellphone

    Buyer mobile number

    Cellphone number of a buyer.
    customer_notification

    customer notification

    Note for customer to know.
    updated_date

    timezone

    Updated date
    user_id

    ID of the persons modified the orderer

    Id of a person who updated buyer information.
    user_name

    name of the persons modified the order

    Nmae of a person who updated buyer information.
    order_id

    Order ID

    Order ID

    order number

    Retrieve customer details of an order

    GET /api/v2/admin/orders/{order_id}/buyer

    GET

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    Order ID

    order number

    Retrieve customer details of an order
    Request Copy
    Response Copy

    Update customer information of an order

    PUT /api/v2/admin/orders/{order_id}/buyer

    PUT

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    A unique number assigned to a store using the default store language or other languages

    DEFAULT 1

    order_id
    Required

    Order ID

    Order ID

    order number

    name

    Buyer name

    Name of recipient. May differ from orderer name or billing name.

    email

    Email

    Buyer Email

    email of the customer

    phone

    Buyer phone number

    Phone number of a buyer.

    cellphone

    Buyer mobile number

    Cellphone number of a buyer.

    customer_notification

    customer notification

    Note for customer to know.

    Update customer information of an order
    Request Copy
    Response Copy

    Orders buyer history

    Endpoints 
    GET /api/v2/admin/orders/{order_id}/buyer/history

    Orders buyer history properties

    Attribute Description
    shop_no

    Min : [1]

    Shop Number
    name

    Buyer name
    email

    Email

    Buyer Email
    phone

    Buyer phone number
    cellphone

    Buyer mobile number
    customer_notification

    customer notification
    updated_date

    timezone

    Updated date
    user_id

    ID of the persons modified the orderer
    user_name

    name of the persons modified the order

    Retrieve a list of customer history of an order

    GET /api/v2/admin/orders/{order_id}/buyer/history

    GET

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    Order ID

    Retrieve a list of customer history of an order
    Request Copy
    Response Copy

    Orders calculation

    Endpoints 
    POST /api/v2/admin/orders/calculation

    Orders calculation properties

    Attribute Description
    shop_no

    Shop Number
    mobile

    Whether it is mobile or PC
    member_id

    Member id
    shipping_type

    Delivery type

    A: Domestic
    B: Overseas
    payment_method

    payment method code

    cash: bank deposit
    card: credit card
    icash: virtual transfer
    tcash : bank transfer
    cell: mobile
    deferpay: collect on delivery (COD)
    point: points
    country_code

    Country code
    carrier_id

    shipping carrier ID
    zipcode

    Zipcode
    address_full

    Full address
    address_state

    state
    items

    Order item list
    membership_discount_amount

    customer tier-based discount
    shipping_fee_discount_amount

    shipping discount
    product_discount_amount

    per-product discount
    order_price_amount

    product subtotal
    total_discount_amount

    Total discount
    shipping_fee

    shipping fee
    total_amount_due

    total due
    shipping_fee_information

    배송비 상세정보

    Calculate total due

    POST /api/v2/admin/orders/calculation

    POST

    Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    mobile

    Whether it is mobile or PC

    T: Use
    F: Do not use

    DEFAULT F

    member_id

    Max Length : [20]

    Member id

    shipping_type

    Delivery type

    A: Domestic
    B: Overseas

    DEFAULT A

    payment_method

    payment method code

    cash: bank deposit
    card: credit card
    icash: virtual transfer
    tcash : bank transfer
    cell: mobile
    deferpay: collect on delivery (COD)
    point: points

    country_code

    Country code

    carrier_id

    shipping carrier ID

    zipcode

    Zipcode

    address_full

    Max Length : [1000]

    Full address

    address_state

    Max Length : [255]

    state

    items

    Order item list

    product_no
    Required
    Product number

    variant_code
    Required
    Product item code

    quantity
    Required
    Available inventory

    product_price
    Required
    Product price

    option_price
    Option price

    product_bundle
    Product bundle
    T: Set product
    F: No set product
    DEFAULT F

    product_bundle_no
    Set product number

    prepaid_shipping_fee
    Whether prepaid shipping fee
    P: Prepayment
    C: Pay after delivery
    DEFAULT P
    Calculate total due
    Request Copy
    Response Copy

    Orders cancellation

    Endpoints 
    POST /api/v2/admin/orders/{order_id}/cancellation
PUT /api/v2/admin/orders/{order_id}/cancellation/{claim_code}

    Orders cancellation properties

    Attribute Description
    shop_no

    Shop Number
    order_id

    Order ID
    status

    Order status

    canceled : canceled
    claim_code

    Cancellation number
    items

    Order item code
    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover
    undone

    Undo

    T: Yes
    F: No
    add_memo_too

    add to admin memo

    T: Enable
    F: Disable
    undone_reason_type

    Reason for undoing

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others
    undone_reason

    Reason for undoing (Details)
    expose_order_detail

    display reason in order details

    T: yes
    F: no
    exposed_undone_reason

    Reason for undoing (Storefront)

    Create an order cancellation

    POST /api/v2/admin/orders/{order_id}/cancellation

    POST

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    payment_gateway_cancel

    PG cancellation request settings

    Cancellations cannot be processed via payment gateways when multiple payment methods have been used. Cancellations must be processed through Cafe24 admin system.
    Unavailable for marketplace or NAVER Pay order cancellations

    T : cancel
    F : do not cancel

    DEFAULT F

    status
    Required

    Order status

    canceled : canceled

    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover

    DEFAULT F

    recover_coupon

    restore a coupon

    Unavailable for marketplace or NAVER Pay order cancellations

    T : Recover
    F : Do not recover

    DEFAULT F

    recover_coupon_no

    Coupon number to be recovered

    add_memo_too

    add to admin memo

    Unavailable for marketplace or NAVER Pay order cancellations

    T: Enable
    F: Disable

    DEFAULT F

    reason

    Max Length : [2000]

    reason for cancellation

    claim_reason_type

    type of reason for cancellation

    Unavailable for marketplace or NAVER Pay order cancellations

    A: change of mind
    B: shipping delay
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    G: dissatisfied with service
    H: out of stock
    I: others

    naverpay_cancel_reason_type

    reason for NAVER Pay order cancellation

    Unavailable for Cafe24 store or marketplace order cancellations

    This cannot be used on Cafe24 Vietnam, Philippines.

    51 : change of mind
    52 : change color or size
    53 : bought by mistake
    54 : dissatisfied with service or product
    55 : delay in shipping
    56 : out of stock
    60 : different from product details

    refund_method_code

    Refund method

    T : cash
    F : credit card
    M : points
    G : bank transfer
    C : mobile
    D : credits
    Z : COD
    O : digital wallet balance
    V : convenience store
    I : others

    combined_refund_method

    Mixed refund methods

    When credit card, bank transfer or mobile payment is selected as refund method (refund_method_code), another payment method that will be used to receive refunds for an order paid with multiple payment methods can be selected. (Only "F" can be used for "payment_gateway".)

    Note that when the refund amount is smaller than the amount paid via payment gateway, total refund will be processed via the main payment method.

    T : cash
    M : points
    D : credits

    refund_bank_code

    code assigned to bank for refunds

    Required when refund method (refund_method) is set as cash (T)

    refund_bank_code

    Required for Korean stores
    Available only when refund method (refund_method) is set as cash (T)
    Unavailable for marketplace or NAVER Pay order cancellations

    refund_bank_name

    Max Length : [250]

    Bank name

    Required when refund method (refund_method) is set as cash (T)

    Required for international stores

    Available only when refund method (refund_method) is set as cash (T)
    Unavailable for marketplace or NAVER Pay order cancellations

    refund_bank_account_no

    Refund account number

    Required when refund method (refund_method) is set as cash (T)
    Unavailable for marketplace or NAVER Pay order cancellations

    refund_bank_account_holder

    Max Length : [15]

    Refund Account Account Holder's Name

    items

    Order item code

    order_item_code
    Required
    Order item code

    quantity
    Required
    Available inventory
    Create an order cancellation
    Request Copy
    Response Copy

    Change cancellation details

    PUT /api/v2/admin/orders/{order_id}/cancellation/{claim_code}

    PUT

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    claim_code
    Required

    Cancellation number

    recover_inventory
    Required

    Inventory Recovery

    T : Recover
    F : Do not recover

    undone
    Required

    Undo

    T : 철회함

    add_memo_too
    Required

    add to admin memo

    T: Enable
    F: Disable

    undone_reason_type
    Required

    Reason for undoing

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others

    undone_reason

    Max Length : [2000]

    Reason for undoing (Details)

    expose_order_detail
    Required

    display reason in order details

    T: yes
    F: no

    exposed_undone_reason

    Max Length : [2000]

    Reason for undoing (Storefront)

    Change cancellation details
    Request Copy
    Response Copy

    Orders coupons

    Endpoints 
    GET /api/v2/admin/orders/coupons

    Orders coupons properties

    Attribute Description
    shop_no

    Shop Number
    order_id

    Order ID
    order_item_code

    Order item code
    coupon_name

    Coupon name
    coupon_code

    Coupon number
    coupon_percent

    coupon ratio
    coupon_value

    Coupon amount

    Retrieve a list of coupons applied to an order

    GET /api/v2/admin/orders/coupons

    GET

    Specification

    Property Description
    SCOPE mall.read_order
    Request Limit 40

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    Order ID

    You can search multiple item with ,(comma)

    limit

    Min : [1]~Max : [500]

    Limit

    DEFAULT 10

    offset

    Max : [8000]

    Start location of list

    DEFAULT 0

    Retrieve a list of coupons applied to an order
    Request Copy
    Response Copy

    Orders exchange

    Endpoints 
    POST /api/v2/admin/orders/{order_id}/exchange
PUT /api/v2/admin/orders/{order_id}/exchange/{claim_code}

    Orders exchange properties

    Attribute Description
    shop_no

    Shop Number
    order_id

    Order ID
    status

    Order status

    accept: accept exchange request
    collected: picked up
    exchanged: complete
    claim_code

    Exchange number
    items

    Order item code
    pickup_completed

    Whether pickup is complete

    T: Yes
    F: No
    return_invoice_no

    Max Length : [30]

    return tracking number
    return_shipping_company_name

    Max Length : [30]

    return shipping carrier
    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover
    exchanged_after_collected

    exchange status after pickup

    T: Used
    F: Not used
    request_pickup

    request pickup

    T: Used
    F: Not used
    pickup

    pickup location details
    undone

    Undo

    T: Yes
    F: No
    add_memo_too

    add to admin memo

    T: Enable
    F: Disable
    undone_reason_type

    Reason for undoing

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others
    undone_reason

    Reason for undoing (Details)
    expose_order_detail

    display reason in order details

    T: yes
    F: no
    exposed_undone_reason

    Reason for undoing (Storefront)

    Create an order exchange

    POST /api/v2/admin/orders/{order_id}/exchange

    POST

    Accept exchange request of an order.
    Specify whether a same product is exchanged & the status for stock restoration.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Min : [1]

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    Order ID

    status
    Required

    Order status

    accepted: Exchange request accepted
    exchanged: Exchanged

    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover

    DEFAULT F

    add_memo_too

    add to admin memo

    T: Enable
    F: Disable

    DEFAULT F

    items

    Order item code

    order_item_code
    Required
    Order item code

    quantity
    Required
    Available inventory

    exchange_variant_code
    Exchange product variant code (when exchanging for a different option of the same product)
    same_product
    Required

    exchange status

    T: exchange for the same product
    F: exchange for another product

    Create an order exchange
    Request Copy
    Response Copy

    Update an order exchange

    PUT /api/v2/admin/orders/{order_id}/exchange/{claim_code}

    PUT

    You can edit a specific order for which an exchange has been requested.
    You can withdraw an exchange request, enter a reason for withdrawal and restore inventory.
    Should a collection request submitted be no longer valid, you must contact the courier directly to cancel the request.

    Specification

    Property Description
    SCOPE mall.write_order
    Request Limit 40
    objects per single API call Limit 1

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    order_id
    Required

    Order ID

    claim_code
    Required

    Exchange number

    status

    Order status

    exchanged: Exchanged

    pickup_completed

    Whether pickup is complete

    T: Yes
    F: No

    return_invoice_no

    Max Length : [30]

    return tracking number

    return_shipping_company_name

    Max Length : [30]

    return shipping carrier

    recover_inventory

    Inventory Recovery

    T : Recover
    F : Do not recover

    exchanged_after_collected

    exchange status after pickup

    T: Used
    F: Not used

    items

    Order item code

    order_item_code
    Order item code
    request_pickup

    request pickup

    T: Used
    F: Not used

    pickup

    pickup location details

    name
    Name

    phone
    Office phone number

    cellphone
    Mobile

    zipcode
    Zipcode

    address1
    Address 1

    address2
    Address 2
    undone

    Undo

    T : 철회함

    add_memo_too

    add to admin memo

    T: Enable
    F: Disable

    undone_reason_type

    Reason for undoing

    A: change of mind
    B: shipping delay
    J: shipping error
    C: unavailable shipping zone
    L: Export/Customs clearance issue
    D: bad packaging
    E: dissatisfied with product
    F:product does not match the description
    K: defective product
    G: dissatisfied with service
    H: out of stock
    I: others

    undone_reason

    Max Length : [2000]

    Reason for undoing (Details)

    expose_order_detail

    display reason in order details

    T: yes
    F: no

    exposed_undone_reason

    Max Length : [2000]

    Reason for undoing (Storefront)

    Update an order exchang