non-print
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.
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": {
}
}
}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/sampleapiAPI 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- 2) Application/ | Check for the "Content- |
| 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_ | Check whether using valid client_ |
| 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. |
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:002. 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,P000000W3. 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=24. 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=1285. 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=2006. 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_no7. 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,inventoriesAPI 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/40Versioning
Version 2021-03-01 (latest)
You can check the version release date for changes not compatible with the previous version.
You can specify a version of your choice in custom headers "X-Cafe24-Api-Version". If not specified, the latest version is used.
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
Coupons setting
Coupons setting properties
| Attribute | Description |
|---|---|
| shop_ Min : [1] | Shop Number |
| use_ | enable coupons T:사용함 |
| available_ | allowed coupon type at checkout A: both checkout and product coupons |
| allow_ | allow using points with coupons T: yes |
| allow_ | allow using customer level based-discounts with coupons A: allow both |
| allow_ | allow using product coupons and checkout coupons together T: yes |
| recover_ | auto-restore coupons for |
| max_ | limit number of coupon uses for |
| use_ | additional coupon T: yes |
| additional_ | additional coupon number |
| show_ | display coupons to guests T: yes |
| show_ | including coupons issued for specific customer levels T: Included |
| show_ | display coupons already downloaded T: yes |
| sorting_ | sort coupons by A: coupon start date |
| download_ | default download button image 1:TYPE1 |
| background_ | default background image 1:TYPE1 |
Get coupons setting
GET /api/v2/admin/coupons/setting
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_store |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
Update a coupons setting
PUT /api/v2/admin/coupons/setting
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_store |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| use_ | enable coupons T: yes |
| available_ | allowed coupon type at checkout A: both checkout and product coupons |
| allow_ | allow using points with coupons T: yes |
| allow_ | allow using customer level based-discounts with coupons A: allow both |
| allow_ | allow using product coupons and checkout coupons together T: yes |
| recover_ | auto-restore coupons for |
| restore_viewpoint cancel_before_pay cancel_after_pay return exchange part | |
| max_ | limit number of coupon uses for |
| product_per_product order_per_order product_and_order_per_order product_per_order product_and_order_per_day | |
| use_ | additional coupon T: yes |
| additional_ Array Max : [5] | additional coupon number |
| coupon_no | |
| show_ | display coupons to guests T: yes |
| show_ | including coupons issued for specific customer levels T: Included |
| show_ | display coupons already downloaded T: yes |
| sorting_ | sort coupons by A: coupon start date |
| download_ | default download button image 1:TYPE1 |
| background_ | default background image 1:TYPE1 |
Currency
This resource lets you read a store’s currency information and exchange rates.
Endpoints
Currency properties
| Attribute | Description |
|---|---|
| exchange_ | Exchange rate |
| standard_ | 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_ | 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_ | Shopping mall currency code |
| shop_ | Shopping mall currency symbol |
Dashboard
Dashboard is a brief summary of shopping mall operation information such as order status and sales status.
Endpoints
Dashboard properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| daily_ | Daily sales stats Daily sales information. |
| weekly_ | Weekly sales stats Weekly sales information. |
| monthly_ | Monthly sales stats Monthly sales information. |
| sold_ | Number of the products sold out Number of soldout products. Counts only for products which using both soldout option and inventory management option. |
| new_ | Number of new members Number of newly signed up customer. |
| board_ | Board list Board list of a mall. |
Menus
Endpoints
List all menus
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_store |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| mode | Mode pro: Advanced mode DEFAULT pro |
| menu_ | Menu number You can search multiple item with ,(comma) |
| contains_ | Include app URL T: Yes |
Mobile setting
A resource about a mobile store's settings.
Endpoints
Get mobile setting
GET /api/v2/admin/mobile/setting
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_store |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
Paymentgateway
Create a paymentgateway
POST /api/v2/admin/paymentgateway
POST
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_ Min : [1] | Shop Number DEFAULT 1 |
| partner_ Required Max Length : [50] | PG-issued store ID |
| additional_ Array Max : [5] | additional information |
| key value | |
| membership_ Max Length : [4] | subscription fee type PRE : Prepaid |
Update a paymentgateway
PUT /api/v2/admin/paymentgateway/{client_id}
PUT
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_ Min : [1] | Shop Number DEFAULT 1 |
| client_ Required Max Length : [50] | app client ID |
| partner_ Max Length : [50] | PG-issued store ID |
| additional_ Array Max : [5] | additional information |
| key value | |
| membership_ Max Length : [4] | subscription fee type PRE : Prepaid |
Delete a paymentgateway
DELETE /api/v2/admin/paymentgateway/{client_id}
DELETE
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_ Min : [1] | Shop Number DEFAULT 1 |
| client_ Required Max Length : [50] | app client ID |
Paymentgateway paymentmethods
Paymentgateway paymentmethods properties
| Attribute | Description |
|---|---|
| client_ | app client ID |
| payment_ | payment method code |
| payment_ | Payment Method card: credit card |
| payment_ | Payment method name |
| payment_ | payment method image path |
List all paymentgateway paymentmethods
GET /api/v2/admin/paymentgateway/{client_id}/paymentmethods
GET
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_ Required Max Length : [50] | app client ID |
Create a paymentgateway paymentmethod
POST /api/v2/admin/paymentgateway/{client_id}/paymentmethods
POST
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_ Required Max Length : [50] | app client ID |
| payment_ Required Max Length : [50] | payment method code |
| payment_ Required | Payment Method card: credit card |
| payment_ Required Max Length : [50] | Payment method name |
| payment_ Required Max Length : [200] | payment method image path |
Update a paymentgateway paymentmethod
PUT /api/v2/admin/paymentgateway/{client_id}/paymentmethods/{payment_method_code}
PUT
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_ Required Max Length : [50] | app client ID |
| payment_ Required Max Length : [50] | payment method code |
| payment_ | Payment Method card: credit card |
| payment_ Max Length : [50] | Payment method name |
| payment_ Max Length : [200] | payment method image path |
Delete a paymentgateway paymentmethod
DELETE /api/v2/admin/paymentgateway/{client_id}/paymentmethods/{payment_method_code}
DELETE
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_ Required Max Length : [50] | app client ID |
| payment_ Required Max Length : [50] | payment method code |
Products setting
Endpoints
Products setting properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| calculate_ | base for price calculation S: margin per cost |
| price_ | rounding place for price F: no round-off |
| price_ | price rounding L: round down |
Get products setting
GET /api/v2/admin/products/setting
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_store |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
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.
Shops properties
| Attribute | Description |
|---|---|
| shop_ | 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 |
| shop_ Max Length : [255] | Shop name Store name of the multi-language store |
| business_ | Business country code |
| language_ | Language code Default language code of multi shopping mall. ko_KR: Korean |
| language_ Max Length : [20] | Language name Default language name of multi shopping mall. |
| currency_ Type : [A-Z] | Shopping mall currency code Currency code of multi shopping mall. South Korean Won (KRW) |
| currency_ | Currency name Currency name of multi shopping mall. |
| reference_ Type : [A-Z] | Reference currency code Reference currency code of multi shopping mall. South Korean Won (KRW) |
| reference_ | Reference currency name Reference currency name of multi shopping mall. |
| pc_ | Pc skin no Design number of PC shopping mall. |
| mobile_ | Mobile skin no Design number of Mobile shopping mall. |
| base_ Max Length : [63] | Base domain Base domain. |
| primary_ Max Length : [63] | Primary domain Representative domain of multi shopping mall. |
| slave_ | Slave domain Connected domain of shopping mall. |
| active | Active Whether activating multi shopping mall or not. T: activated |
| timezone | time zone |
| timezone_ | time zone information |
| date_ | time zone date format Year/Month/Day : YYYY-MM-DD |
| time_ | time zone time format Hour/Minute/Second : hh:mm:ss |
Get a shop
GET /api/v2/admin/shops/{shop_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_store |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Required | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
Sms setting
Sms setting is a resource about settings for sending and receiving SMS from and to an online store.
Endpoints
Sms setting properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| use_ | whether use SMS T: use |
| exclude_ | whether exclude SMS rejected recipient T : exclude |
| default_ | default sender id |
| unsubscribe_ | Free unsubscribe phone number |
| send_ | SMS send method S: send SMS via split message |
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
Store properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| shop_ | Shop name |
| mall_ | Store ID Shopping mall ID. Also used in store manager's name and used in base domain. |
| base_ | Base domain Auto generated and free default domain. You can access the shoopping mall with this domain. |
| primary_ | Primary domain A representative domain connected to a shopping mall. It is dispalyed only when connecting representative domains. |
| company_ | Company registration number The business registration number of the shopping mall issued in the country where the business is located. |
| company_ | Company name Business name or company name registered at the time of business registration. |
| president_ | CEO The name of the representative registered at the time of business registration. |
| company_ | Business Business registered at business registration. |
| company_ | Business category Business category registered at business registration. |
| country | Country of business Name of the country where the business is located. |
| 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 |
| notification_ | Sender email |
| mall_ | Shopping mall address |
| mail_ | Report mail-order business Tells whether the online store has registered as a mail-order sales business. T:Reported |
| mail_ | Mail-order business report number |
| missing_ | Reason of no mail-order business report If you did not report mail-order business, Its reason. |
| missing_ | Detailed reason of no mail-order business report If the reason for not report mail-order business is "other", the reason for detail. |
| about_ | About us A brief introduction to the mall. It is displayed on the company introduction page of the shopping mall. |
| company_ | Company map URL Show a brief map of the mall. It is displayed on the company introduction page of the shopping mall. |
| customer_ | Customer center service/order phone Customer center call number displayed on the shopping mall page. |
| customer_ | Customer center service/order e-mail Customer center contact email address displayed on shopping mall page. |
| customer_ | Customer center fax number Customer center fax number displayed on the shopping page. |
| customer_ | Customer center SMS number Customer center SMS number displayed on the shopping page. |
| customer_ | Customer center operation time The customer center open hours displayed on the shopping page. |
| privacy_ | Privacy officer's name The name of the person in charge of personal information protection displayed on the shopping mall page. |
| privacy_ | Privacy officer's position |
| privacy_ | Privacy officer's department |
| privacy_ | Privacy officer's phone number The phone number of the person in charge of privacy protection displayed on the shopping mall page. |
| privacy_ | Privacy officer's email address The e-mail address of the person in charge of privacy protection displayed on the shopping mall page. |
| contact_ | Whether to display the service inquiry guide in mobile phone Whether to expose service information to mobile website. T: Displayed |
| contact_ | Service contact information Details of service contact information exposed on the product detail page. |
Store accounts
Endpoints
Store accounts properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| bank_ | bank ID (for bank transfer without a bankbook) |
| bank_ | Bank name |
| bank_ Max Length : [50] | Bank code |
| bank_ | Bank account no |
| bank_ | Bank account holder number |
| use_ | Use classification T: Use |
List all store accounts
GET /api/v2/admin/store/accounts
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_store |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
Subscription shipments setting
Subscription shipments setting properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| subscription_ | subscription product number |
| subscription_ | subscription product name |
| product_ | Subscription product A: all products |
| product_ | products selected for subscription delivery |
| category_ | product categories selected for subscription delivery |
| use_ | subscription delivery discount settings T: Used |
| discount_ | Discount standard P: discount rate |
| discount_ | Discount amount |
| related_ | number of products settings T: order quantity-based |
| subscription_ | delivery cycle option settings T: Used |
| subscription_ | delivery cycle 1W: 1 week |
| use_ | free shipping settings T: Used |
| order_ | Minimum purchase amount for free shipping |
| include_ | whether regional shipping charge included T: Included |
List all subscription shipments setting
GET /api/v2/admin/subscription/shipments/setting
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_store |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| subscription_ | subscription product number |
Create a subscription shipments setting
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_ | Shop Number DEFAULT 1 |
| subscription_ Required Max Length : [255] | subscription product name |
| product_ Required | Subscription product A: all products |
| product_ Array Max : [10000] | products selected for subscription delivery |
| category_ Array Max : [1000] | product categories selected for subscription delivery |
| use_ Required | subscription delivery discount settings T: Used |
| discount_ | Discount standard P: discount rate |
| discount_ Array Max : [20] | Discount amount |
| related_ | number of products settings T: order quantity-based |
| subscription_ Required | delivery cycle option settings T: Used |
| subscription_ Required | delivery cycle 1W: 1 week |
| use_ Required | free shipping settings T: Used |
| order_ Max : [99999999999999] | Minimum purchase amount for free shipping |
| include_ | whether regional shipping charge included T: Included |
Update a subscription shipments setting
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_ | Shop Number DEFAULT 1 |
| subscription_ Required | subscription product number |
| subscription_ Max Length : [255] | subscription product name |
| product_ | Subscription product A: all products |
| product_ Array Max : [10000] | products selected for subscription delivery |
| category_ Array Max : [1000] | product categories selected for subscription delivery |
| use_ | subscription delivery discount settings T: Used |
| discount_ | Discount standard P: discount rate |
| discount_ Array Max : [20] | Discount amount |
| related_ | number of products settings T: order quantity-based |
| subscription_ | delivery cycle option settings T: Used |
| subscription_ | delivery cycle 1W: 1 week |
| use_ | free shipping settings T: Used |
| order_ Max : [99999999999999] | Minimum purchase amount for free shipping |
| include_ | whether regional shipping charge included T: Included |
Delete a subscription shipments setting
DELETE /api/v2/admin/subscription/shipments/setting/{subscription_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_store |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| subscription_ Required | subscription product number |
Users
Users are operators who can operate the shopping mall along with the representative manager of the shopping mall. You can operate a shopping mall within the authority granted by the representative manager.
Users properties
| Attribute | Description |
|---|---|
| user_ | Sub-operator ID Sub-admin ID |
| user_ | Name of sub operator Sub-admin name |
| phone Phone Number | Office phone number Phone number of sub operator. |
| email | Email address of sub operator. |
| ip_ | Restriction on the IP access Whether use IP restriction or not. T: Use |
| admin_ | Operator category Whether administor is representative operator or sub operator. P: Representative operator |
| last_ timezone | Last login date |
| shop_ Min : [1] | Shop Number It can only be viewed when retrieving details. |
| nick_ | Nick name Nick name of operator. It can only be viewed when retrieving details. |
| nick_ | Nickname icon type of supplier operator Register nick name icon. You may register manually or may choose sample. It can only be viewed when retrieving details. D: manually register icon |
| nick_ | Nickname icon url of supplier operator It can only be viewed when retrieving details. |
| board_ | exposure setting for board It can only be viewed when retrieving details. |
| memo | Important memo It can only be viewed when retrieving details. |
| available | Use classification It can only be viewed when retrieving details. T: Use |
| multishop_ | Multi-shopping mall access authority It can only be viewed when retrieving details. T: Allow |
| menu_ | Menu access authority It can only be viewed when retrieving details. |
| detail_ | Detailed authority setting It can only be viewed when retrieving details. |
| ip_ | Restriction on the IP access It can only be viewed when retrieving details. |
| access_ | Authority to permit the access It can only be viewed when retrieving details. T: permission always granted regardless of access permitted time setting |
Get an user
GET /api/v2/admin/users/{user_id}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_store |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| user_ | Sub-operator ID |
Product
Bundleproducts
Bundleproducts properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| product_ | Product number A unique serial number assigned to a product. This number cannot be duplicated. |
| product_ Type : [A-Z0-9] | Product code A code assigned to a product by the system. This code cannot be duplicated. |
| bundle_ | composite product information |
| custom_ 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_ 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_ Max Length : [250] | English name of product Product name in English. It can be used for international shipping. |
| supply_ 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_ Max Length : [50] | internal product name |
| model_ Max Length : [100] | Model name Model of the product |
| display | Whether display Whether the product is displayed on the store. T: Display |
| selling | whether selling Whether the product is for sale. T: Sell |
| product_ | Product condition Condition of the product N: New |
| product_ Max : [2147483647] | Months of using the used product |
| summary_ 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_ Max Length : [200] | Product tag Search terms for searching or categorizing products (hashtags) |
| price_ 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_ | whether purchase restriction individual setting T: use |
| buy_ | Purchase limitation Whether or not to restrict purchase from guest accounts N: Members only and hide purchase button. |
| buy_ | customer levels allowed to purchase the relevant product |
| repurchase_ | repurchase restriction T : restrict repurchase |
| single_ | single purchase restriction T : restrict single purchase |
| points_ | whether use mileage individual setting F : use default setting |
| points_ | mileage individual setting - lower level item > basic setting mileage or mileage setting according to payment method B : Use the default reserve setting |
| points_ | Mileage setting |
| except_ | Mileage exception T : exclude setting an additional mileage accumulation for member group |
| adult_ | Adult certification Whether the product requires adult certification. Customer needs to be authenticated to purchase products that require adult certification. T: Used |
| detail_ | Detail image Detail image' showing on the product detail page. |
| list_ | List image List image' showing on the product category page, main page, product search result page. |
| tiny_ | Tiny image Small list image' showing on the recently viewed page. |
| small_ | Reduced image Reduced image' showing on the bottom side of the product detail page. |
| use_ | whether use Naver Pay T: Used |
| naverpay_ | Naver Pay sales type C : Naver Pay + Shopping Mall Products at the same time |
| icon_ | 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. |
| product_ | Weight of product Weight of whole product. Total weight including product, box, and packing weight is necessary for shipping. |
| product_ | 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_ timezone | Created date Date when product registered. |
| updated_ timezone | Updated date Date when product modified. |
| english_ | 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 of product In case cloth products using a Japanese courier service, material information may required for some shipping companies. woven: Woven |
| list_ | Recommend / sold out / new icon expose flag Either showing recommend / sold out / new icon will be exposed or not. |
| sold_ | Whether sold out or stock is available T: Out-of-stock |
| discountprice | Product discount sale price Resource
|
| decorationimages | Decoration Image Resource
|
| benefits | Benefits Resource
|
| additionalimages Array Max : [20] | additional image resource
|
| exposure_ | types of customers allowed to view the relevant product A: display to all |
| exposure_ | customer levels allowed to view the relevant product |
| bundle_ | bundle discount information It can only be viewed when retrieving details. |
| category | Category number Category of the product. Product is marked with this category. It can only be viewed when retrieving details. |
| project_ | planned exhibition number It can only be viewed when retrieving details. |
| description | Detail description of product Detail description of product. You may input description with HTML. It can only be viewed when retrieving details. |
| mobile_ | Mobile version of product description Mobile version of product description. Replace product description to the mobile version when customer access a mobile shopping mall. It can only be viewed when retrieving details. |
| separated_ | add mobile version It can only be viewed when retrieving details. T: add mobile version product details |
| additional_ 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. It can only be viewed when retrieving details. |
| payment_ | Payment info Guidance for payment method. You may input this with HTML. It can only be viewed when retrieving details. |
| shipping_ | Shipping info Guidance for shipping method. You may input this with HTML. It can only be viewed when retrieving details. |
| exchange_ | Exchange info Guidance for exchange and return method. You may input this with HTML. It can only be viewed when retrieving details. |
| service_ | Service info Guidance for service warranty information. You may input this with HTML. It can only be viewed when retrieving details. |
| country_ | HS code by country HS code used for customs duties when shipped overseas. You must enter the correct number for international shipment clearance. It can only be viewed when retrieving details. |
| simple_ | Simple Product Description Simple description of product. Can Exposed at product display screen. You may input description with HTML. It can only be viewed when retrieving details. |
| shipping_ | Shipping fee by product Set whether shipping fee will be charged separately or commonly. It can only be viewed when retrieving details. T: Used |
| shipping_ | Shipping method Following is the method when 'individual_delivery' is TRUE It can only be viewed when retrieving details. 01: regular delivery |
| prepaid_ | Whether prepaid shipping fee It can only be viewed when retrieving details. C: Pay after delivery |
| shipping_ | Shipping period (When using 'Shipping charge individually') Average transit time for make a delivery. It can only be viewed when retrieving details. |
| shipping_ | Shipping information Shows whether can only deliver domestically or can deliver to overseas too. It can only be viewed when retrieving details. A: Domestic only |
| shipping_ Max Length : [255] | Shipping area (When using 'Shipping charge individually') Available shipping region. It can only be viewed when retrieving details. |
| shipping_ | Shipping charge (When using 'Shipping charge individually') Type of shipping charge. It can only be viewed when retrieving details. 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_ | 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. It can only be viewed when retrieving details. |
| clearance_ | English name of product Product classification information to use for the purpose of overseas customs clearance. It can only be viewed when retrieving details. |
| clearance_ | Korean product category for overseas customs clearance Product name as Korean It can only be viewed when retrieving details. |
| clearance_ Type : [A-Z0-9] | Clearance category code It can only be viewed when retrieving details. |
| additional_ | Additional information list You may add additional information other than basic information. It can only be viewed when retrieving details. |
| image_ | Image type Image type when uploading image. It can only be viewed when retrieving details. A: Register a representative image. |
| main | whether display at main Displays main display number when display products at main page such as "recommend product" or "new". It can only be viewed when retrieving details. |
| relational_ Array Max : [200] | Related product Related or similar product of selected product. Registered related product display the bottom of the product detail page. It can only be viewed when retrieving details. |
| memos | Memos Resource
It can only be viewed when retrieving details. |
| hits | Product hits Resource
It can only be viewed when retrieving details. |
| seo | Product Seo Resource
It can only be viewed when retrieving details. |
| tags | Product Tag Resource
It can only be viewed when retrieving details. |
List all bundleproducts
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 |
| decorationimages embed | Decoration Image Resource |
| benefits embed | Benefits Resource |
| additionalimages embed | additional image resource |
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ | Product number Number of a product. You can search multiple item with ,(comma) |
| display | Whether display T: Display |
| selling | whether selling T: Sell |
| product_ | Product code You can search multiple item with ,(comma) |
| product_ | Product tag You can search multiple item with ,(comma) |
| custom_ | Custom product code You can search multiple item with ,(comma) |
| product_ | Product name You can search multiple item with ,(comma) |
| eng_ | English name of product You can search multiple item with ,(comma) |
| supply_ | Supplier product name You can search multiple item with ,(comma) |
| internal_ | internal product name You can search multiple item with ,(comma) |
| model_ | Model name You can search multiple item with ,(comma) |
| price_ | Minimum price |
| price_ | Maximum price |
| created_ timezone | Registered date start |
| created_ timezone | Registered date end |
| updated_ timezone | Updated date start |
| updated_ timezone | Updated date end |
| category | Category number |
| category_ | Unapplied Category T : Search for products that category unapplied |
| include_ | include sub category T: Included |
| product_ | Weight of product |
| additional_ | additional information key |
| additional_ | additional information value |
| sort | Sort order created_date: Created Date |
| order | Order by asc: Ascending |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list Set the start location of search result. |
Get a bundleproduct
GET /api/v2/admin/bundleproducts/{product_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number Number of a product. |
| discountprice embed | Product discount sale price Resource |
| decorationimages embed | Decoration Image Resource |
| benefits embed | Benefits Resource |
| memos embed | Memos Resource |
| hits embed | Product hits Resource |
| seo embed | Product Seo Resource |
| tags embed | Product Tag Resource |
| additionalimages embed | additional image resource |
Create a bundleproduct
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_ | Shop Number DEFAULT 1 |
| product_ Required Max Length : [250] | Product name Name of product. |
| bundle_ Required | composite product information |
| product_no purchase_quantity | |
| bundle_ Required | bundle discount information |
| discount_value discount_type discount_round_unit discount_round_type | |
| display | Whether display Whether display or not. T: Display DEFAULT F |
| add_ | Category no Register your product in the category you want to display using the category number |
| category_no recommend new | |
| custom_ Max Length : [40] | Custom product code You may assign this code manually in case of stock management or other reasons. |
| eng_ Max Length : [250] | English name of product Name of product in english. |
| supply_ Max Length : [250] | Supplier product name |
| internal_ Max Length : [50] | internal product name |
| model_ Max Length : [100] | Model name Model name of product. |
| use_ | whether use Naver Pay This cannot be used on Cafe24 Vietnam, Philippines. T: Used |
| naverpay_ | Naver Pay sales type This cannot be used on Cafe24 Vietnam, Philippines. C : Naver Pay + Shopping Mall Products at the same time |
| product_ Min : [0]~Max : [999999.99] | Weight of product |
| description | Detail description of product Detailed description of product. |
| mobile_ | 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_ Max Length : [255] | Product Summary Description |
| simple_ | Simple Product Description |
| product_ Max Length : [200] | Product tag Tag for search product. |
| payment_ | Payment info Payment method guidance. |
| shipping_ | Shipping info Shipping method guidance. |
| exchange_ | Exchange info Exchange/return method guidance. |
| service_ | 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_ | Shipping information Shows whether can only deliver domestically or can deliver to overseas too. This cannot be used on Cafe24 Vietnam, Philippines. A: Domestic only DEFAULT A |
| shipping_ | Shipping method Shipping method(when shipping individually). 01: regular delivery DEFAULT 01 |
| shipping_ | Shipping fee by product Shipping charge individually. T: Individual delivery DEFAULT F |
| shipping_ Max Length : [255] | Shipping area Shipping area. |
| shipping_ Array Max : [2] | Shipping period Transit time. |
| minimum maximum | |
| shipping_ | 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_ | Shipping rates If shipping_fee_type is R or N, you can set the shipping cost by defining shipping_fee in the array. |
| prepaid_ | Whether prepaid shipping fee This cannot be used on Cafe24 Vietnam, Philippines. C: Pay after delivery DEFAULT B |
| clearance_ Type : [A-Z0-9] | Clearance category code Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping) |
| detail_ | Detail image Detail image. |
| list_ | List image List image. |
| tiny_ | Tiny image |
| small_ | Reduced image |
| image_ | Image type Image type. A: Register a representative image. DEFAULT A |
| additional_ | Additional information list Additional item. |
| key value | |
| price_ Max Length : [20] | Alternative phrase of the selling price |
| buy_ | whether purchase restriction individual setting T: use DEFAULT F |
| buy_ | Purchase limitation N: Members only and hide purchase button. DEFAULT F |
| buy_ | customer levels allowed to purchase the relevant product |
| repurchase_ | repurchase restriction T : restrict repurchase DEFAULT F |
| single_ | single purchase restriction T : restrict single purchase DEFAULT F |
| points_ | whether use mileage individual setting F : use default setting DEFAULT F |
| points_ | mileage individual setting - lower level item > basic setting mileage or mileage setting according to payment method B : Use the default reserve setting |
| points_ | Mileage setting |
| except_ | Mileage exception T : exclude 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_ 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 interrelated | |
| product_ | 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_ | 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 of product In case cloth products using a Japanese courier service, material information may required for some shipping companies. woven: Woven |
| additional_ | 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. |
| adult_ | Adult certification This attribute tell you whether the product is age-restricted or not. Customers need to authenticate themselves to purchase age-restricted products. This cannot be used on Cafe24 Vietnam, Philippines. T: Used DEFAULT F |
| exposure_ | types of customers allowed to view the relevant product A: display to all DEFAULT A |
| exposure_ | customer levels allowed to view the relevant product |
Update a bundleproduct
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| product_ Max Length : [250] | Product name Name of product. |
| bundle_ | composite product information |
| product_no purchase_quantity | |
| bundle_ | bundle discount information |
| discount_value discount_type discount_round_unit discount_round_type | |
| display | Whether display You can choose product should be displayed or not. T: Display |
| product_ | Product condition N: New |
| product_ Max : [2147483647] | Months of using the used product Used month for the product when product_condition is used product. |
| add_ | Category no Enter a category number to add a specific product category to the product |
| category_no recommend new | |
| delete_ | Deleted classification number Enter a category number to delete a specific product category to the product |
| custom_ Max Length : [40] | Custom product code You may assign this code manually in case of stock management or other reasons. |
| eng_ Max Length : [250] | English name of product Name of product in english. |
| supply_ Max Length : [250] | Supplier product name |
| internal_ Max Length : [50] | internal product name |
| model_ Max Length : [100] | Model name Model name of product. |
| use_ | whether use Naver Pay This cannot be used on Cafe24 Vietnam, Philippines. T: Used |
| naverpay_ | Naver Pay sales type This cannot be used on Cafe24 Vietnam, Philippines. C : Naver Pay + Shopping Mall Products at the same time |
| product_ Min : [0]~Max : [999999.99] | Weight of product |
| description | Detail description of product Detailed description of product. |
| mobile_ | 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_ Max Length : [255] | Product Summary Description Summary description of product. |
| simple_ | Simple Product Description Simple description of product. |
| product_ Max Length : [200] | Product tag Tag for search product. |
| payment_ | Payment info Payment method guidance. |
| shipping_ | Shipping info Shipping method guidance. |
| exchange_ | Exchange info Exchange/return method guidance. |
| service_ | Service info Service query / information guidance. |
| icon Array Max : [5] | List of icon Register icon. |
| use_ | whether use show date T: Used |
| icon_ | start date of show_date |
| icon_ | 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_ | Shipping information Shows whether can only deliver domestically or can deliver to overseas too. This cannot be used on Cafe24 Vietnam, Philippines. A: Domestic only |
| prepaid_ | Whether prepaid shipping fee This cannot be used on Cafe24 Vietnam, Philippines. C: Pay after delivery |
| shipping_ | Shipping method Shipping method(when shipping individually). 01: regular delivery |
| shipping_ | Shipping fee by product Shipping charge individually. T: Individual delivery |
| shipping_ Max Length : [255] | Shipping area Shipping area. |
| shipping_ Array Max : [2] | Shipping period Transit time. |
| minimum maximum | |
| shipping_ | 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_ | Shipping rates If shipping_fee_type is R or N, you can set the shipping cost by defining shipping_fee in the array. |
| clearance_ Type : [A-Z0-9] | Clearance category code Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping) |
| detail_ | Detail image Detail image. |
| list_ | List image List image. |
| tiny_ | Tiny image Reduced image. |
| small_ | Reduced image Small list image. |
| image_ | Image type Image type. A: Register a representative image. |
| additional_ | Additional information list Additional item. |
| key value | |
| price_ Max Length : [20] | Alternative phrase of the selling price |
| buy_ | whether purchase restriction individual setting T: use |
| buy_ | Purchase limitation N: Members only and hide purchase button. |
| buy_ | customer levels allowed to purchase the relevant product |
| repurchase_ | repurchase restriction T : restrict repurchase |
| single_ | single purchase restriction T : restrict single purchase |
| points_ | whether use mileage individual setting F : use default setting |
| points_ | mileage individual setting - lower level item > basic setting mileage or mileage setting according to payment method B : Use the default reserve setting |
| points_ | Mileage setting |
| except_ | Mileage exception T : exclude 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_ 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 interrelated | |
| product_ | 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_ | 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 of product In case cloth products using a Japanese courier service, material information may required for some shipping companies. woven: Woven |
| additional_ | 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. |
| adult_ | Adult certification This attribute tell you whether the product is age-restricted or not. Customers need to authenticate themselves to purchase age-restricted products. This cannot be used on Cafe24 Vietnam, Philippines. T: Used |
| exposure_ | types of customers allowed to view the relevant product A: display to all |
| exposure_ | customer levels allowed to view the relevant product |
Delete a bundleproduct
DELETE /api/v2/admin/bundleproducts/{product_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
Categories products
A relational resource that lets you retrieve or update product display order or general display settings.
Categories products properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| product_ | Product number System assigned code. This code cannot be duplicated. |
| sequence_ | display order |
| auto_ | whether to use automatic sorting |
| sold_ | Whether sold out or stock is available |
| fixed_ | whether fixed |
| not_ | whether not for sale |
| display_ Min : [1]~Max : [3] | detailed product category 1 : Regular product DEFAULT 1 |
| sequence Min : [1]~Max : [999998] | Display order |
List all categories products
GET /api/v2/admin/categories/{category_no}/products
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| category_ Required | Category number |
| display_ Required Min : [1]~Max : [3] | detailed product category 1 : Regular product |
| limit Min : [1]~Max : [50000] | Limit DEFAULT 50000 |
Count all categories products
GET /api/v2/admin/categories/{category_no}/products/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| category_ Required | Category number |
| display_ Required Min : [1]~Max : [3] | detailed product category 1 : Regular product |
Create a categories product
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_ Required | Category number |
| display_ Min : [1]~Max : [3] | detailed product category 1 : Regular product DEFAULT 1 |
| product_ Required | Product number |
Update a categories product
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_ | Shop Number DEFAULT 1 |
| category_ Required | Category number |
| display_ Required Min : [1]~Max : [3] | detailed product category 1 : Regular product |
| product_ Required | Product number |
| sequence Min : [1]~Max : [999999] | Display order |
| auto_ | whether to use automatic sorting T : Use automatic arrangement |
| fixed_ | whether fixed T : Use designated display order |
Delete a categories product
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_ Required | Category number |
| product_ Required | Product number |
| display_ 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 DEFAULT 1 |
Mains products
A relational resource to the Mains resource about main category products’ display order.
List all mains products
GET /api/v2/admin/mains/{display_group}/products
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| display_ Required | main category number |
Count all mains products
GET /api/v2/admin/mains/{display_group}/products/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| display_ Required | main category number |
Create a mains product
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_ | Shop Number DEFAULT 1 |
| display_ Required | main category number |
| product_ Required | Product number |
Update a mains product
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_ | Shop Number DEFAULT 1 |
| display_ Required | main category number |
| product_ Required | Product number Rank of product display will designated for requested order. |
| fix_ | Fixed product number Designate product for fixed rank. |
Delete a mains product
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_ | Shop Number DEFAULT 1 |
| display_ Required | main category number |
| product_ Required | Product number |
Products properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| product_ | Product number System assigned code. This code cannot be duplicated. |
| product_ Type : [A-Z0-9] | Product code System assigned code. This code cannot be duplicated. |
| custom_ Max Length : [40] | Custom product code You may assign this code manually in case of stock management or other reasons. |
| product_ 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_ Max Length : [250] | English name of product English name of product. Necessary when shipping to abroad. |
| supply_ 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_ Max Length : [50] | internal product name |
| model_ Max Length : [100] | Model name Model name of product |
| price_ | product price (before VAT) |
| price | Product price Selling price. Price that before applying coupon or other benefits. |
| retail_ | 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_ | 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 |
| 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". T: Sell |
| product_ | Product condition Displays condition of product N: New |
| product_ Max : [2147483647] | Months of using the used product |
| summary_ Max Length : [255] | Product Summary Description Summary description of product. Can Exposed at product display screen. You may input description with HTML. |
| product_ Max Length : [200] | Product tag Search tags. |
| margin_ 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_ | Taxation category Tax type information of product. A: Taxable goods |
| tax_ Min : [0]~Max : [100] | Tax rate Tax rate should be informed for the taxable products. |
| price_ 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_ | whether purchase restriction individual setting T: use |
| buy_ | Purchase limitation Limit purchase as below information. N: Members only and hide purchase button. |
| buy_ | customer levels allowed to purchase the relevant product |
| repurchase_ | repurchase restriction T : restrict repurchase |
| single_ | single purchase restriction T : restrict single purchase |
| buy_ | 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 |
| buy_ | Minimum unit per purchase Minimum unit per purchase. |
| order_ | 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 |
| minimum_ Max : [2147483647] | Minimum quantity per purchase Minimum quantity per purchase. Customer cannot buy the product below the minimum quantity. |
| maximum_ Max : [2147483647] | Maximum quantity per purchase Maximum quantity per purchase. Customer cannot buy the product above the maximum quantity. |
| points_ | individual settings for points F : use default setting |
| points_ | points settings by payment method B : Use the default reserve setting |
| points_ | points settings information |
| except_ | omit additional points issued based on customer levels T : exclude setting an additional mileage accumulation for member group |
| product_ | product volume information |
| adult_ | Adult certification Whether the product requires adult certification. Customer needs to be authenticated to purchase products that require adult certification. T: Used |
| detail_ | Detail image Detail image' showing on the product detail page. |
| list_ | List image List image' showing on the product category page, main page, product search result page. |
| tiny_ | Tiny image Small list image' showing on the recently viewed page. |
| small_ | Reduced image Reduced image' showing on the bottom side of the product detail page. |
| has_ | 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 |
| option_ | Type of option Shows type of option when "has_option" is TRUE. C: Combination integration option |
| use_ | whether use Naver Pay T: Used |
| naverpay_ | Naver Pay sales type C : Naver Pay + Shopping Mall Products at the same time |
| manufacturer_ Type : [A-Z0-9] | Manufacturer code Code uses for designate specific manufacturer. This code generated automatically when register a new manufacturer. |
| trend_ Type : [A-Z0-9] | Trend code Code uses for designate specific trend. This code generated automatically when register a new trend. |
| brand_ Type : [A-Z0-9] | Brand code Code uses for designate specific brand. This code generated automatically when register a new brand. |
| supplier_ Type : [A-Z0-9] | Supplier code Code uses for designate specific supplier. This code generated automatically when register a new supplier. |
| made_ | Date of manufacture Date of manufacture of the product. |
| release_ | Date of release Date of release of the product. |
| expiration_ 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_ | Origin classification Distinguish the origin of a product. F: domestic |
| origin_ | Origin place no List the origin number List all Origin by API |
| origin_ Max Length : [30] | Extra information for code of origin You may add additional information if 'origin_place_code' is 1800. |
| made_ | Origin country code |
| icon_ | 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. |
| product_ | Weight of product Weight of whole product. Total weight including product, box, and packing weight is necessary for shipping. |
| product_ | 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_ timezone | Created date Date when product registered. |
| updated_ timezone | Updated date Date when product modified. |
| english_ | 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 of product In case cloth products using a Japanese courier service, material information may required for some shipping companies. woven: Woven |
| list_ | Recommend / sold out / new icon expose flag Either showing recommend / sold out / new icon will be exposed or not. |
| select_ | 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. T: Use |
| approve_ | Approve request result N: New request for approval |
| classification_ Type : [A-Z0-9] | Classification code Custom classification code for the purpost of self-classification. |
| sold_ | Whether sold out or stock is available T: Out-of-stock |
| additional_ | Additional amount of the selling price |
| discountprice | Product discount sale price Resource
|
| decorationimages | Decoration Image Resource
|
| benefits | Benefits Resource
|
| options | Product Option Resource
|
| variants | Variants Resource
|
| clearance_ | English name of product Product classification information to use for the purpose of overseas customs clearance. |
| clearance_ | Korean product category for overseas customs clearance Product name as Korean |
| clearance_ Type : [A-Z0-9] | Clearance category code |
| additionalimages | additional image resource
|
| exposure_ | types of customers allowed to view the relevant product A: display to all |
| exposure_ | customer levels allowed to view the relevant product |
| set_ | Product bundle type C: integral type. S: assembled type |
| memos | Memos Resource
It can only be viewed when retrieving details. |
| hits | Product hits Resource
It can only be viewed when retrieving details. |
| seo | Product Seo Resource
It can only be viewed when retrieving details. |
| category | Category number Category of the product. Product is marked with this category. It can only be viewed when retrieving details. |
| project_ | planned exhibition number It can only be viewed when retrieving details. |
| description | Detail description of product Detail description of product. You may input description with HTML. It can only be viewed when retrieving details. |
| mobile_ | Mobile version of product description Mobile version of product description. Replace product description to the mobile version when customer access a mobile shopping mall. It can only be viewed when retrieving details. |
| separated_ | add mobile version It can only be viewed when retrieving details. T: add mobile version product details |
| translated_ | Translation information of product details It can only be viewed when retrieving details. |
| additional_ 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. It can only be viewed when retrieving details. |
| payment_ | Payment info Guidance for payment method. You may input this with HTML. It can only be viewed when retrieving details. |
| shipping_ | Shipping info Guidance for shipping method. You may input this with HTML. It can only be viewed when retrieving details. |
| exchange_ | Exchange info Guidance for exchange and return method. You may input this with HTML. It can only be viewed when retrieving details. |
| service_ | Service info Guidance for service warranty information. You may input this with HTML. It can only be viewed when retrieving details. |
| product_ | Vat tax info Displays text set at VAT text setting menu. It can only be viewed when retrieving details. |
| country_ | HS code by country HS code used for customs duties when shipped overseas. You must enter the correct number for international shipment clearance. It can only be viewed when retrieving details. |
| simple_ | Simple Product Description Simple description of product. Can Exposed at product display screen. You may input description with HTML. It can only be viewed when retrieving details. |
| tags | Product Tag Resource
It can only be viewed when retrieving details. |
| shipping_ | Shipping fee by product Set whether shipping fee will be charged separately or commonly. It can only be viewed when retrieving details. T: Used |
| shipping_ | Shipping method Following is the method when 'individual_delivery' is TRUE It can only be viewed when retrieving details. 01: regular delivery |
| prepaid_ | Whether prepaid shipping fee It can only be viewed when retrieving details. C: Pay after delivery |
| shipping_ | Shipping period (When using 'Shipping charge individually') Average transit time for make a delivery. It can only be viewed when retrieving details. |
| shipping_ | Shipping information Shows whether can only deliver domestically or can deliver to overseas too. It can only be viewed when retrieving details. A: Domestic only |
| shipping_ Max Length : [255] | Shipping area (When using 'Shipping charge individually') Available shipping region. It can only be viewed when retrieving details. |
| shipping_ | Shipping charge (When using 'Shipping charge individually') Type of shipping charge. It can only be viewed when retrieving details. 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_ | 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. It can only be viewed when retrieving details. |
| origin_ | Code of origin Code of origin It can only be viewed when retrieving details. |
| additional_ | Additional information list You may add additional information other than basic information. It can only be viewed when retrieving details. |
| image_ | Image type Image type when uploading image. It can only be viewed when retrieving details. A: Register a representative image. |
| main | whether display at main Displays main display number when display products at main page such as "recommend product" or "new". It can only be viewed when retrieving details. |
| relational_ Array Max : [200] | Related product Related or similar product of selected product. Registered related product display the bottom of the product detail page. It can only be viewed when retrieving details. |
| translated_ | Translated additional description It can only be viewed when retrieving details. |
List all products
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| discountprice embed | Product discount sale price Resource |
| decorationimages embed | Decoration Image Resource |
| benefits embed | Benefits Resource |
| options embed | Product Option Resource |
| variants embed | Variants Resource Up to 100 variants can be retrieved per product. |
| additionalimages embed | additional image resource |
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ | 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_ | 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_ | 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_ | Brand code Search for products with matching brand codes. You can search multiple item with ,(comma) |
| manufacturer_ | Manufacturer code Search for products with matching manufacturer code. You can search multiple item with ,(comma) |
| supplier_ | Supplier code Search for products with matching supplier code. You can search multiple item with ,(comma) |
| trend_ | Trend code Search for products with matching trend code. You can search multiple item with ,(comma) |
| product_ | 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_ | 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_ | Custom variants code You can search multiple item with ,(comma) |
| price_ | Minimum price Search for products that price is over a certain range. |
| price_ | Maximum price Search for products that price is below a certain range. |
| retail_ Min : [0] | Minimum retail price Search for products that retail price is over a certain range. |
| retail_ Min : [0] | Maximim retail price Search for products that retail price is below a certain range. |
| supply_ | Minimum supply price Search for products that supply price is over a certain range. |
| supply_ | Maximum supply price Search for products that supply price is below a certain range. |
| created_ 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_ 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_ 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_ 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_ | 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_ | 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_ | internal product name You can search multiple item with ,(comma) |
| model_ | 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_ | Product condition Search for products of specific condition. You can search multiple item with ,(comma) |
| origin_ | 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_ | Maximum stock search Search for items that product stock is below a certain value. |
| stock_ | Minimum stock search Search for variants that product stock is above a certain value. |
| stock_ | Search of maximum safety inventory quantity |
| stock_ | Search of minimum safety inventory quantity |
| product_ | Weight of product Search for items that weigh certain kilograms. You can search multiple item with ,(comma) |
| classification_ | Classification code You can search multiple item with ,(comma) |
| use_ | whether use inventory Whether use inventory management or not at the variants of the products. T: Use |
| category_ | Unapplied Category Search for products that category unapplied. T : Search for products that category unapplied |
| include_ | include sub category Search for products that include sub category. T: Included |
| additional_ | additional information key Search for products that has specific additional information. In order to search, key and value is necessary. |
| additional_ | additional information value Search for products that has specific additional information. In order to search, key and value is necessary. |
| approve_ | Approval Status N: Approval request (New product) status |
| since_ Min : [0] | Search after a certain product number Search products from after a certain product number. Can search regardless of offset. |
| product_ | Product bundle T: Use |
| sort | Sort order created_date: Created Date |
| order | Order by asc: Ascending |
| offset Max : [5000] | Start location of list Set the start location of search result. |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
Count all products
GET /api/v2/admin/products/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ | 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_ | 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_ | Product code System assigned code. This code cannot be duplicated. You can search multiple item with ,(comma) |
| brand_ | Brand code Search for products with matching brand codes. You can search multiple item with ,(comma) |
| manufacturer_ | Manufacturer code Search for products with matching manufacturer code. You can search multiple item with ,(comma) |
| supplier_ | Supplier code Search for products with matching supplier code. You can search multiple item with ,(comma) |
| trend_ | Trend code Search for products with matching trend code. You can search multiple item with ,(comma) |
| product_ | 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_ | 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_ | Custom variants code You can search multiple item with ,(comma) |
| price_ | Minimum price Search for products that price is over a certain range. |
| price_ | Maximum price Search for products that price is below a certain range. |
| retail_ Min : [0] | Minimum retail price Search for products that retail price is over a certain range. |
| retail_ Min : [0] | Maximim retail price Search for products that retail price is below a certain range. |
| supply_ | Minimum supply price Search for products that supply price is over a certain range. |
| supply_ | Maximum supply price Search for products that supply price is below a certain range. |
| created_ 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_ 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_ 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_ 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_ | 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_ | 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_ | internal product name You can search multiple item with ,(comma) |
| model_ | 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_ | Product condition Search for products of specific condition. You can search multiple item with ,(comma) |
| origin_ | 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_ | Maximum stock search Search for items that product stock is below a certain value. |
| stock_ | Minimum stock search Search for variants that product stock is above a certain value. |
| stock_ | Search of maximum safety inventory quantity |
| stock_ | Search of minimum safety inventory quantity |
| product_ | Weight of product Search for items that weigh certain kilograms. You can search multiple item with ,(comma) |
| classification_ | Classification code Search for products with matching custom classification code. You can search multiple item with ,(comma) |
| use_ | whether use inventory Whether use inventory management or not at the variants of the products. T: Use |
| category_ | Unapplied Category Search for products that category unapplied. T : Search for products that category unapplied |
| include_ | include sub category Search for products that include sub category. T: Included |
| additional_ | additional information key Search for products that has specific additional information. In order to search, key and value is necessary. |
| additional_ | additional information value Search for products that has specific additional information. In order to search, key and value is necessary. |
| approve_ | Approval Status N: Approval request (New product) status |
| since_ Min : [0] | Search after a certain product number Search products from after a certain product number. Can search regardless of offset. |
| product_ | Product bundle T: Use |
Get a product
GET /api/v2/admin/products/{product_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number Number of a product. |
| variants embed | Variants Resource |
| memos embed | Memos Resource |
| hits embed | Product hits Resource |
| seo embed | Product Seo Resource |
| tags embed | Product Tag Resource |
| options embed | Product Option Resource |
| discountprice embed | Product discount sale price Resource |
| decorationimages embed | Decoration Image Resource |
| benefits embed | Benefits Resource |
| additionalimages embed | additional image resource |
Create a product
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 DEFAULT F |
| selling | whether selling Whether selling or not. T: Sell DEFAULT F |
| product_ | Product condition N: New DEFAULT N |
| product_ Max : [2147483647] | Months of using the used product Used month for the product when product_condition is used product. |
| add_ | Category no Register your product in the category you want to display using the category number |
| category_no recommend new | |
| custom_ Max Length : [40] | Custom product code You may assign this code manually in case of stock management or other reasons. |
| product_ Required Max Length : [250] | Product name Name of product. |
| eng_ Max Length : [250] | English name of product Name of product in english. |
| supply_ Max Length : [250] | Supplier product name |
| internal_ Max Length : [50] | internal product name |
| model_ Max Length : [100] | Model name Model name of product. |
| price_ 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_ Min : [0]~Max : [2147483647] | Product retail price |
| supply_ 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_ | Whether the option is used Has an option or not. T: use option DEFAULT F |
| options | Option |
| name value | |
| use_ | whether use Naver Pay This cannot be used on Cafe24 Vietnam, Philippines. T: Used |
| naverpay_ | Naver Pay sales type This cannot be used on Cafe24 Vietnam, Philippines. C : Naver Pay + Shopping Mall Products at the same time |
| manufacturer_ Type : [A-Z0-9] | Manufacturer code Manufacturer code. DEFAULT M0000000 |
| trend_ Type : [A-Z0-9] | Trend code DEFAULT T0000000 |
| brand_ Type : [A-Z0-9] | Brand code DEFAULT B0000000 |
| supplier_ Type : [A-Z0-9] | Supplier code shipping_fee: shipping DEFAULT S0000000 |
| product_ Min : [0]~Max : [999999.99] | Weight of product |
| made_ | Date of manufacture |
| release_ | Date of release |
| expiration_ Array Max : [2] | Expiration date Expiration date. |
| start_date end_date | |
| description | Detail description of product Detailed description of product. |
| mobile_ | 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_ Max Length : [255] | Product Summary Description shipping_rates_max: Shipping interval end |
| simple_ | 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_ | Translation information of product details |
| product_ Max Length : [200] | Product tag Tag for search product. |
| payment_ | Payment info Payment method guidance. |
| shipping_ | Shipping info Shipping method guidance. |
| exchange_ | Exchange info Exchange/return method guidance. |
| service_ | 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_ | Shipping information Shows whether can only deliver domestically or can deliver to overseas too. This cannot be used on Cafe24 Vietnam, Philippines. A: Domestic only |
| shipping_ | Shipping method Shipping method(when shipping individually). 01: regular delivery |
| shipping_ | Shipping fee by product Shipping charge individually. T: Individual delivery DEFAULT F |
| shipping_ Max Length : [255] | Shipping area Shipping area. |
| shipping_ Array Max : [2] | Shipping period Transit time. |
| minimum maximum | |
| shipping_ | 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_ 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. |
| shipping_rates_min shipping_rates_max shipping_fee | |
| prepaid_ | Whether prepaid shipping fee This cannot be used on Cafe24 Vietnam, Philippines. C: Pay after delivery |
| clearance_ Type : [A-Z0-9] | Clearance category code Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping) |
| detail_ | Detail image Detail image. |
| list_ | List image List image. |
| tiny_ | Tiny image Reduced image. |
| small_ | Reduced image shipping_rates_min: Shipping interval start |
| image_ | Image type Image type. A: Register a representative image. DEFAULT A |
| additional_ | Additional information list Additional item. |
| key value | |
| price_ Max Length : [20] | Alternative phrase of the selling price |
| buy_ | whether purchase restriction individual setting T: use DEFAULT F |
| buy_ | Purchase limitation N: Members only and hide purchase button. DEFAULT F |
| buy_ | customer levels allowed to purchase the relevant product |
| repurchase_ | repurchase restriction T : restrict repurchase DEFAULT F |
| single_ | single purchase restriction T : restrict single purchase DEFAULT F |
| buy_ | 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 DEFAULT O |
| buy_ Max : [2147483647] | Minimum unit per purchase Unit of order. DEFAULT 1 |
| order_ | 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 DEFAULT O |
| minimum_ Max : [2147483647] | Minimum quantity per purchase Minimum quantity per purchase. Customer cannot buy the product below the minimum quantity. DEFAULT 1 |
| maximum_ Max : [2147483647] | Maximum quantity per purchase Maximum quantity per purchase. Customer cannot buy the product above the maximum quantity. |
| points_ | individual settings for points F : use default setting DEFAULT F |
| points_ | points settings by payment method B : Use the default reserve setting |
| points_ | points settings information |
| payment_method points_rate points_unit_by_payment | |
| except_ | omit additional points issued based on customer levels T : exclude setting an additional mileage accumulation for member group DEFAULT F |
| product_ | product volume information |
| use_product_volume product_width product_height product_length | |
| origin_ | Origin classification Distinguish the origin of a product. F: domestic |
| origin_ | Origin place no List the origin number List all Origin by API |
| origin_ 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_ | Origin country code A two-digit country code for country of origin |
| main | whether display at main Displays main display number when display products at main page such as "recommend product" or "new". |
| relational_ 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 interrelated | |
| product_ | 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_ | 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 of product In case cloth products using a Japanese courier service, material information may required for some shipping companies. woven: Woven |
| classification_ Type : [A-Z0-9] | Classification code |
| additional_ 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_ 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_ | Taxation category Tax type information of product. A: Taxable goods |
| tax_ Min : [0]~Max : [100] | Tax rate Tax rate should be informed for the taxable products. |
| additional_ | 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. |
| adult_ | Adult certification This attribute tell you whether the product is age-restricted or not. Customers need to authenticate themselves to purchase age-restricted products. This cannot be used on Cafe24 Vietnam, Philippines. T: Used DEFAULT F |
| exposure_ | types of customers allowed to view the relevant product A: display to all DEFAULT A |
| exposure_ | customer levels allowed to view the relevant product |
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ 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 |
| selling | whether selling Whether selling or not. T: Sell |
| product_ | Product condition N: New |
| product_ Max : [2147483647] | Months of using the used product Used month for the product when product_condition is used product. |
| add_ | Category no Enter a category number to add a specific product category to the product |
| category_no recommend new | |
| delete_ | Deleted classification number Enter a category number to delete a specific product category to the product |
| custom_ Max Length : [40] | Custom product code You may assign this code manually in case of stock management or other reasons. |
| product_ Max Length : [250] | Product name Name of product. |
| eng_ Max Length : [250] | English name of product Name of product in english. |
| supply_ Max Length : [250] | Supplier product name |
| internal_ Max Length : [50] | internal product name |
| model_ Max Length : [100] | Model name Model name of product. |
| price_ 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_ Min : [0]~Max : [2147483647] | Product retail price |
| supply_ 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_ | Whether the option is used Has an option or not. F: Option not used |
| use_ | whether use Naver Pay This cannot be used on Cafe24 Vietnam, Philippines. T: Used |
| naverpay_ | Naver Pay sales type This cannot be used on Cafe24 Vietnam, Philippines. C : Naver Pay + Shopping Mall Products at the same time |
| manufacturer_ Type : [A-Z0-9] | Manufacturer code Manufacturer code. |
| trend_ Type : [A-Z0-9] | Trend code |
| brand_ Type : [A-Z0-9] | Brand code |
| supplier_ Type : [A-Z0-9] | Supplier code Supplier code. |
| product_ Min : [0]~Max : [999999.99] | Weight of product |
| made_ | Date of manufacture |
| release_ | Date of release |
| expiration_ Array Max : [2] | Expiration date Expiration date. |
| start_date end_date | |
| description | Detail description of product Detailed description of product. |
| mobile_ | 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_ | Translation information of product details |
| translated_ | Translated additional description |
| summary_ Max Length : [255] | Product Summary Description Summary description of product. |
| simple_ | Simple Product Description Simple description of product. |
| product_ Max Length : [200] | Product tag Tag for search product. |
| payment_ | Payment info Payment method guidance. |
| shipping_ | Shipping info Shipping method guidance. |
| exchange_ | Exchange info Exchange/return method guidance. |
| service_ | Service info Service query / information guidance. |
| icon Array Max : [5] | List of icon |
| use_ | whether use show date T: Used |
| icon_ | start date of show_date |
| icon_ | 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_ | Shipping information Shows whether can only deliver domestically or can deliver to overseas too. This cannot be used on Cafe24 Vietnam, Philippines. A: Domestic only |
| shipping_ | Shipping method Shipping method(when shipping individually). 01: regular delivery |
| shipping_ | Shipping fee by product Shipping charge individually. T: Individual delivery |
| shipping_ Max Length : [255] | Shipping area Shipping area. |
| shipping_ | Shipping period Transit time. |
| minimum maximum | |
| shipping_ | 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_ 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. |
| shipping_rates_min shipping_rates_max shipping_fee | |
| prepaid_ | Whether prepaid shipping fee This cannot be used on Cafe24 Vietnam, Philippines. C: Pay after delivery |
| clearance_ Type : [A-Z0-9] | Clearance category code Required if shipping information (shipping_scope) is B (domestic / overseas shipping) or C (overseas shipping) |
| detail_ | Detail image Detail image. |
| list_ | List image List image. |
| tiny_ | Tiny image Reduced image. |
| small_ | Reduced image Small list image. |
| image_ | Image type Image type. A: Register a representative image. |
| additional_ | Additional information list Additional item. |
| key value | |
| price_ Max Length : [20] | Alternative phrase of the selling price |
| buy_ | whether purchase restriction individual setting T: use |
| buy_ | Purchase limitation N: Members only and hide purchase button. |
| buy_ | customer levels allowed to purchase the relevant product |
| repurchase_ | repurchase restriction T : restrict repurchase |
| single_ | single purchase restriction T : restrict single purchase |
| buy_ | 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 |
| buy_ Max : [2147483647] | Minimum unit per purchase Unit of order. |
| order_ | 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 |
| minimum_ Max : [2147483647] | Minimum quantity per purchase Minimum quantity for order. |
| maximum_ Max : [2147483647] | Maximum quantity per purchase Maximum quantity per purchase. Customer cannot buy the product above the maximum quantity. |
| points_ | individual settings for points F : use default setting |
| points_ | points settings by payment method B : Use the default reserve setting |
| points_ | points settings information |
| payment_method points_rate points_unit_by_payment | |
| except_ | omit additional points issued based on customer levels T : exclude setting an additional mileage accumulation for member group |
| product_ | product volume information |
| use_product_volume product_width product_height product_length | |
| origin_ | Origin classification Distinguish the origin of a product. F: domestic |
| origin_ | Origin place no List the origin number List all Origin by API |
| origin_ 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_ | Origin country code A two-digit country code for country of origin |
| main | whether display at main Displays main display number when display products at main page such as "recommend product" or "new". |
| relational_ 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 interrelated | |
| product_ | 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_ | 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 of product In case cloth products using a Japanese courier service, material information may required for some shipping companies. woven: Woven |
| classification_ Type : [A-Z0-9] | Classification code |
| additional_ 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_ 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_ | Taxation category Tax type information of product. A: Taxable goods |
| tax_ Min : [0]~Max : [100] | Tax rate Tax rate should be informed for the taxable products. |
| additional_ | 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. |
| adult_ | Adult certification This attribute tell you whether the product is age-restricted or not. Customers need to authenticate themselves to purchase age-restricted products. This cannot be used on Cafe24 Vietnam, Philippines. T: Used |
| exposure_ | types of customers allowed to view the relevant product A: display to all |
| exposure_ | customer levels allowed to view the relevant product |
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
Products additionalimages
Products additionalimages, a child resource of Products, lets you retrieve additional images of a product.
Create a products additionalimage
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_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
| additional_ Required | Additional image ● Maximum number of requests: 20 |
Update a products additionalimage
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_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
| additional_ Required | Additional image ● Maximum number of requests: 20 |
Products approve
API which can only be used when mall using products approval function.
Products approve properties
| Attribute | Description |
|---|---|
| shop_ | 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 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
Get products approve status
GET /api/v2/admin/products/{product_no}/approve
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
Create a products approve
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_ | Shop Number DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| user_ Required | Supplier operator ID ID of supplier operator who requested |
Update a products approve
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| user_ Required | Supplier operator ID ID of supplier operator who requested |
| status Required | Approval status Approval status of the product requested. C: Approved status |
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.
Products decorationimages properties
| Attribute | Description |
|---|---|
| code | code of decoration image |
| path | Decoration Image URL |
| shop_ | Shop Number |
| use_ | whether use show date T: Use |
| show_ timezone | start date of show_date |
| show_ timezone | end date of show_date |
| image_ | list of decoration image |
List all decoration images
GET /api/v2/admin/products/decorationimages
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
List all products 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_ | Shop Number DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
Select decoration images to 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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number |
| use_ | whether use show date T: Use |
| show_ Date | start date of show_date |
| show_ Date | end date of show_date |
| image_ Required | list of decoration image |
| code path image_horizontal_position image_vertical_position | |
Update a decoration images to a product
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| use_ | whether use show date T: Use |
| show_ Date | start date of show_date |
| show_ Date | end date of show_date |
| image_ Required | list of decoration image |
| code path image_horizontal_position image_vertical_position | |
Deselect a decoration images to a product
DELETE /api/v2/admin/products/{product_no}/decorationimages/{code}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| code Required | code of decoration image |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
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.
List all products discountprice
GET /api/v2/admin/products/{product_no}/discountprice
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
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.
Count all products hits
GET /api/v2/admin/products/{product_no}/hits/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
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.
Products icons properties
| Attribute | Description |
|---|---|
| code | code of product icon Code of Icon. |
| path | Path URL of Icon. |
| shop_ | Shop Number |
| use_ | whether use show date T: Use |
| show_ timezone | start date of show_date |
| show_ timezone | end date of show_date |
| image_ | list of product icon |
List all icons
GET /api/v2/admin/products/icons
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
List all products icons
GET /api/v2/admin/products/{product_no}/icons
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
Select product icons to 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_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
| image_ Required Array Max : [5] | list of product icon |
| code | |
Update a product icons to a product
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_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
| use_ | whether use show date T: Use |
| show_ Date | start date of show_date |
| show_ Date | end date of show_date |
| image_ Array Max : [5] | list of product icon |
| code | |
Deselect a product icons to a product
DELETE /api/v2/admin/products/{product_no}/icons/{code}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
| code Required | code of product icon |
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.
Products images properties
| Attribute | Description |
|---|---|
| path | Detail image |
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| product_ | Product number System assigned code. This code cannot be duplicated. |
| detail_ | Detail image Detail image' showing on the product detail page. |
| list_ | List image 'List image' showing on the product category page, main page, product search result page. |
| tiny_ | Tiny image Small list image' showing on the recently viewed page. |
| small_ | 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 Product image displayed on a product details page. |
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| detail_ | Detail image Detail image' showing on the product detail page. |
| list_ | List image 'List image' showing on the product category page, main page, product search result page. |
| tiny_ | Tiny image Reduced image' showing on the bottom side of the product detail page. |
| small_ | Reduced image Small list image' showing on the recently viewed page. |
| image_ 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. |
Delete a products image
DELETE /api/v2/admin/products/{product_no}/images
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
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.
Products memos properties
| Attribute | Description |
|---|---|
| memo_ | Memo number System assigned code. This code cannot be duplicated. |
| author_ Max Length : [20] | Author ID ID of memo writer. |
| created_ timezone | Created date Written date of memo. |
| memo | Important memo Contents of memo. You may input this with HTML.. |
List all products memos
GET /api/v2/admin/products/{product_no}/memos
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Get a products 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_ Required | Product number System assigned code. This code cannot be duplicated. |
| memo_ Required | Memo number System assigned code. This code cannot be duplicated. |
Create a products 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_ Required | Product number System assigned code. This code cannot be duplicated. |
| author_ Required Max Length : [20] | Author ID ID of memo writer. |
| memo Required | Important memo Contents of memo. You may input this with HTML.. |
Update a products 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_ Required | Product number System assigned code. This code cannot be duplicated. |
| memo_ Required | Memo number System assigned code. This code cannot be duplicated. |
| author_ Required Max Length : [20] | Author ID ID of memo writer. |
| memo Required | Important memo Contents of memo. You may input this with HTML.. |
Delete a products 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_ Required | Product number System assigned code. This code cannot be duplicated. |
| memo_ Required | Memo number System assigned code. This code cannot be duplicated. |
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.
Products options properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| has_ | Whether the option is used T: Use |
| option_ | Type of option Shows type of option when "has_option" is TRUE. T: Combination |
| option_ | Option list type If you use the combined option, show the type of the combined option C: Integrated type |
| option_ Type : [A-Z0-9] | Option set code If you use the linked with product option, show the option preset code. |
| options | Option |
| select_ | 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. T: Use |
| option_ | Option preset name If you use "linked with product" option, show the name of the option set |
| use_ | Whether use additional option T: Use |
| additional_ | Additional option |
| use_ | Whether use attached file option T: Use |
| attached_ | Attached file option |
List all products options
GET /api/v2/admin/products/{product_no}/options
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
Create a products option
POST /api/v2/admin/products/{product_no}/options
POST
This resource lets you add new product options. Variants are automatically generated when new options are created.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_product |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| has_ | Whether the option is used T: Use |
| option_ | Type of option Enter type of option when "has_option" is TRUE. T: Combination |
| option_ | Option list type If you use the combined option, enter the type of the combined option S: Combination separation option |
| options | Option |
| option_name option_value Array option_text option_image_file option_color option_display_type | |
| select_ | 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. T: Used |
| option_ Type : [A-Z0-9] | Option set code |
| option_ | Option preset name If you use "linked with product" option, enter the name of the option set |
| use_ | Whether use additional option T: Use |
| additional_ | Additional option |
| additional_option_name additional_option_text_length required_additional_option | |
| use_ | Whether use attached file option T: Use |
| attached_ | Attached file option |
Update a products option
PUT /api/v2/admin/products/{product_no}/options
PUT
This resource does not reset the variants while options are being updated. You can only update option names, option values as well as allow free-form options and file uploads. You cannot add new option variants or delete existing ones.
If you want to add or delete options, you need to first delete them with Delete a products option resource and add them again.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_product |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| option_ | Option list type If you use the combined option, enter the type of the combined option S: Combination separation option |
| option_ Type : [A-Z0-9] | Option set code If you use the linked with product option, enter the option preset code. |
| options | Option |
| option_name option_value Array option_text option_image_file option_link_image option_color option_display_type | |
| original_ | Option value before modification |
| option_name option_value Array option_text | |
| select_ | 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. T: Used |
| option_ | Option preset name If you use "linked with product" option, enter the name of the option set |
| use_ | Whether use additional option T: Use |
| additional_ | Additional option |
| additional_option_name additional_option_text_length required_additional_option | |
| use_ | Whether use attached file option T: Use |
| attached_ | Attached file option |
Delete a products option
DELETE /api/v2/admin/products/{product_no}/options
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
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.
Products seo properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| meta_ | Browser title Information displayed at product's detail page. Title tag is the most basic information for search which displays at browser. |
| meta_ | 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_ | Meta tag 2: Description Information displayed at tag in product detail page. You may input the information which displays at the search result. |
| meta_ | Meta tag 3: Keywords Information displayed at tag in product detail page. You may input keywords that want to be searched. |
| meta_ | 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_ | 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 |
Get products seo
GET /api/v2/admin/products/{product_no}/seo
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
Update a products seo
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| meta_ | Browser title Information displayed at product's detail page. Title tag is the most basic information for search which displays at browser. |
| meta_ | 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_ | Meta tag 2: Description Information displayed at tag in product detail page. You may input the information which displays at the search result. |
| meta_ | Meta tag 3: Keywords Information displayed at tag in product detail page. You may input keywords that want to be searched. |
| meta_ | 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_ | 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. |
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.
Products tags properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| tag | Product tag Tag or keyword for product searching. |
| tags Required | Product tag |
| product_ | Product number System assigned code. This code cannot be duplicated. |
List all products tags
GET /api/v2/admin/products/{product_no}/tags
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
Count all products 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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
Create a products tag
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| tag Required | Product tag Tag or keyword for product searching. |
| tags Required | Product tag |
Delete a products 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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| tag | Product tag Tag or keyword for product searching. |
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
Products variants properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| variant_ Type : [A-Z0-9] | Product item code System assigned code. This code cannot be duplicated. |
| options | Option |
| custom_ 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 |
| 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 |
| additional_ | Additional price Additional price for purchase the variants. |
| use_ | whether use inventory T: Use |
| important_ | Whether it is an important inventory A: General inventory |
| inventory_ | Inventory check criteria A: Based on order |
| display_ | whether display sold-out T: Out-of-stock displayed |
| quantity | Available inventory |
| safety_ | minimum stock level |
| inventories | Inventories Resource Inventory Resource of variants. |
| duplicated_ | Whether duplicate custom variant code T: Duplicated |
| product_ | Product number System assigned code. This code cannot be duplicated. |
List all products variants
GET /api/v2/admin/products/{product_no}/variants
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_product |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| inventories embed | Inventories Resource Inventory Resource of variants. You can search multiple item with ,(comma) |
Get a products 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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| variant_ Required Type : [A-Z0-9] | Variant code |
| inventories embed | Inventories Resource |
Update a products 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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| variant_ Required Type : [A-Z0-9] | Product item code System assigned code. This code cannot be duplicated. |
| custom_ 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 |
| 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 |
| additional_ | Additional price Additional price for purchase the variants. |
| quantity | Available inventory |
| use_ | whether use inventory T: Use |
| important_ | Whether it is an important inventory A: General inventory |
| inventory_ | Inventory check criteria A: Based on order |
| display_ | whether display sold-out T: Out-of-stock displayed |
| safety_ | minimum stock level |
Update products variants(batch)
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_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
| variant_ Required Type : [A-Z0-9] | Product item code |
| custom_ Max Length : [40] | Custom variants code |
| display | Whether display T: Display |
| selling | whether selling T: Sell |
| additional_ | Additional price |
| quantity | Available inventory |
| use_ | whether use inventory T: Use |
| important_ | Whether it is an important inventory A: General inventory |
| inventory_ | Inventory check criteria A: Based on order |
| display_ | whether display sold-out T: Out-of-stock displayed |
| safety_ | minimum stock level |
Delete a products 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_ Required | Product number System assigned code. This code cannot be duplicated. |
| variant_ Required Type : [A-Z0-9] | Product item code System assigned code. This code cannot be duplicated. |
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.
Products variants inventories properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| variant_ Type : [A-Z0-9] | Variant code System assigned code. This code cannot be duplicated. |
| use_ | 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 |
| important_ | 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 |
| inventory_ | Inventory check criteria Decide when the inventory will be deducted. You may set inventory deduction criteria differently. A: Based on order |
| display_ | 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. T: Out-of-stock 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_ | minimum stock level |
Get products variants inventory
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| variant_ Required Type : [A-Z0-9] | Variant code Variants code for search sales volume. |
Update a products variants 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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| variant_ Required Type : [A-Z0-9] | Variant code System assigned code. This code cannot be duplicated. |
| use_ | 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 |
| important_ | 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 |
| inventory_ | Inventory check criteria Decide when the inventory will be deducted. You may set inventory deduction criteria differently. A: Based on order |
| display_ | 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. T: Out-of-stock 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_ | minimum stock level |
Order
Cancellation
Cancellation properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number It can only be viewed when retrieving details. |
| order_ | Order ID It can only be viewed when retrieving details. |
| claim_ | Cancellation number It can only be viewed when retrieving details. |
| claim_ | division It can only be viewed when retrieving details. A: change of mind |
| claim_ | Reason It can only be viewed when retrieving details. |
| refund_ | Refund method It can only be viewed when retrieving details. |
| refund_ | Remarks It can only be viewed when retrieving details. |
| order_ | Purchase amount It can only be viewed when retrieving details. |
| refund_ | refund amount It can only be viewed when retrieving details. |
| shipping_ | shipping fee It can only be viewed when retrieving details. |
| return_ | Return shipping cost classification It can only be viewed when retrieving details. |
| defer_ | Postpayment Fee It can only be viewed when retrieving details. |
| partner_ | Affiliate discount cancellation amount It can only be viewed when retrieving details. |
| add_ | Extra discount discount by product It can only be viewed when retrieving details. |
| member_ | Membership Discount Discount Amount It can only be viewed when retrieving details. |
| shipping_ | Shipping discount cancellation amount It can only be viewed when retrieving details. |
| coupon_ | Coupon discount cancellation amount It can only be viewed when retrieving details. |
| point_ | Reimbursement Return Used It can only be viewed when retrieving details. |
| credit_ | Deposit Refund Used It can only be viewed when retrieving details. |
| undone | Undo It can only be viewed when retrieving details. T: Yes |
| undone_ | Reason for undoing It can only be viewed when retrieving details. A: change of mind |
| undone_ | Reason for undoing (Details) It can only be viewed when retrieving details. |
| expose_ | display reason in order details It can only be viewed when retrieving details. T: yes |
| exposed_ | Reason for undoing (Storefront) It can only be viewed when retrieving details. |
| items | Order item code It can only be viewed when retrieving details. |
| status | Order status canceled : canceled |
| recover_ | Inventory Recovery T : Recover |
| add_ | add to admin memo T: Enable |
Get a cancellation
GET /api/v2/admin/cancellation/{claim_code}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| claim_ Required | Cancellation number |
Create cancellation
POST /api/v2/admin/cancellation
POST
This API allows you to process cancellations for multiple orders awaiting shipment. When cancellations are processed by using this API, orders will be marked as canceled, but you need to cancel payments via payment gateways.
For partial cancellations, refund amount for each order will be automatically calculated and processed.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| status Required | Order status canceled : canceled |
| recover_ | Inventory Recovery T : Recover DEFAULT F |
| recover_ | restore a coupon Unavailable for marketplace or NAVER Pay order cancellations T : Recover DEFAULT F |
| add_ | add to admin memo Unavailable for marketplace or NAVER Pay order cancellations T: Enable DEFAULT F |
| reason Max Length : [2000] | reason for cancellation |
| claim_ | type of reason for cancellation Unavailable for marketplace or NAVER Pay order cancellations A: change of mind |
| naverpay_ | 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 |
| refund_ | Refund method T : cash |
| combined_ | 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. T : cash |
| refund_ | code assigned to bank for refunds Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [250] | Bank name Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [50] | Refund account number Available only when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [15] | Refund Account Account Holder's Name |
| items | Order item code |
| order_item_code quantity | |
Update cancellation
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_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| claim_ Required | Cancellation number |
| recover_ Required | Inventory Recovery T : Recover |
| undone Required | Undo T : 철회함 |
| add_ Required | add to admin memo T: Enable |
| undone_ Required | Reason for undoing A: change of mind |
| undone_ Max Length : [2000] | Reason for undoing (Details) |
| expose_ Required | display reason in order details T: yes |
| exposed_ Max Length : [2000] | Reason for undoing (Storefront) |
Cancellationrequests
Create cancellationrequests
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_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| reason_ Required | type of reason for cancellation A: change of mind |
| reason Required Max Length : [2000] | reason for cancellation |
| refund_ | code assigned to bank for refunds Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [250] | Bank name |
| refund_ Max Length : [50] | Refund account number |
| refund_ Max Length : [15] | Refund Account Account Holder's Name |
| items | list of items |
| order_item_code quantity | |
Update cancellationrequests
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_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| order_ Required | Order item code |
| undone Required | Rejected to accept T: Yes |
| reason_ | type of reason A: change of mind |
| reason Max Length : [2000] | Reason |
| display_ | Display reason in [Storefront>My Orders] T: yes DEFAULT F |
| reject_ Max Length : [2000] | reason for rejection |
Cashreceipt
Cashreceipt properties
| Attribute | Description |
|---|---|
| cashreceipt_ | Cash receipt number |
| approval_ | Approval Number |
| request_ | Date requested |
| order_ | Order ID |
| member_ | Member id |
| name | Requester |
| order_ | Purchase amount |
| vat | VAT |
| subtotal | Subtotal |
| order_ | Order status Awaiting payment: unpaid |
| status | status Requested: request |
| pg_ | Requested payment gateway |
| cash_ | Cash receipt serial number |
| type | Issuance type Individual: personal |
| company_ | Company registration number |
| cellphone | Mobile |
| tax_ | Tax amount |
| tax_ | Deductions |
| supply_ | Total cost |
List all 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_ Required Date | Search Start Date |
| end_ Required Date | Search End Date |
| order_ Order ID | Order ID You can search multiple item with ,(comma) |
| approval_ Max Length : [9] | Approval Number |
| name Max Length : [20] | Requester |
| member_ Max Length : [20] | Member id |
| status | status All: all DEFAULT all |
| limit Min : [1]~Max : [500] | Limit DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Create a cashreceipt
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_ Required Order ID | Order ID |
| type Required | Issuance type Individual: personal |
| company_ Business Number | Company registration number |
| cellphone Mobile | Mobile |
Update a cashreceipt
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_ Required Min : [1] | Cash receipt number |
| order_ Required Order ID | Order ID |
| type | Issuance type Individual: personal |
| company_ Business Number | Company registration number |
| cellphone Mobile | Mobile |
Cashreceipt cancellation
Update a cashreceipt 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_ Required Min : [1] | Cash receipt number |
| order_ Required Order ID | Order ID |
| type Required | Cancellation type Cancel request: request |
Collectrequests
Update a collectrequest
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_ Min : [1] | Shop Number DEFAULT 1 |
| request_ Required | Request number |
| collect_ Required Max Length : [30] | Collection tracking number |
Exchange
Endpoints
Exchange properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number It can only be viewed when retrieving details. |
| order_ | Order ID It can only be viewed when retrieving details. |
| claim_ | Exchange number It can only be viewed when retrieving details. |
| claim_ | division It can only be viewed when retrieving details. A: change of mind |
| claim_ | Reason It can only be viewed when retrieving details. |
| claim_ | Estimated exchange date It can only be viewed when retrieving details. |
| receiver | Receiver It can only be viewed when retrieving details. |
| reshipping_ | reshipping details It can only be viewed when retrieving details. |
| pickup | Pickup - Address It can only be viewed when retrieving details. |
| additional_ | Additional payment It can only be viewed when retrieving details. |
| return_ | return tracking number It can only be viewed when retrieving details. |
| return_ | return shipping carrier It can only be viewed when retrieving details. |
| refund_ | Refund method It can only be viewed when retrieving details. |
| refund_ | Remarks It can only be viewed when retrieving details. |
| order_ | Purchase amount It can only be viewed when retrieving details. |
| refund_ | refund amount It can only be viewed when retrieving details. |
| shipping_ | shipping fee It can only be viewed when retrieving details. |
| return_ | Return shipping cost classification It can only be viewed when retrieving details. |
| defer_ | Postpayment Fee It can only be viewed when retrieving details. |
| partner_ | Affiliate discount cancellation amount It can only be viewed when retrieving details. |
| add_ | Extra discount discount by product It can only be viewed when retrieving details. |
| member_ | Membership Discount Discount Amount It can only be viewed when retrieving details. |
| shipping_ | Shipping discount cancellation amount It can only be viewed when retrieving details. |
| coupon_ | Coupon discount cancellation amount It can only be viewed when retrieving details. |
| point_ | Reimbursement Return Used It can only be viewed when retrieving details. |
| credit_ | Deposit Refund Used It can only be viewed when retrieving details. |
| undone | Undo It can only be viewed when retrieving details. T: Yes |
| undone_ | Reason for undoing It can only be viewed when retrieving details. A: change of mind |
| undone_ | Reason for undoing (Details) It can only be viewed when retrieving details. |
| expose_ | display reason in order details It can only be viewed when retrieving details. T: yes |
| exposed_ | Reason for undoing (Storefront) It can only be viewed when retrieving details. |
| items | Item Resource It can only be viewed when retrieving details. |
| exchanged_ | Exchanged items It can only be viewed when retrieving details. |
Get an exchange
GET /api/v2/admin/exchange/{claim_code}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| claim_ Required | Exchange number |
Orders
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
Orders properties
| Attribute | Description |
|---|---|
| shop_ | 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_ | Order ID |
| market_ | Market id Unique ID of a market for distinguish each website in case customer purchase through price comparison site. |
| market_ | marketplace other information Other information of market or order path. |
| member_ | Member id |
| member_ | customer email |
| member_ | Member authentication Member authentication type. Customer divided as 4 types based on member authentication. T: authorized |
| billing_ | Billing name Name of billing. May differ from orderer name or recipient name. |
| bank_ | Bank code |
| bank_ | Bank name |
| payment_ | payment method code Code of payment method that orderer used for payment. cash : deposit without a bankbook |
| payment_ | Payment method name Name of payment method that orderer used for payment. |
| payment_ | Payment gateway name Name of payment gateway that orderer used for payment. |
| sub_ | International payment method name |
| sub_ | International payment method code |
| paid | Paid Whether or not the order was paid for T: Paid |
| order_ timezone | Ordered date |
| first_ | First order Whether the order is the first order from the customer or not. T: First order |
| payment_ timezone | Payment date |
| order_ | Mobile type whether order made on mobile T: Made on mobile |
| use_ | Whether to use Escrow whether customer used escrow or not T: Used escrow |
| group_ | Customer group number when ordering |
| initial_ | initial payment details |
| actual_ | final payment details |
| bank_ | Bank account no Bank account number of shooping mall of the specific order. |
| bank_ | Bank account holder number |
| market_ | marketplace vendor ID |
| payment_ | order total |
| cancel_ timezone | Order cancellation date |
| order_ | Order path text |
| order_ | Available order path |
| payment_ | Whether payment is confirmed T: confirmed payment |
| commission | Transaction fee |
| postpay | Whether postpaid T: Payment after delivery |
| admin_ | manually input amount |
| additional_ | Additional shipping fee |
| international_ | International shipping insurance |
| additional_ | Additional handling fee |
| shipping_ | Delivery type Shipping delivery type. Whether domestic shipping or abroad shipping or both. A: Domestic |
| shipping_ | Delivery type Description of shipping type. Whether domestic shipping or abroad shipping or both. |
| shipping_ | Delivery status F: Awaiting shipment |
| wished_ | Desired delivery date |
| wished_ | Desired delivery time |
| wished_ | Desired courier code |
| wished_ | name of preferred shipping carrier |
| return_ timezone | Return approval time |
| total_ | Total supply price |
| naver_ | NAVER points |
| additional_ | Additional order info |
| store_ | Store pickup T: Store pickup |
| easypay_ | Easypay payment gateway name |
| loan_ | Loan status OK : GOOD |
| subscription | subscription billing in use T: subscription billing in use |
| items | Item Resource
|
| receivers | Receiver Resource
|
| buyer | Orderer Resource
|
| shipping_ | Shipping fee information |
| regional_ | Regional surcharge details |
| return | Return Details Resource
|
| cancellation | Cancellation details Resource
|
| exchange | Exchange details Resource
|
| multiple_ | Multi-address order T: Yes (Multi-address order) |
| exchange_ | Exchange rate |
| first_ | initial payment method code cash : deposit without a bankbook |
| naverpay_ | NaverPay PG payment information P: PG payment |
| customer_ | Customer group number when ordering Customer group number when order occurred. It can only be viewed when retrieving details. |
| benefits | Benefits Resource
It can only be viewed when retrieving details. |
| coupons | Coupon Resource
It can only be viewed when retrieving details. |
| refunds | refund details resource
It can only be viewed when retrieving details. |
| process_ | Order status prepare: preparing for shipment |
| order_ | Order item code |
List all orders
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| items embed | Item Resource |
| receivers embed | Receiver Resource |
| buyer embed | Orderer Resource |
| return embed | Return Details Resource |
| cancellation embed | Cancellation details Resource |
| exchange embed | Exchange details Resource |
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| start_ Required Date | Search Start Date start date for search |
| end_ Required Date | Search End Date Search end date for specific search criteria. |
| order_ Order ID | Order ID You can search multiple item with ,(comma) |
| order_ | Order status Order status. Each status has its own code. You can search multiple item with ,(comma) N00: awaiting payment |
| member_ | Member type Whether member or not. Each has its own code. 2: Member |
| group_ | Group number |
| buyer_ | Buyer name Name of orderer. May differ from billing name or recipient name. |
| receiver_ | Receiver name Name of recipient. May differ from orderer name or billing name. |
| name_ | Receiver name (Pronunciation) |
| receiver_ | Receiver address Address of recipient. May differ from orderer address or billing address. |
| member_ | Member id member id |
| member_ | customer email |
| product_ | Product number System assigned code. This code cannot be duplicated. |
| product_ | Product code System assigned code. This code cannot be duplicated. |
| date_ | Date type Date type for search. Default is date of order. order_date: order date DEFAULT order_date |
| supplier_ | Supplier id You can search multiple item with ,(comma) |
| order_ | Available order path You can search multiple item with ,(comma) cafe24:Cafe24 |
| buyer_ | Buyer mobile number |
| buyer_ | Buyer phone number |
| buyer_ | Buyer Email |
| inflow_ | sales funnel |
| subscription | subscription billing in use T: subscription billing in use |
| market_ | marketplace order cancellation T: cancellation requested marketplace order |
| payment_ | payment method code You can search multiple item with ,(comma) cash : deposit without a bankbook |
| payment_ | Payment gateway name You can search multiple item with ,(comma) |
| market_ | marketplace vendor ID |
| discount_ | Discount method You can search multiple item with ,(comma) point: points |
| discount_ | Promo code |
| carrier_ Min : [1] | shipping carrier ID |
| limit Min : [1]~Max : [500] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Count all orders
GET /api/v2/admin/orders/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| start_ Required Date | Search Start Date Search start date for specific search criteria. |
| end_ Required Date | Search End Date Search end date for searching orders. Must be used with a search start date. |
| order_ Order ID | Order ID You can search multiple item with ,(comma) |
| order_ | Order status Order status. Each status has its own code. You can search multiple item with ,(comma) N00: awaiting payment |
| member_ | Member type Customer settings. Different codes are assigned to customers and guests. 2: Member |
| group_ | Group number |
| buyer_ | Buyer name Name of customer who orders the product. It may be different from the name of the depositor or the recipient. |
| receiver_ | Receiver name Name of the recipient. May differ from the address of the customer or the depositor |
| name_ | Receiver name (Pronunciation) |
| receiver_ | Receiver address Address of the recipient. May differ from the address of the customer or the depositor |
| member_ | Member id Customer ID |
| member_ | customer email |
| product_ | Product number Product number |
| product_ | Product code Search for products of which product codes include the search query that you enter. The search query is case-insensitive. |
| date_ | Date type Date filter type for search. The default value is date of order. order_date: order date DEFAULT order_date |
| supplier_ | Supplier id You can search multiple item with ,(comma) |
| order_ | Available order path You can search multiple item with ,(comma) cafe24:Cafe24 |
| buyer_ | Buyer mobile number |
| buyer_ | Buyer phone number |
| buyer_ | Buyer Email |
| inflow_ | sales funnel |
| subscription | subscription billing in use T: subscription billing in use |
| market_ | marketplace order cancellation T: cancellation requested marketplace order |
| payment_ | payment method code You can search multiple item with ,(comma) cash : deposit without a bankbook |
| payment_ | Payment gateway name You can search multiple item with ,(comma) |
| market_ | marketplace vendor ID |
| discount_ | Discount method You can search multiple item with ,(comma) point: points |
| discount_ | Promo code |
| carrier_ Min : [1] | shipping carrier ID |
Get an order
GET /api/v2/admin/orders/{order_id}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
| items embed | Item Resource |
| receivers embed | Receiver Resource |
| buyer embed | Orderer Resource |
| benefits embed | Benefits Resource |
| coupons embed | Coupon Resource |
| return embed | Return Details Resource |
| cancellation embed | Cancellation details Resource |
| exchange embed | Exchange details Resource |
| refunds embed | refund details resource |
Update an order
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_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| process_ Required | Order status prepare: preparing for shipment |
| order_ | Order item code |
Update orders
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| process_ Required | Order status prepare: preparing for shipment |
| order_ | Order item code |
Orders autocalculation
Delete an orders autocalculation
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_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
Orders benefits
Endpoints
List all orders benefits
GET /api/v2/admin/orders/benefits
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ 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 |
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.
Orders buyer properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| member_ | Member id |
| member_ | customer group number when ordered Customer group number. |
| name | Buyer name Name of recipient. May differ from orderer name or billing name. |
| names_ | orderer name in Japanese Furigana |
| 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_ | customer notification Note for customer to know. |
| updated_ timezone | Updated date |
| user_ | ID of the persons modified the orderer Id of a person who updated buyer information. |
| user_ | name of the persons modified the order Nmae of a person who updated buyer information. |
| order_ Order ID | Order ID order number |
Get an orders buyer
GET /api/v2/admin/orders/{order_id}/buyer
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID order number |
Update an orders buyer
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_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| order_ Required Order ID | Order ID order number |
| name | Buyer name Name of recipient. May differ from orderer name or billing name. |
| 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_ | customer notification Note for customer to know. |
Orders buyer history
Orders buyer history properties
| Attribute | Description |
|---|---|
| shop_ Min : [1] | Shop Number |
| name | Buyer name |
| email | Buyer Email |
| phone | Buyer phone number |
| cellphone | Buyer mobile number |
| customer_ | customer notification |
| updated_ timezone | Updated date |
| user_ | ID of the persons modified the orderer |
| user_ | name of the persons modified the order |
List all orders buyer history
GET /api/v2/admin/orders/{order_id}/buyer/history
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
Orders cancellation
Orders cancellation properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| order_ | Order ID |
| status | Order status canceled : canceled |
| claim_ | Cancellation number |
| items | Order item code |
| recover_ | Inventory Recovery T : Recover |
| undone | Undo T: Yes |
| add_ | add to admin memo T: Enable |
| undone_ | Reason for undoing A: change of mind |
| undone_ | Reason for undoing (Details) |
| expose_ | display reason in order details T: yes |
| exposed_ | Reason for undoing (Storefront) |
Create an orders cancellation
POST /api/v2/admin/orders/{order_id}/cancellation
POST
This API allows you to process cancellations for a specific order. When cancellations are processed by using this API, orders will be marked as canceled and payments will be canceled via payment gateways. (When "T" is used for "payment_gateway_cancel")
For partial cancellations, refund amount for each order will be automatically calculated and processed.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| payment_ | 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. T : cancel DEFAULT F |
| status Required | Order status canceled : canceled |
| recover_ | Inventory Recovery T : Recover DEFAULT F |
| recover_ | restore a coupon Unavailable for marketplace or NAVER Pay order cancellations T : Recover DEFAULT F |
| add_ | add to admin memo Unavailable for marketplace or NAVER Pay order cancellations T: Enable DEFAULT F |
| reason Max Length : [2000] | reason for cancellation |
| claim_ | type of reason for cancellation Unavailable for marketplace or NAVER Pay order cancellations A: change of mind |
| naverpay_ | 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 |
| refund_ | Refund method T : cash |
| combined_ | 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".) T : cash |
| refund_ | code assigned to bank for refunds Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [250] | Bank name Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [50] | Refund account number Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [15] | Refund Account Account Holder's Name |
| items | Order item code |
| order_item_code quantity | |
Update an orders cancellation
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_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| claim_ Required | Cancellation number |
| recover_ Required | Inventory Recovery T : Recover |
| undone Required | Undo T : 철회함 |
| add_ Required | add to admin memo T: Enable |
| undone_ Required | Reason for undoing A: change of mind |
| undone_ Max Length : [2000] | Reason for undoing (Details) |
| expose_ Required | display reason in order details T: yes |
| exposed_ Max Length : [2000] | Reason for undoing (Storefront) |
Orders coupons
Endpoints
List all orders coupons
GET /api/v2/admin/orders/coupons
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ 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 |
Orders inflowgroups
List all orders inflowgroups
GET /api/v2/admin/orders/inflowgroups
GET
Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Create an orders inflowgroup
POST /api/v2/admin/orders/inflowgroups
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 |
|---|---|
| inflow_ Required Max Length : [40] | Traffic source group ID |
| inflow_ Required Max Length : [100] | Traffic source name |
Update an orders inflowgroup
PUT /api/v2/admin/orders/inflowgroups/{inflow_group_id}
PUT
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 |
|---|---|
| inflow_ Required Type : [a-zA-Z0-9] | Traffic source group ID |
| inflow_ Required Max Length : [100] | Traffic source name |
Delete an orders inflowgroup
DELETE /api/v2/admin/orders/inflowgroups/{inflow_group_id}
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 |
|---|---|
| inflow_ Required Max Length : [40] | Traffic source group ID |
Orders inflowgroups inflows
List all orders inflowgroups inflows
GET /api/v2/admin/orders/inflowgroups/{group_id}/inflows
GET
Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| group_ Required Max Length : [40] | Traffic source group ID |
Create an orders inflowgroups inflow
POST /api/v2/admin/orders/inflowgroups/{group_id}/inflows
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 |
|---|---|
| group_ Required Max Length : [40] | Traffic source group ID |
| inflow_ Required Max Length : [40] | Traffic source medium ID |
| inflow_ Required Max Length : [100] | Traffic source medium name |
| inflow_ Required URL | funnel icon |
Update an orders inflowgroups inflow
PUT /api/v2/admin/orders/inflowgroups/{group_id}/inflows/{inflow_id}
PUT
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 |
|---|---|
| group_ Required Max Length : [40] | Traffic source group ID |
| inflow_ Required Max Length : [40] | Traffic source medium ID |
| inflow_ Required Max Length : [100] | Traffic source medium name |
| inflow_ Required URL | funnel icon |
Delete an orders inflowgroups inflow
DELETE /api/v2/admin/orders/inflowgroups/{group_id}/inflows/{inflow_id}
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 |
|---|---|
| group_ Required Max Length : [40] | Traffic source group ID |
| inflow_ Required Max Length : [40] | Traffic source medium ID |
Orders items
Items is the item information purchased by the shopping mall customer when ordering. Items in the shopping mall are the basic units of items sold in the shopping mall. In addition to the item information of the purchased items, you can also check the information on the options, order quantity, and so on.
Items can only be used in the Order subset as a embedded Resource.
Orders items properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| item_ | Item no Identification number of order item. |
| order_ | Order item code Identification code of order item. |
| variant_ | Variant code System assigned code to variant. This code cannot be duplicated. |
| product_ | Product number System assigned code. This code cannot be duplicated. |
| product_ | Product code System assigned code. This code cannot be duplicated. |
| custom_ Max Length : [40] | Custom product code |
| custom_ | Custom variants code |
| eng_ | English name of product English name of product. Necessary when shipping to abroad. |
| option_ | Option id Identification number of product option. |
| option_ | Option value Option value of product option. |
| option_ | Default option |
| additional_ | Additional option value |
| additional_ | custom text list |
| product_ | Product name Name of product. Basic information to search the product and seperate each product. You may input this with HTML. |
| product_ | Default product name |
| product_ | Product price Product price. If mall using multi mall, the price will be transfer to multi mall currency. |
| option_ | Option price Additional price when option has additional price. |
| additional_ | Additional discount price Additional discount price for product. |
| coupon_ | discount price for product-specific coupon |
| app_ | product discount price for app |
| actual_ | Amount paid per item |
| quantity | Available inventory Quantity of ordered product. |
| product_ | Tax classify by products A: Taxable |
| tax_ | Tax rate |
| supplier_ | Supplier product name Product name of supplier. |
| supplier_ | Supplier transaction type Transaction type of supplier. D: Direct registration type |
| supplier_ | Supplier id ID of supplier. |
| supplier_ | Supplier name Name of supplier. |
| tracking_ | Tracking number |
| shipping_ | Shipping code Shipping code of order. System assigns the code when order status changes to 'Ready for shipping : N21' status. |
| claim_ | Cancellation/Exchange/Return Number |
| claim_ | type of cancellation/exchange/return request reason Type of reason for cancellation/exchange/refund request submitted by a customer |
| claim_ | reason for cancellation/exchange/return request Detailed reason for cancellation/exchange/refund request submitted by a customer |
| refund_ | Bank name |
| refund_ | Refund account number |
| refund_ | Refund Account Account Holder's Name |
| post_ | Post express flag Whether post express linked or not. |
| order_ | Order status Order status. Each status has its own code. |
| request_ | undone request type Cancellation: cancellation undone |
| order_ | Order status additional info order status additional info |
| claim_ | number of cancellation/exchange/return requests |
| status_ | Status code Current status code. N1: Normal |
| status_ | Status text Description of current status. |
| open_ | Open market status |
| bundled_ | combined shipment type Bundel shipping type of the order. N: General delivery for a single order (Normal) |
| shipping_ | Shipping company id ID of shipping company. |
| shipping_ | Shipping company name Name of shipping company. |
| shipping_ | shipping carrier code |
| product_ | Product bundle T: Set product |
| product_ | Set product number Number of Separable bundle product. |
| product_ | Set product name Name of separable bundle product. |
| product_ | Set product name (default) Name of separable bundle product. (default) |
| product_ | Product bundle type Type of bundle product. C: Integrated type |
| was_ | Was product bundled Whether bundle product has been separated or not. T: Has been separated |
| original_ | Original bundle item no Original item number of separated buldle product. |
| naver_ | Naver pay order ID Order ID of order from 'Naver pay'. |
| naver_ | Naver pay claim status Claim type of order from 'Naver pay'. PAYMENT_WAITING: Deposit on standby |
| individual_ | Individual shipping fee Individual shipping fee of order. |
| shipping_ | Shipping charge (When using 'Shipping charge individually') Type of shipping charge. T: Free |
| shipping_ | Shipping fee type Description of shipping fee type. |
| shipping_ | digital wallet balance/Pay after delivery C: Pay after delivery |
| payment_ | Payment information ID |
| original_ | Original item no |
| store_ | Store pickup Whether the order can pickup at an offline store or not. T: Store pickup |
| ordered_ timezone | Ordered date |
| shipped_ timezone | Shipped date Date of shipping started. |
| delivered_ timezone | Delivered date Delivered date of order. |
| cancel_ timezone | Order cancellation date Date of order canceled. |
| return_ timezone | Return approval time |
| return_ timezone | Return request date Date of return requested. |
| return_ timezone | return pickup date |
| cancel_ timezone | Cancellation request date Date of request order cancel. |
| refund_ timezone | Refund date Date of refund completed. |
| exchange_ timezone | Exchange request date Date of request exchange. |
| exchange_ timezone | Exchange date Date of exchange completed. |
| product_ | 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. |
| product_ | English product material Description of product material in English. |
| cloth_ | Fabric of product In case cloth products using a Japanese courier service, material information may required for some shipping companies. |
| product_ | Weight of product Weight of whole product. Total weight including product, box, and packing weight is necessary for shipping. |
| volume_ | Product volume Volume size of a product. |
| volume_ | Volume size weight volumetric weight of a product. |
| clearance_ | Clearance category code Category code for the purpose of customs clearance. |
| clearance_ | Clearance category information |
| clearance_ | Clearance category code Category code for the purpose of customs clearance. |
| hs_ | HS code HS code for customs clerance. |
| one_ | One plus n event Whether 1 plus N event or not. |
| origin_ | Origin Search for products that include keyword in the origin place. (Case Insensitive) |
| origin_ | Code of origin |
| made_ | Origin country code |
| gift | Gift Whether product is for gift or not. T: gift |
| item_ | Items that need to be purchased to offer gifts |
| subscription | subscription billing in use T: subscription billing in use |
| product_ | List of set items |
| market_ | marketplace order cancellation T: marketplace order with cancellation request submitted |
| market_ | number of cancellation requested marketplace order |
| market_ | reason for marketplace order failure |
| market_ | detailed reason for marketplace order failure |
| market_ | online marketplace custom variant code |
| option_ | Type of option T: Combination |
| options | Option |
| order_ | Order ID |
| claim_ | cancellation/exchange/return type |
| claim_ | cancellation/exchange/return request status |
List all orders items
GET /api/v2/admin/orders/{order_id}/items
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| order_ Required Order ID | Order ID |
Update an orders item
PUT /api/v2/admin/orders/{order_id}/items/{order_item_code}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| order_ Required | Order item code |
| claim_ Required | cancellation/exchange/return type C: cancel |
| claim_ Required | cancellation/exchange/return request status T : submit request |
| claim_ Required | type of cancellation/exchange/return request reason A: change of mind |
| claim_ | reason for cancellation/exchange/return request |
| claim_ | number of cancellation/exchange/return requests |
Orders memos
Orders memos properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| memo_ | Memo number |
| order_ | Order ID |
| created_ timezone | memo added date |
| author_ | Author ID |
| ip | author IP address |
| use_ | added to customer inquiries T: Used |
| attach_ | attached to O : order number |
| content | Memo description |
| starred_ | Important memo T: Important memo |
| fixed | pinned to top T: Used |
| product_ | Product list |
| topic_ | inquiry type cs_01 : shipping |
| status | response status F : in progress |
List all orders memos (multiple orders)
GET /api/v2/admin/orders/memos
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ 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 |
List all orders memos
GET /api/v2/admin/orders/{order_id}/memos
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
Create an orders memo
POST /api/v2/admin/orders/{order_id}/memos
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
| content Required Max Length : [1000] | Memo description |
| use_ | added to customer inquiries T: Used DEFAULT F |
| topic_ | inquiry type cs_01 : shipping |
| status | response status F : in progress |
| attach_ | attached to O : order number DEFAULT O |
| starred_ | Important memo T: Important memo DEFAULT F |
| fixed | pinned to top T: Used DEFAULT F |
| product_ | Product list |
Update an orders memo
PUT /api/v2/admin/orders/{order_id}/memos/{memo_no}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
| memo_ Required | Memo number |
| content Max Length : [1000] | Memo description |
| use_ | added to customer inquiries T: Used DEFAULT F |
| topic_ | inquiry type cs_01 : shipping |
| status | response status F : in progress |
| attach_ | attached to O : order number DEFAULT O |
| starred_ | Important memo T: Important memo DEFAULT F |
| fixed | pinned to top T: Used DEFAULT F |
| product_ | Product list |
Delete an orders memo
DELETE /api/v2/admin/orders/{order_id}/memos/{memo_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
| memo_ Required | Memo number |
Orders paymentamount
Endpoints
Orders paymentamount properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| order_ | Order item code |
| items | Item information |
| order_ | Purchase amount |
| order_ | Order discount amount |
| item_ | Product discount amount |
| additional_ | alternative payment amount |
| actual_ | Amount paid per item |
List all orders paymentamount
GET /api/v2/admin/orders/paymentamount
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order item code You can search multiple item with ,(comma) |
Orders payments
Orders payments properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| order_ | Order ID |
| change_ | change in payment amount T: Use |
| change_ | change in payment method T: Use |
| payment_ | Payment Method |
| payment_ | error message displayed for PG transaction cancellations |
| admin_ | manually input amount |
| commission | Transaction fee |
| initial_ | initial estimated payment amount |
| change_ | reason for change in payment amount |
Update an orders payment
PUT /api/v2/admin/orders/{order_id}/payments
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| change_ Required | change in payment amount T: Use |
| change_ Required | change in payment method T: Use |
| payment_ | Payment Method cash: Bank transfer |
| billing_ Max Length : [40] | Depositor name Available when "change_payment_method" is set as "T", and the payment method is changed to bank deposit. |
| bank_ | bank ID (for bank transfer without a bankbook) Available when "change_payment_method" is set as "T", and the payment method is changed to bank deposit. |
| admin_ Min : [0] | manually input amount Available when "change_payment_amount" is set as "T". |
| commission Min : [0] | Transaction fee Available when "change_payment_amount" is set as "T", and the payment method is changed to Daibiki. |
| change_ Max Length : [255] | reason for change in payment amount Available when "change_payment_amount" is set as "T". |
Orders paymenttimeline
Orders paymenttimeline properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| payment_ | Payment number |
| payment_ | payment type O: initial payment |
| order_ | Order Amount |
| additional_ | alternative payment amount |
| paid_ | amount paid |
| payment_ | Payment Method |
| payment_ timezone | Payment date |
| created_ timezone | input date |
| payment_ | payment amounts by payment method It can only be viewed when retrieving details. |
| order_ | price and fee details It can only be viewed when retrieving details. |
List all orders paymenttimeline
GET /api/v2/admin/orders/{order_id}/paymenttimeline
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| start_ Date | Search Start Date |
| end_ Date | Search End Date |
| date_ | Date type created_datetime: Order creation date |
Get an orders paymenttimeline
GET /api/v2/admin/orders/{order_id}/paymenttimeline/{payment_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| payment_ Required Min : [1] | Payment number |
Orders receivers
Receivers are the names, contacts, and address information of the recipients to whom the ordered goods will be shipped.
Recipient can only be used in the Order subset as a embedded Resource.
Orders receivers properties
| Attribute | Description |
|---|---|
| shop_ Min : [1] | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| name | Receiver name Name of recipient. May differ from orderer name or billing name. |
| name_ | Receiver name (Pronunciation) Name of recipient in Japanese Furigana. |
| phone | Office phone number |
| cellphone | Receiver mobile phone number |
| virtual_ | Receiver virtual number |
| zipcode | Zipcode |
| address1 | Address 1 |
| address2 | Address 2 |
| address_ | state |
| address_ | City / Town |
| address_ | street |
| address_ | Full address |
| name_ | Receiver name (English) |
| city_ | Receiver city (English) |
| state_ | Receiver state (English) |
| street_ | Receiver address (English) |
| country_ | Country code |
| country_ | Country |
| country_ | Country (English) |
| shipping_ | Shipping message |
| clearance_ | customs clearance information I: ID |
| clearance_ | customs clearance information |
| wished_ | Desired delivery date |
| wished_ | Desired delivery time |
| shipping_ | Shipping code |
| change_ | Change default shipping address T: Yes |
List all orders receivers
GET /api/v2/admin/orders/{order_id}/receivers
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| order_ Required Order ID | Order ID |
| shipping_ | Shipping code You can search multiple item with ,(comma) |
Update orders receivers
PUT /api/v2/admin/orders/{order_id}/receivers
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
| name Max Length : [20] | Receiver name |
| phone Max Length : [20] | Receiver phone number |
| cellphone Max Length : [20] | Receiver mobile phone number |
| shipping_ | Shipping message |
| name_ | Receiver name (Pronunciation) |
| zipcode Min Length : [2] | Zipcode |
| address1 Max Length : [255] | Address 1 |
| address2 Max Length : [255] | Address 2 |
| address_ | state |
| address_ | City / Town |
| name_ | Receiver name (English) |
| city_ | Receiver city (English) |
| state_ | Receiver state (English) |
| street_ | Receiver address (English) |
| country_ | Country code |
| clearance_ | customs clearance information I: ID |
| clearance_ | customs clearance information |
| shipping_ | Shipping code |
| change_ | Change default shipping address T: Yes DEFAULT F |
| virtual_ | Receiver virtual number |
Update an orders receiver
PUT /api/v2/admin/orders/{order_id}/receivers/{shipping_code}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
| shipping_ Required | Shipping code |
| name Max Length : [20] | Receiver name |
| phone Max Length : [20] | Receiver phone number |
| cellphone Max Length : [20] | Receiver mobile phone number |
| shipping_ | Shipping message |
| name_ | Receiver name (Pronunciation) |
| zipcode Min Length : [2] | Zipcode |
| address1 Max Length : [255] | Address 1 |
| address2 Max Length : [255] | Address 2 |
| address_ | state |
| address_ | City / Town |
| name_ | Receiver name (English) |
| city_ | Receiver city (English) |
| state_ | Receiver state (English) |
| street_ | Receiver address (English) |
| country_ | Country code |
| clearance_ | customs clearance information I: ID |
| clearance_ | customs clearance information |
| change_ | Change default shipping address T: Yes DEFAULT F |
| virtual_ | Receiver virtual number |
Orders receivers history
Orders receivers history properties
| Attribute | Description |
|---|---|
| shop_ Min : [1] | Shop Number |
| name | Receiver name |
| phone | Office phone number |
| cellphone | Receiver mobile phone number |
| zipcode | Zipcode |
| address1 | Address 1 |
| address2 | Address 2 |
| address_ | state |
| address_ | City / Town |
| address_ | street |
| address_ | Full address |
| name_ | Receiver name (English) |
| city_ | Receiver city (English) |
| state_ | Receiver state (English) |
| street_ | Receiver address (English) |
| country_ | Country code |
| country_ | Country |
| country_ | Country (English) |
| shipping_ | Shipping message |
| updated_ timezone | Updated date |
| user_ | ID of the persons modified the orderer |
| user_ | name of the persons modified the order |
| shipping_ | Shipping code |
List all orders receivers history
GET /api/v2/admin/orders/{order_id}/receivers/history
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
Orders return
Create an orders return
POST /api/v2/admin/orders/{order_id}/return
POST
This API allows you to process returns for a specific order. When returns are processed by using this API, orders will be marked as returned and payments will be canceled via payment gateways. (When "T" is used for "payment_gateway_cancel")
For partial cancellations, refund amount for each order will be automatically calculated and processed.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| payment_ | 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. T : cancel DEFAULT F |
| status Required | Order status returned: returned |
| recover_ | Inventory Recovery T : Recover DEFAULT F |
| recover_ | restore a coupon T : Recover DEFAULT F |
| add_ | add to admin memo T: Enable DEFAULT F |
| reason Max Length : [2000] | refund reason |
| claim_ | type of refund reason A: change of mind |
| naverpay_ | reason for NAVER Pay order cancellation This cannot be used on Cafe24 Vietnam, Philippines, Japan. 51 : change of mind |
| refund_ | Refund method T : cash |
| combined_ | 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".) T : cash |
| refund_ | code assigned to bank for refunds Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [250] | Bank name Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [50] | Refund account number Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [15] | Refund Account Account Holder's Name |
| items | Order item code |
| order_item_code quantity | |
Orders saleschannels
List all orders saleschannels
GET /api/v2/admin/orders/saleschannels
GET
Access to this API is limited to certain clients only. Please contact Cafe24 Developers to access it.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| limit Min : [1]~Max : [500] | Limit DEFAULT 10 |
| offset Max : [10000] | Start location of list |
Create an orders saleschannel
POST /api/v2/admin/orders/saleschannels
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 |
|---|---|
| sales_ Required Max Length : [40] | vendor ID |
| sales_ Required Max Length : [100] | vendor name |
| sales_ Required URL | vendor icon |
Update an orders saleschannel
PUT /api/v2/admin/orders/saleschannels/{sales_channel_id}
PUT
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 |
|---|---|
| sales_ Required Max Length : [40] | vendor ID |
| sales_ Max Length : [100] | vendor name |
| sales_ URL | vendor icon |
Delete an orders saleschannel
DELETE /api/v2/admin/orders/saleschannels/{sales_channel_id}
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 |
|---|---|
| sales_ Required Max Length : [40] | vendor ID |
Orders shipments
This resource is about shipping information required for fulfillment. This resource contains information such as invoice number, carrier, shipping status, etc.
Orders shipments properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| shipping_ | Shipping code |
| order_ | Order ID |
| tracking_ | Tracking number |
| tracking_ timezone | Input date (Tracking number) |
| shipping_ | shipping carrier code |
| items | list of items |
| status | Order status standby : waiting for shipping |
| order_ | Order item code |
| status_ | Order status additional info |
List all orders shipments
GET /api/v2/admin/orders/{order_id}/shipments
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required Order ID | Order ID |
Register shipments information
POST /api/v2/admin/orders/{order_id}/shipments
POST
You can flag orders to indicate the shipping status such as Awaiting shipment or In-transit.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| tracking_ Required Max Length : [30] | Tracking number |
| shipping_ Required | shipping carrier code |
| order_ | Order item code |
| status Required | Order status standby : waiting for shipping |
| shipping_ | Shipping code |
Update orders shipment information
PUT /api/v2/admin/orders/{order_id}/shipments/{shipping_code}
PUT
You can update shipping information (shipping status, etc.).
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| shipping_ Required | Shipping code |
| status | Order status "tracking_no" and "shipping_company_code" cannot be used when "status" is used to change the shipping status. standby : waiting for shipping |
| status_ Max Length : [30] | Order status additional info |
| tracking_ Max Length : [30] | Tracking number "shipping_company_code" must be used with "tracking_no", and "status" cannot be used to change the shipping status. |
| shipping_ | shipping carrier code shipping_company_code |
Delete an orders shipment
DELETE /api/v2/admin/orders/{order_id}/shipments/{shipping_code}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| shipping_ Required | Shipping code |
Orders shippingfeecancellation
Orders shippingfeecancellation properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| order_ | Order ID |
| default_ | default shipping fee |
| supplier_ | Supplier shipping fee |
| individual_ | Individual shipping fee |
| international_ | 해외배송비 |
| international_ | International shipping insurance |
| additional_ | Additional shipping fee |
| additional_ | Additional handling fee |
| regional_ | regional shipping rates |
| claim_ | cancellation number |
| claim_ | division A: change of mind |
| claim_ | Reason |
| refund_ | Refund method |
| shipping_ | Shipping discount cancellation amount |
| coupon_ | Coupon discount cancellation amount |
| refund_ | refund amount |
| point_ | Reimbursement Return Used |
| credit_ | Deposit Refund Used |
| mixed_ | mixed refund amount |
| mixed_ | Mixed refund methods |
| status | Order status LIBSPECDATACANCELING.PROCESSING |
List all orders shippingfeecancellation
GET /api/v2/admin/orders/{order_id}/shippingfeecancellation
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
Create an orders shippingfeecancellation
POST /api/v2/admin/orders/{order_id}/shippingfeecancellation
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| reason Max Length : [2000] | reason for cancellation |
| claim_ | type of reason for cancellation A: change of mind |
| recover_ | restore a coupon T : Recover DEFAULT F |
| refund_ | Refund method T : cash |
| combined_ | Mixed refund methods T : cash |
| refund_ | code assigned to bank for refunds |
| refund_ Max Length : [250] | Bank name |
| refund_ Max Length : [50] | Refund account number |
| refund_ Max Length : [15] | Refund Account Account Holder's Name |
| payment_ | PG cancellation request settings T : cancel DEFAULT F |
Orders shortagecancellation
Create an orders shortagecancellation
POST /api/v2/admin/orders/{order_id}/shortagecancellation
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_ Min : [1] | Shop Number |
| order_ Required | Order ID |
| payment_ | PG cancellation request settings T : cancel DEFAULT F |
| keep_ | keep the automatic discount calculation flag yes: T DEFAULT F |
| collect_ | automatically recapture gift T: Enable DEFAULT F |
| status Required | Order status canceled : canceled |
| recover_ | Inventory Recovery T : Recover DEFAULT F |
| recover_ | restore a coupon T : Recover DEFAULT F |
| add_ | add to admin memo T: Enable DEFAULT F |
| reason Max Length : [2000] | reason for cancellation |
| claim_ | type of reason for cancellation A: change of mind |
| naverpay_ | reason for NAVER Pay order cancellation This cannot be used on Cafe24 Vietnam, Philippines. 51 : change of mind |
| refund_ | Refund method T : cash |
| combined_ | Mixed refund methods T : cash |
| refund_ | code assigned to bank for refunds |
| refund_ Max Length : [250] | Bank name |
| refund_ Max Length : [50] | Refund account number |
| refund_ Max Length : [15] | Refund Account Account Holder's Name |
| items | Order item code |
| order_item_code quantity | |
Payments
Endpoints
Update payments
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 10 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| status Required | payment status paid: payment confirmed |
| recover_ | Inventory Recovery T : Recover |
| cancel_ | payment cancellation request details |
| refund_status partial_cancel payment_gateway_name payment_method response_code response_message | |
Refunds
Refunds properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| member_ | customer email |
| buyer_ | Buyer Email |
| order_ timezone | Ordered date |
| accepted_ timezone | refund requested date |
| refund_ timezone | refund completed date |
| order_ | Order ID |
| refund_ | refund number |
| order_ | list of items |
| quantity | Available inventory |
| actual_ | actual amount refunded |
| used_ | Reimbursement Return Used |
| used_ | Deposit Refund Used |
| used_ | refunded transferable points |
| currency | Currency |
| payment_ | Payment Method cash : deposit without a bankbook |
| refund_ | refunded in cash : deposit without a bankbook |
| payment_ | PG cancellation status F : before cancellation |
| payment_ timezone | PG canceled date |
| status | status of refund T: Refunded. F: Awaiting refund |
| refund_ | refund method |
| refund_ | Bank name |
| refund_ | Refund account number |
| refund_ | Refund Account Account Holder's Name |
| refund_ | refunded points It can only be viewed when retrieving details. |
| refund_ | refunded credits It can only be viewed when retrieving details. |
| refund_ | refunded NAVER points It can only be viewed when retrieving details. |
| refund_ | refunded NAVER cash It can only be viewed when retrieving details. |
| refund_ | refund amount It can only be viewed when retrieving details. |
| product_ | Product price It can only be viewed when retrieving details. |
| shipping_ | shipping fee It can only be viewed when retrieving details. |
| shipping_ | Shipping discount It can only be viewed when retrieving details. |
| cod_ | Postpayment Fee It can only be viewed when retrieving details. |
| foreign_ | additional handling fee for international shipping It can only be viewed when retrieving details. |
| product_ | per-product discount It can only be viewed when retrieving details. |
| member_ | customer level-based discount It can only be viewed when retrieving details. |
| app_ | product discount price for app It can only be viewed when retrieving details. |
| app_ | discount price of order for app It can only be viewed when retrieving details. |
| coupon_ | coupon discount It can only be viewed when retrieving details. |
| product_ | bundle discount It can only be viewed when retrieving details. |
| points_ | amount of points used It can only be viewed when retrieving details. |
| credits_ | amount of credits used It can only be viewed when retrieving details. |
| transferable_ | amount of transferable points used It can only be viewed when retrieving details. |
| naver_ | NAVER points It can only be viewed when retrieving details. |
| naver_ | NAVER cash It can only be viewed when retrieving details. |
| additional_ | price for additional product It can only be viewed when retrieving details. |
| manually_ | manually input amount It can only be viewed when retrieving details. |
| changed_ | change in refund amount It can only be viewed when retrieving details. |
| refund_ | refunded by It can only be viewed when retrieving details. |
| refund_ | refund reason It can only be viewed when retrieving details. |
| send_ | whether send SMS after processing refund It can only be viewed when retrieving details. T : send |
| send_ | whether send mail after processing refund It can only be viewed when retrieving details. T : send |
| items | Item Resource
It can only be viewed when retrieving details. |
List all refunds
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| start_ Required Date | Search Start Date |
| end_ Required Date | Search End Date |
| date_ | Date type accepted_refund_date : refund requested date DEFAULT refund_date |
| member_ | customer email |
| buyer_ | Buyer Email |
| order_ 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 |
Get a refund
GET /api/v2/admin/refunds/{refund_code}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| refund_ Required | refund number |
| items embed | Item Resource |
Return
Return refers to a process of returning the order after the product has been delivered to the customer. "Return" resource allows you to retrieve details on returns or process returns. With "Return" resource, you can retrieve order status from after a return request has been submitted to after an order has been returned.
Return properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number It can only be viewed when retrieving details. |
| order_ | Order ID It can only be viewed when retrieving details. |
| claim_ | cancellation number It can only be viewed when retrieving details. |
| claim_ | division Type of reason for accepting the customer's return request It can only be viewed when retrieving details. A: change of mind |
| claim_ | Reason Detailed reason for accepting the customer's return request. It can only be viewed when retrieving details. |
| claim_ | Due date for return It can only be viewed when retrieving details. |
| return_ | Return address It can only be viewed when retrieving details. |
| pickup | Pickup - Address It can only be viewed when retrieving details. |
| return_ | return tracking number It can only be viewed when retrieving details. |
| return_ | return shipping carrier It can only be viewed when retrieving details. |
| pickup_ | pickup request status It can only be viewed when retrieving details. E: pickup not requested |
| refund_ | Refund method It can only be viewed when retrieving details. |
| refund_ | Remarks It can only be viewed when retrieving details. |
| order_ | Purchase amount It can only be viewed when retrieving details. |
| refund_ | refund amount It can only be viewed when retrieving details. |
| shipping_ | shipping fee It can only be viewed when retrieving details. |
| return_ | Return shipping cost classification It can only be viewed when retrieving details. |
| return_ | return shipping fee It can only be viewed when retrieving details. |
| return_ | return shipping fee details It can only be viewed when retrieving details. |
| return_ | return shipping fee by region It can only be viewed when retrieving details. |
| return_ | return shipping fee by region details It can only be viewed when retrieving details. |
| defer_ | Postpayment Fee It can only be viewed when retrieving details. |
| partner_ | Affiliate discount cancellation amount It can only be viewed when retrieving details. |
| add_ | Extra discount discount by product It can only be viewed when retrieving details. |
| member_ | Membership Discount Discount Amount It can only be viewed when retrieving details. |
| shipping_ | Shipping discount cancellation amount It can only be viewed when retrieving details. |
| coupon_ | Coupon discount cancellation amount It can only be viewed when retrieving details. |
| point_ | Reimbursement Return Used It can only be viewed when retrieving details. |
| credit_ | Deposit Refund Used It can only be viewed when retrieving details. |
| undone | Undo It can only be viewed when retrieving details. T: Yes |
| undone_ | Reason for undoing It can only be viewed when retrieving details. A: change of mind |
| undone_ | Reason for undoing (Details) It can only be viewed when retrieving details. |
| expose_ | display reason in order details It can only be viewed when retrieving details. T: yes |
| exposed_ | Reason for undoing (Storefront) It can only be viewed when retrieving details. |
| items | Order item code It can only be viewed when retrieving details. |
| status | Order status canceled : canceled |
Get a return
GET /api/v2/admin/return/{claim_code}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_order |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| claim_ Required | Return number |
Create return
POST
This API allows you to process returns for multiple orders. When returns are processed by using this API, orders will be marked as returned, but you need to cancel payments via payment gateways.
For partial returns, refund amount for each order will be automatically calculated and processed.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| order_ Required | Order ID |
| status Required | Order status returned: returned |
| recover_ | Inventory Recovery T : Recover DEFAULT F |
| recover_ | restore a coupon T : Recover DEFAULT F |
| add_ | add to admin memo T: Enable DEFAULT F |
| reason Max Length : [2000] | refund reason |
| claim_ | type of refund reason A: change of mind |
| naverpay_ | reason for NAVER Pay order cancellation This cannot be used on Cafe24 Vietnam, Philippines, Japan. 51 : change of mind |
| refund_ | Refund method T : cash |
| combined_ | 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. T : cash |
| refund_ | code assigned to bank for refunds Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [250] | Bank name Required when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [50] | Refund account number Available only when refund method (refund_method) is set as cash (T) |
| refund_ Max Length : [15] | Refund Account Account Holder's Name |
| items | Order item code |
| order_item_code quantity | |
Shipments
This resource, unlike the Order resource's child Shipments resource, lets you create or update multiple orders’ shipping information in one call. This resource contains information about invoice number, courier, shipping status, etc.
Shipments properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| tracking_ | Tracking number |
| shipping_ | shipping carrier code |
| status | Order status standby : waiting for shipping |
| order_ | Order ID |
| shipping_ | Shipping code |
| order_ | Order item code |
| status_ | Order status additional info |
Create shipments
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| tracking_ Required Max Length : [30] | Tracking number |
| shipping_ Required | shipping carrier code |
| status Required | Order status standby : waiting for shipping |
| order_ | Order ID |
| shipping_ | Shipping code |
| order_ | Order item code |
Update shipments
PUT
You can update shipping information (shipping status, etc.).
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_order |
| Request Limit | 40 |
| objects per single API call Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| shipping_ Required | Shipping code |
| order_ | Order ID |
| status | Order status "tracking_no" and "shipping_company_code" cannot be used when "status" is used to change the shipping status. standby : waiting for shipping |
| status_ Max Length : [30] | Order status additional info |
| tracking_ Max Length : [30] | Tracking number "shipping_company_code" must be used with "tracking_no", and "status" cannot be used to change the shipping status. |
| shipping_ | shipping carrier code Both shipping carrier and tracking number of the order can be changed. |
Customer
Customergroups
Customergroups properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| group_ | Group number |
| group_ | Group Name |
| group_ | Group Description |
| benefits_ | Benefit payment condition A: All payments |
| buy_ | Buy benefits F: No benefits |
| ship_ | Shipping benefits T: Set free shipping fee |
| product_ | Product Availability P: Apply only discount by product |
| discount_ | Discount information |
| points_ | points issuance settings |
| mobile_ | Mobile discount information |
| mobile_ | settings for additional points issued for mobile purchases |
List all customergroups
GET /api/v2/admin/customergroups
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_customer |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| group_ | Group number You can search multiple item with ,(comma) |
| group_ Max Length : [20] | Group Name You can search multiple item with ,(comma) |
Count all customergroups
GET /api/v2/admin/customergroups/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_customer |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| group_ | Group number You can search multiple item with ,(comma) |
| group_ Max Length : [20] | Group Name You can search multiple item with ,(comma) |
Get a customergroup
GET /api/v2/admin/customergroups/{group_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_customer |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| group_ Required | Group number System assigned member group number. This code cannot be duplicated. |
Customergroups customers
Change groups of customers
POST /api/v2/admin/customergroups/{group_no}/customers
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_customer |
| Request Limit | 40 |
| objects per single API call Limit | 200 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| group_ Required | Group number |
| member_ Required Max Length : [20] | Member id |
| fixed_ | customer level fixing settings T: fix DEFAULT F |
Customers
Customers is customers who purchase products from shopping malls to receive coupons, reservations, discounts and other benefits from shopping malls. For membership management, a shopping mall operator may classify a member as a specific member class or designate a special member.
Endpoints
Customers properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| member_ Max Length : [20] | Member id |
| group_ | Group number number of member group of the customer |
| member_ | Member authentication Member authentication type. Customer divided as 4 types based on member authentication. T: Authorized |
| use_ | Whether the member is blacklist Whether customer is a blacklist or not. You may limit the customer action for log-in, purchase, and both log-in and purchase. T: Set |
| blacklist_ | Blacklist type Blacklist type of the customer. You may limit the customer action for log-in, purchase, and both log-in and purchase. P: Block purchase |
| sms | Whether to receive SMS Whether receive SMS or not. 'Do not receive' status receives only important mail such as order status, service information. T: Receive |
| news_ | Whether to receive news mails Whether receive email or not. 'Do not receive' status receives only important mail such as order status, service information. 'Never receive email' status doesn't receives not only commercial mail but also important service or order related emails. T: Receive |
| solar_ | Whether it is a solar calendar T: Solar calendar |
| total_ | total points |
| available_ | available points |
| used_ | used points |
| last_ timezone | Last login date last login date of the customer |
| gender | Gender Gender of the customer M: Male |
| use_ | Whether to use mobile app T: Using mobile app |
| available_ | available credits |
| created_ timezone | Created date |
| fixed_ | customer level fixing settings T: fix |
Search customers
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_customer |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| cellphone | Mobile Mobile number of the customer to enter when searching for customers by mobile number. For privacy issues, the entire mobile number must be entered. Either one of the two attributes,"cellphone" or "member_id", must be set as required. You can search multiple item with ,(comma) |
| member_ Max Length : [20] | Member id ID of the customer to enter when searching for customers by ID. For privacy issues, the entire ID must be entered. Either one of the two attributes, "cellphone" or "member_id", must be set as required. You can search multiple item with ,(comma) |
Customers memos
Child resource of the Customers resource about memos of a certain customer.
Endpoints
GET /api/v2/admin/customers/{member_id}/memos
GET /api/v2/admin/customers/{member_id}/memos/count
GET /api/v2/admin/customers/{member_id}/memos/{memo_no}
POST /api/v2/admin/customers/{member_id}/memos
PUT /api/v2/admin/customers/{member_id}/memos/{memo_no}
DELETE /api/v2/admin/customers/{member_id}/memos/{memo_no}Customers memos properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| memo_ | Memo number System assigned code. This code cannot be duplicated. |
| author_ | Author ID ID of memo writer. |
| memo | Memo description Contents of memo. You may input this with HTML.. |
| important_ | Important memo Flag for distinguish important memo. T: Important memo |
| created_ timezone | Created date Written date of memo. |
List all customers memos
GET /api/v2/admin/customers/{member_id}/memos
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_customer |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| member_ Required | Member id |
| offset Max : [10000] | Start location of list |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
Count all customers memos
GET /api/v2/admin/customers/{member_id}/memos/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_customer |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| member_ Required | Member id |
Get a customers memo
GET /api/v2/admin/customers/{member_id}/memos/{memo_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_customer |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| memo_ Required | Memo number System assigned code. This code cannot be duplicated. |
| member_ Required | Member id |
Create a customers memo
POST /api/v2/admin/customers/{member_id}/memos
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_customer |
| Request Limit | 30 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| member_ Required | Member id |
| author_ Required Max Length : [20] | Author ID ID of memo writer. |
| memo Required | Important memo Contents of memo. You may input this with HTML.. |
| important_ | Important memo Flag for distinguish important memo. T: Important memo DEFAULT F |
Update a customers memo
PUT /api/v2/admin/customers/{member_id}/memos/{memo_no}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_customer |
| Request Limit | 30 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| memo_ Required | Memo number System assigned code. This code cannot be duplicated. |
| member_ Required | Member id |
| author_ Required Max Length : [20] | Author ID ID of memo writer. |
| memo | Important memo Contents of memo. You may input this with HTML.. |
| important_ | Important memo Flag for distinguish important memo. T: Important memo |
Delete a customers memo
DELETE /api/v2/admin/customers/{member_id}/memos/{memo_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_customer |
| Request Limit | 30 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| memo_ Required | Memo number System assigned code. This code cannot be duplicated. |
| member_ Required | Member id |
Customers paymentinformation
List all customers paymentinformation
GET /api/v2/admin/customers/{member_id}/paymentinformation
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_customer |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| member_ Required Max Length : [20] | Member id |
Delete a customers paymentinformation
DELETE /api/v2/admin/customers/{member_id}/paymentinformation
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_customer |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| member_ Required Max Length : [20] | Member id |
Community
Boards
Endpoints
Boards properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| board_ | board number |
| board_ | board category 1: administration |
| board_ | board name |
| use_ | whether to add more boards T: additional board |
| use_ | whether to use board T: Use |
| use_ | whether to display T: Displayed |
| display_ | Order by |
Boards articles
Boards articles refers to data on posts posted on [Boards].
Boards articles properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| article_ | posts number |
| parent_ | posts number of parent posts |
| board_ Required | board number |
| product_ | Product number |
| category_ | category number |
| board_ | category number of a board |
| reply_ | order of replied posts |
| reply_ | answer depth |
| created_ Date | date of create |
| writer | writer |
| writer_ | email of writer |
| member_ | Member id |
| title | subject |
| content | content |
| client_ IP | IP address of a writer |
| nick_ | nickname |
| rating Min : [1]~Max : [5] | review score |
| sales_ Max Length : [20] | sales channel |
| reply_ | whether replied by mail for 1:1 query Y : used |
| display | post publishing settings T: publish |
| secret | whether secret posts T: Use |
| notice | whether notice T: Use |
| fixed | whether fixed T: Use |
| deleted | whether deleted T : deleted |
| input_ | posting path P : PC |
| order_ | Order ID |
| attach_ | attached file detail |
| hit | views |
| reply | whether replied for 1:1 query T: Use |
| reply_ | manager ID of which processing or completed answer |
| reply_ | status of replay N : before answer |
| naverpay_ | review ID of Naver Pay |
| display_ | Exposure time settings |
| display_ | Exposure start time |
| display_ | Exposure end time |
| attached_ | attached file detail |
| attached_ | attached file detail |
List all boards articles
GET /api/v2/admin/boards/{board_no}/articles
GET
This API can only be used in stores using Korean or Japanese.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| board_ Required | board number |
| board_ | category number of a board |
| start_ Date | Creation start date |
| end_ Date | Creation end date |
| input_ | Types of online stores P: PC |
| search | Search scope subject: title |
| keyword | Keyword |
| reply_ | Answered N: Unanswered |
| comment | Comments T: Yes |
| attached_ | Attachment T: Yes |
| article_ | type of post You can search multiple item with ,(comma) all: all |
| product_ | Product number |
| has_ | include product information T: Yes |
| limit Min : [1]~Max : [100] | Limit DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Create boards articles
POST /api/v2/admin/boards/{board_no}/articles
POST
This API can only be used in stores using Korean or Japanese.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 40 |
| objects per single API call Limit | 10 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| board_ Required | board number |
| writer Required Max Length : [100] | writer |
| title Required Max Length : [256] | subject |
| content Required | content |
| client_ Required IP | IP address of a writer |
| reply_ | replied post number |
| created_ Date | date of create |
| writer_ | email of writer |
| member_ Max Length : [20] | Member id |
| notice | whether notice T: Use DEFAULT F |
| fixed | whether fixed T: Use DEFAULT F |
| deleted | whether deleted T : deleted DEFAULT F |
| reply | whether replied for 1:1 query T: Use DEFAULT F |
| rating Min : [1]~Max : [5] | review score |
| sales_ Max Length : [20] | sales channel |
| secret | whether secret posts T: Use DEFAULT F |
| password | password of posts |
| reply_ | whether replied by mail for 1:1 query Y : used DEFAULT N |
| board_ | category number of a board |
| nick_ Max Length : [50] | nickname |
| input_ | posting path P : PC DEFAULT P |
| reply_ | manager ID of which processing or completed answer |
| reply_ | status of replay N : before answer |
| product_ | Product number |
| category_ | category number |
| order_ Order ID | Order ID |
| naverpay_ | review ID of Naver Pay |
| attach_ | attached file detail |
| name url | |
Update a boards article
PUT /api/v2/admin/boards/{board_no}/articles/{article_no}
PUT
This API can only be used in stores using Korean or Japanese.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| board_ Required | board number |
| article_ Required | posts number |
| title Max Length : [256] | subject |
| content | content |
| rating Min : [1]~Max : [5] | review score |
| sales_ Max Length : [20] | sales channel |
| board_ | category number of a board |
| display | post publishing settings T: publish |
| notice | whether notice T: Use |
| fixed | whether fixed T: Use |
| display_ | Exposure start time |
| display_ | Exposure end time |
| attach_ URL | url of file |
| attach_ URL | url of file |
| attach_ URL | url of file |
| attach_ URL | url of file |
| attach_ URL | url of file |
Delete a boards article
DELETE /api/v2/admin/boards/{board_no}/articles/{article_no}
DELETE
This API can only be used in stores using Korean or Japanese.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| board_ Required | board number |
| article_ Required | posts number |
Boards articles comments
Boards articles comments properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| board_ | board number |
| article_ | posts number |
| comment_ | Comment number |
| content | comment content |
| writer Max Length : [100] | writer |
| member_ Max Length : [20] | Member id |
| created_ Date | date of create |
| client_ IP | IP address of a writer |
| rating Min : [1]~Max : [5] | comment rating |
| secret | whether secret posts T: Use |
| parent_ | parent comment number |
| input_ | Types of online stores P: PC |
List all boards articles comments
GET /api/v2/admin/boards/{board_no}/articles/{article_no}/comments
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| board_ Required | board number |
| article_ Required | posts number |
| comment_ | Comment number |
| limit Min : [1]~Max : [100] | Limit DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Create a boards articles comment
POST /api/v2/admin/boards/{board_no}/articles/{article_no}/comments
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| board_ Required | board number |
| article_ Required | posts number |
| content Required | comment content |
| writer Required Max Length : [100] | writer |
| password Required Length Min : [1]~Max : [20] | comment password |
| member_ Max Length : [20] | Member id |
| rating Min : [1]~Max : [5] | comment rating |
| secret | whether secret posts T: Use DEFAULT F |
| parent_ Min : [1] | parent comment number |
| input_ | Types of online stores P: PC DEFAULT P |
| created_ Date | date of create |
Delete a boards articles comment
DELETE /api/v2/admin/boards/{board_no}/articles/{article_no}/comments/{comment_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| board_ Required | board number |
| article_ Required | posts number |
| comment_ Required | Comment number |
Customers reviews
Customer Reviews is a relational Resource that allows you to see a list of reviews created by shopper customers.
Customers reviews properties
| Attribute | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages |
| product_ | Product number |
| review_ | Review no. |
| order_ Order ID | Order number order number |
| nickname | Author’s nickname |
| title | Review title |
| content | Content of the review |
| content_ | Length of the review |
| input_ | Device used for review P : PC |
| writer | Author's name |
| writing_ | Author's ID |
| created_ Date | Created date |
| updated_ | Updated date |
| comment_ | No. of comments |
| like_ Min : [0] | No. of Likes |
| share_ Min : [0] | No. of shares |
| hit_ Min : [0] | Views |
| additional_ | Additional field |
| images | Attached image Image that attached at review. |
| tags | Hashtags |
| rating | Ratings Rating of review. |
| use_ | Social media shares Whether share review to SNS. T : Shared |
| display | Visibility Whether display or not. T : Published |
| deleted | Deletion status Whether deleted or not. T : Deleted |
List all customers reviews
GET /api/v2/admin/customers/{writing_id}/reviews
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ | Review no. |
| writing_ Required | Author's ID Member ID of review writer. |
| created_ Date | Date range - Start date Start date when searching for reviews by submission date. Must be used with an end date. |
| created_ Date | Date range - End date End date when searching reviews by submission date. Must be used with a start date. |
| updated_ Date | Date range - Start date |
| updated_ Date | Date range - End date |
| deleted | Review deletion status =VLOOKUP(D1159,$D$266:F1812,5,0) T : Deleted DEFAULT F |
| input_ | Device used for review Review wrote path P : PC |
| has_ | Search only for reviews that contain comments Search for reviews that has comment. T : Search only for reviews that contain comments |
| has_ | Search only for reviews that contain attached images Search for reviews that has image attachment. T : Search only for reviews that contain attached images |
| search_ | Target filters writer : Author's name |
| keyword | Filter |
| mileage | Points issuance status Whether points have been issued todo : Not issued |
| limit Min : [1] | Number of fields displayed in list Set the maximum number of search result. DEFAULT 50 |
| offset Min : [0] | Date from which results should be imported |
Count all customers reviews
GET /api/v2/admin/customers/{writing_id}/reviews/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| writing_ Required | Author's ID Member ID of review writer. |
| created_ Date | Date range - Start date Start date when searching for reviews by submission date. Must be used with an end date. |
| created_ Date | Date range - End date End date when searching reviews by submission date. Must be used with a start date. |
| updated_ Date | Date range - Start date |
| updated_ Date | Date range - End date |
| deleted | Review deletion status Whether deleted or not. T : Deleted DEFAULT F |
| input_ | Device used for review P : PC |
| has_ | Search only for reviews that contain comments Search for reviews that has comment. T : Search only for reviews that contain comments |
| has_ | Search only for reviews that contain attached images Search for reviews that has image attachment. T : Search only for reviews that contain attached images |
| search_ | Target filters writer : Author's name |
| keyword | Filter |
| mileage | Points issuance status Whether points have been issued todo : Not issued |
Get a customers review
GET /api/v2/admin/customers/{writing_id}/reviews/{review_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| writing_ Required | Author's ID Member ID of review writer. |
| review_ Required | Review no. |
Reviews
Reviews is reviews written by customers in a shopping mall after using a product or service. To use the Reviews API, you first need to make sure that shopping mall using the Reviewtalk service in the shopping mall.
Reviews properties
| Attribute | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages |
| product_ | Product number |
| review_ | Review no. |
| order_ Order ID | Order number order number |
| nickname | Author’s nickname |
| title | Review title |
| content | Content of the review |
| content_ | Length of the review |
| input_ | Device used for review P : PC |
| writer | Author's name |
| writing_ | Author's ID |
| created_ Date | Created date |
| updated_ | Updated date |
| comment_ | No. of comments |
| like_ Min : [0] | No. of Likes |
| share_ Min : [0] | No. of shares |
| hit_ Min : [0] | Views |
| additional_ | Additional field |
| images | Attached image Image that attached at review. |
| tags | Hashtags |
| rating | Ratings Rating of review. |
| use_ | Social media shares Whether share review to SNS. T : Shared |
| display | Visibility Whether display or not. T : Published |
| deleted | Deletion status Whether deleted or not. T : Deleted |
List all reviews
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ | Review no. |
| writing_ | Author's ID member ID |
| created_ Date | Date range - Start date Start date when searching for reviews by submission date. Must be used with an end date. |
| created_ Date | Date range - End date End date when searching reviews by submission date. Must be used with a start date. |
| deleted | Review deletion status Whether review is deleted or not. T : Deleted DEFAULT F |
| input_ | Device used for review P : PC |
| has_ | Search only for reviews that contain comments Search for reviews that has comment. T : Search only for reviews that contain comments |
| has_ | Search only for reviews that contain attached images Search for reviews that has image attachment. T : Search only for reviews that contain attached images |
| search_ | Target filters writer : Author's name |
| keyword | Filter |
| mileage | Points issuance status Whether points have been issued todo : Not issued |
| limit Min : [1] | Number of fields displayed in list Set the maximum number of search result. DEFAULT 50 |
| offset Min : [0] | Start location of list Set the start location of search result. |
Count all reviews
GET /api/v2/admin/reviews/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| writing_ | Author's ID member ID |
| created_ Date | Date range - Start date Start date when searching for reviews by submission date. Must be used with an end date. |
| created_ Date | Date range - End date End date when searching reviews by submission date. Must be used with a start date. |
| deleted | Review deletion status Whether review is deleted or not. T : Deleted DEFAULT F |
| input_ | Device used for review P : PC |
| has_ | Search only for reviews that contain comments Search for reviews that has comment. T : Search only for reviews that contain comments |
| has_ | Search only for reviews that contain attached images Search for reviews that has image attachment. T : Search only for reviews that contain attached images |
| search_ | Target filters writer : Author's name |
| keyword | Filter |
| mileage | Points issuance status Whether points have been issued todo : Not issued |
Get a review
GET /api/v2/admin/reviews/{review_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ Required | Review no. |
Create a review
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 100 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| writing_ Required | Author's ID Member ID of review writer. |
| product_ Required | Product number System assigned code. This code cannot be duplicated. |
| order_ Order ID | Order number Order number. |
| item_ | Variant code Product Item code for a review. |
| content Required Max Length : [2000] | Content of the review Content of review. |
| rating | Ratings Rating of review. DEFAULT 5 |
| additional_ | Additional field |
| images | Attached image Image that attached at review. |
| input_ | Device used for review P : PC DEFAULT P |
| use_ | Social media shares Whether share review to SNS. T : Shared |
| sales_ | Naver Sales Channel smartstore : Naver smart store |
Update a review
PUT /api/v2/admin/reviews/{review_no}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 100 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ Required | Review no. |
| content Max Length : [2000] | Content of the review |
| rating | Ratings Rating of review. |
| additional_ | Additional field |
| images | Attached image Image that attached at review. |
| use_ | Social media shares Whether share review to SNS. T : Shared |
Delete a review
DELETE /api/v2/admin/reviews/{review_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ Required | Review no. |
Reviews comments
Comments indicate the response of other customers or the shopping mall manager to the review. Comments are embed Resource that belong to reviews.
Reviews comments properties
| Attribute | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages |
| review_ | Review no. |
| comment_ | Comment no. |
| content | Content |
| writer | Author's name |
| nickname | Author’s nickname |
| ip IP | Author’s IP address IP address of review writer. |
| writing_ | Author's ID |
| created_ Date | Written on |
List all reviews comments
GET /api/v2/admin/reviews/{review_no}/comments
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ Required | Review no. |
| limit Min : [1] | Number of fields displayed in list Set the maximum number of search result. DEFAULT 50 |
| offset Min : [0] | Date from which results should be imported Set the start location of search result. |
Get a reviews comment
GET /api/v2/admin/reviews/{review_no}/comments/{comment_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ Required | Review no. |
| comment_ Required | Comment no. |
Create a reviews comment
POST /api/v2/admin/reviews/{review_no}/comments
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 100 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ Required | Review no. |
| writing_ | Author's ID Member ID of review writer. |
| content Required | Content Content of review. |
Update a reviews comment
PUT /api/v2/admin/reviews/{review_no}/comments/{comment_no}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 100 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ Required | Review no. |
| comment_ Required | Comment no. |
| content Required | Content Content of review. |
Delete a reviews comment
DELETE /api/v2/admin/reviews/{review_no}/comments/{comment_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_community |
| Request Limit | 100 |
Request
| Parameter | Description |
|---|---|
| shop_ | Store no. A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| review_ Required | Review no. |
| comment_ Required | Comment no. |
Design
Themes
Themes can be purchased for shopping malls or created by yourself. You can see design of both PC shopping mall and mobile shopping mall design. If you designate a representative design among the designs in the design list, the design of the shopping mall changes to the corresponding design.
Themes properties
| Attribute | Description |
|---|---|
| skin_ Min : [1] | Skin number |
| skin_ | Skin code |
| skin_ Max Length : [100] | Skin name |
| skin_ Max Length : [255] | Skin thumbnail URL |
| usage_ | Usage type S: PC basic skin |
| editor_ | type of editor H: Smart Themes (HTML) |
| parent_ | Parent skin no |
| seller_ | Seller id |
| seller_ | Seller skin code |
| design_ Min : [0] | Design purchase no |
| design_ | Design product code |
| language_ Min Length : [5] | Language code ko_KR: Korean |
| published_ | Current theme number |
| created_ Date | Created date |
| updated_ Date | Updated date |
Count all themes
GET /api/v2/admin/themes/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_design |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| type | Type pc: PC DEFAULT pc |
Get a theme
GET /api/v2/admin/themes/{skin_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_design |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| skin_ Min : [1] | Skin number |
Promotion
Benefits
Benefits allows you to create, read, update, and delete incentives (discounts and gifts) from [Promotions>Incentives] in the Cafe24 store admin.
Benefits properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages using the default store language or other languages |
| benefit_ | number of benefit A unique number assigned to an incentive |
| use_ | whether proceed benefit |
| benefit_ Max Length : [255] | name of benefit |
| benefit_ | type of benefit Whether the incentive is a discount or a gift |
| benefit_ | detail type of benefit Type of incentive |
| use_ | benefit period setting Whether the validity of the incentive has been set |
| benefit_ Date | Benefit start date The date when the incentive becomes valid |
| benefit_ Date | Benefit end date The date when the incentive expires |
| platform_ | coverage of benefit Type of device for which the incentive is applicable (PC, mobile, Plus App) |
| use_ | participation target setting Customer group for which the incentive is applicable. (Both customers and guests, guests only, customers only) |
| customer_ | Customer levels Customer levels eligible for receiving incentives |
| product_ | Product range Products for which the incentive is applicable. |
| use_ | Exclude product tax benefit Specific product categories can be selected so that incentives are not applied to the specific product categories. (Settings may differ depending on the incentive type.) |
| available_ | coverage of coupon Settings for allowing customers to use multiple coupons at once |
| icon_ | Path You can add an icon to a product for which the incentive is applied. |
| created_ timezone | Benefit registration date Date when the incentive was added. |
| period_ | Limited time discount settings Detailed settings for an incentive categorized as time-based discount. It can only be viewed when retrieving details. |
| repurchase_ | re-order discount setting Detailed settings for an incentive categorized as discount for returning customers. It can only be viewed when retrieving details. |
| bulk_ | bundle purchases quantity setting Detailed settings for an incentive categorized as bulk order discount. It can only be viewed when retrieving details. |
| member_ | Customer level-based discount settings Detailed settings for an incentive categorized as customer discount. It can only be viewed when retrieving details. |
| new_ | new product discount setting Detailed settings for an incentive categorized as new product discount. It can only be viewed when retrieving details. |
| shipping_ | Shipping rates discount settings Detailed settings for an incentive categorized as shipping fee discount. It can only be viewed when retrieving details. |
| gift | gift setting Detailed settings for an incentive categorized as gift. It can only be viewed when retrieving details. |
| gift_ | 1+N event setting Detailed settings for an incentive categorized as buy one, get one free. It can only be viewed when retrieving details. |
List all benefits
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| use_ | whether proceed benefit T : proceed |
| benefit_ | name of benefit |
| benefit_ | detail type of benefit Type of benefit. Each type has different benefit. DP : period discount |
| period_ | type of benefit period R : registered date of benefit |
| benefit_ Date | Search Start Date |
| benefit_ Date | Search End Date |
| platform_ | coverage of benefit You can search multiple item with ,(comma) P : PC shopping mall |
| limit Min : [1]~Max : [100] | Limit DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Count all benefits
GET /api/v2/admin/benefits/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| use_ | whether proceed benefit T : proceed |
| benefit_ | name of benefit |
| benefit_ | detail type of benefit Type of benefit. Each type has different benefit. DP : period discount |
| period_ | type of benefit period R : registered date of benefit |
| benefit_ Date | Search Start Date |
| benefit_ Date | Search End Date |
| platform_ | coverage of benefit You can search multiple item with ,(comma) P : PC shopping mall |
Get a benefit
GET /api/v2/admin/benefits/{benefit_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| benefit_ Required | number of benefit A number assigned to an incentive |
Create a benefit
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_promotion |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| use_ Required | whether proceed benefit T : proceed |
| benefit_ Required Max Length : [255] | name of benefit |
| benefit_ Required | type of benefit An incentive can be categorized as discount or gift. D : discount |
| benefit_ Required | detail type of benefit Type of incentive DP : period discount |
| use_ | benefit period setting A period of time during which the incentive will be valid. T: Used |
| benefit_ Date | Benefit start date The date when the incentive becomes valid |
| benefit_ Date | Benefit end date The date when the incentive expires |
| platform_ Required | coverage of benefit Type of device for which the incentive is applicable P : PC shopping mall |
| use_ | participation target setting Customer group for which the incentive is applicable. A: customer and guest |
| customer_ | Customer levels Customer levels eligible for receiving incentives |
| product_ | Product range Products for which the incentive is applicable. A: all products |
| use_ | Exclude product tax benefit Specific product categories can be selected so that incentives are not applied to specific product categories. (Settings may differ depending on the incentive type.) T: Used |
| available_ | coverage of coupon Settings for allowing customers to use multiple coupons at once T : can use every coupon |
| period_ | Limited time discount settings Detailed settings for an incentive categorized as time-based discount. |
| product_list add_category_list except_category_list discount_purchasing_quantity discount_value discount_value_unit discount_truncation_unit discount_truncation_method | |
| gift | gift setting Detailed settings for an incentive categorized as gift. |
| product_list add_category_list offer_only_first first_purchase_type use_unlimited_price purchase_start_price purchase_limit_price gift_product_list Array product_no gift_point max_count | |
| new_ | new product discount setting Detailed settings for an incentive categorized as new product discount. |
| product_list add_category_list except_category_list new_product_date_type new_product_day new_product_term_type discount_purchasing_quantity discount_value discount_value_unit discount_truncation_unit discount_truncation_method | |
| shipping_ | Shipping rates discount settings Detailed settings for an incentive categorized as shipping fee discount. |
| product_list use_purchase_price_condition total_purchase_price include_regional_shipping_rate | |
| gift_ | 1+N event setting Detailed settings for an incentive categorized as buy one, get one free. |
| product_list product_bundle_type product_bundle_count | |
| icon_ | Path You can add an icon to a product for which the incentive is applied. |
Update a benefit
PUT /api/v2/admin/benefits/{benefit_no}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_promotion |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| benefit_ Required | number of benefit A number assigned to an incentive |
| use_ | whether proceed benefit T : proceed |
| benefit_ Max Length : [255] | name of benefit |
| use_ | benefit period setting A period of time during which the incentive will be valid. T: Used |
| benefit_ Date | Benefit start date The date when the incentive becomes valid |
| benefit_ Date | Benefit end date The date when the incentive expires |
| platform_ | coverage of benefit Type of device for which the incentive is applicable P : PC shopping mall |
| use_ | participation target setting Customer group for which the incentive is applicable. A: customer and guest |
| customer_ | Customer levels Customer levels eligible for receiving incentives |
| product_ | Product range Products for which the incentive is applicable. A: all products |
| use_ | Exclude product tax benefit Specific product categories can be selected so that incentives are not applied to specific product categories. (Settings may differ depending on the incentive type.) T: Used |
| available_ | coverage of coupon Settings for allowing customers to use multiple coupons at once T : can use every coupon |
| period_ | Limited time discount settings Detailed settings for an incentive categorized as time-based discount. |
| product_list add_category_list except_category_list discount_purchasing_quantity discount_value discount_value_unit discount_truncation_unit discount_truncation_method | |
| gift | gift setting Detailed settings for an incentive categorized as gift. |
| product_list add_category_list offer_only_first first_purchase_type use_unlimited_price purchase_start_price purchase_limit_price gift_product_list Array product_no gift_point max_count | |
| gift_ | 1+N event setting Detailed settings for an incentive categorized as buy one, get one free. |
| product_list product_bundle_count | |
| new_ | new product discount setting Detailed settings for an incentive categorized as new product discount. |
| product_list add_category_list except_category_list new_product_date_type new_product_day new_product_term_type discount_purchasing_quantity discount_value discount_value_unit discount_truncation_unit discount_truncation_method | |
| shipping_ | Shipping rates discount settings Detailed settings for an incentive categorized as shipping fee discount. |
| product_list use_purchase_price_condition total_purchase_price include_regional_shipping_rate | |
| icon_ | Path You can add an icon to a product for which the incentive is applied. |
Delete a benefit
DELETE /api/v2/admin/benefits/{benefit_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| benefit_ Required | number of benefit A number assigned to an incentive |
Coupons
Coupons is the benefits that can be issued to members of a shopping mall to discount the price of a product or to get a discount on shipping fees. Coupons can be used to promote (promote) shopping malls and can be issued to members in various forms.
Coupons properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| coupon_ | Coupon number |
| coupon_ | Coupon type Type of coupon. There are Online and Offline serial type of coupon. O: Online coupon |
| coupon_ | Coupon name Name of coupon |
| coupon_ | Coupon description Description of coupon |
| created_ timezone | Created date Date of coupon created |
| deleted | Whether coupon is deleted Whether coupon is deleted or not T: Deleted |
| is_ | Whether coupon is deleted and deactivated Whether coupon is deleted and deactivated completely. Issued coupon is no longer available when coupon completely deactivated and deleted. T: completely deleted and deactivated |
| pause_ timezone | Coupon pause start date Coupon issue pause began date. Coupon cannot be issued while pause. |
| pause_ timezone | Coupon pause end date Coupon issue pause end date. Coupon cannot be issued while pause. |
| benefit_ | Display the coupon benefits details Displays detailed information of coupon's benefits. |
| benefit_ | Benefit type Type of benefit. Each type has different benefit. |
| benefit_ | Benefit amount Amount of discount benefit |
| benefit_ | Benefit ratio Amount of percentage of discount benefit |
| benefit_ | Benefit percentage cutoff unit Cutoff unit for the amount of discount benefit |
| benefit_ | Maximum benefit ratio Maximum price amount for discount benefit |
| include_ | Regional shipping flag Whether include regional shipping price when discount shipping price. T: Include category by region DEFAULT F |
| include_ | Shipping abroad flag Whether include overseas shipping for coupon benefit. T: Overseas delivery included DEFAULT F |
| coupon_ | Direct access url URL for direct access to the coupon. |
| issue_ | Issue type Issue type of coupon. |
| issue_ | Detailed issue type Detailed issue type of coupon. M: For members |
| issue_ | Welcome flag Whether the coupon issued when signed up. T: issued DEFAULT F |
| issue_ | Recommended id Whether the coupon issued to recommended ID. T: issued DEFAULT F |
| issue_ | Welcome customer flag Whether the customer is type for receive welcome coupon. A: SMS acceptance and e-mail acceptance |
| issue_ | Discount standard amount Standard for discount of coupon. O: Based on the purchase amount |
| issue_ timezone | Order start date |
| issue_ timezone | Order end date |
| issue_ | Limit type for order amount You may set the limit for the order amount for issuing coupon. U: unlimited |
| issue_ | Minimum order amount You may set the minimum amount for the order amount for issuing coupon. |
| issue_ | Maximum order amount You may set the maximum amount for the order amount for issuing coupon. |
| issue_ | Available order path Whether coupons are available on PC store, mobile store, or Plus App W: Only for Web shopping mall |
| issue_ | Issue unit Issue unit for coupon. O: Coupon issued by order form |
| issue_ | Issue object product Object product for issuing coupon. U: No restrictions |
| issue_ | Issue object category Object category for issuing coupon. U: No restrictions |
| issue_ | Issue Anniversary Type Object anniversary type for issuing coupon. B: Birthday |
| issue_ | Preissuance dates for anniversary to issue Date for how long anniversary coupon can be issued in advance. |
| issue_ | Module type Module type for the type of module install condition coupon. S: Shortcut |
| issue_ | Number of product reviews to issue Necessary number of reviews for issuing coupon. |
| issue_ | Whether to include product review images to issue Whether the review must includes image when issuing coupon. T: Included DEFAULT F |
| issue_ | Minimum purchase quantity for coupon issuance You may set the minimum volume for the order for issuing coupon. |
| issue_ | Discount standard volume Volume standard for discount of coupon. P: Based on product quantity |
| issue_ | Maximum Issue Count Maximum issue availbale quantity of coupon. |
| issue_ | Maximum Issue Count per user Maximum issue availablequ antity for the same customer |
| issue_ | Each coupon issuance quantity (for one time) Quantity for each coupon issue. |
| issued_ | Issued count Count the number of the specific coupon issued. |
| issue_ | Issue Member Group Number Number of group object for issuing coupon. |
| issue_ | Issue Member Group Name Name of group object for issuing coupon. |
| issue_ | Non-purchase condition period Period of non-purchase when coupon's condition is non-purchase for certain term. |
| issue_ | Issue reservation Whether use the function of coupon issue reservation. The reserved coupon will be issued automatically. T: use automatic issue reservation DEFAULT F |
| issue_ timezone | Reservation time Reservation time for reserved coupon issue. |
| available_ | Available date Available date for coupons useage. |
| available_ | Available date type Type of available date for coupons useage. |
| available_ timezone | Available start date Start date of coupon usage. |
| available_ timezone | Available end date End date of coupon usage. |
| available_ Required | Available Site Whether coupons are available on PC store, mobile store, or Plus App |
| available_ | Available scope Coupon available scope. 'Product coupon' applicable single product. 'Order coupon' applicable order. |
| available_ | Available day Days for how long the coupon is available. |
| available_ | Available price type Criteria of coupon availble price amount. Multiply the number of product and price is the coupon criteria if the coupon is applicable to product price. Total amount including shipping and other discount will be the coupon criteria if the coupon is applicable to order price. U: No restrictions |
| available_ | minimum purchase amount is based on U: subtotal (before discount) of all products |
| available_ | Available price Coupon avilable purchase amount. |
| available_ | Available Amount Type Amount of price to apply coupon. Whether apply coupon discount before other discount(such as membership or product discount) or after discount of other discount method. |
| available_ | Available payment method Coupon applicable payment method. all: no restrictions |
| available_ | Applicable product You may choose coupon applicable product. Either exclude specific product from the applicable list or include every product in the list. |
| available_ | List of coupon-applied products |
| available_ | Applicable category You may choose coupon applicable category. Either exclude specific category from the applicable list or include every category in the list. |
| available_ | List of coupon-applied categories |
| available_ | Max number per order Maximum available number of coupon per single order. |
| serial_ | Serial generate method Serial coupon generate method. A: automatically |
| coupon_ | Coupon image type Image type of coupon. B: Use the default image. |
| coupon_ | Coupon image path URL of coupon image. |
| show_ | Whether to expose the product details page Whether displays coupon at product detail page. T: Product details exposed DEFAULT F |
| use_ | Whether to use the coupon issuance alarm during the log-in Whether use coupon issue notification when customer login. T: use notification DEFAULT F |
| send_ | Whether to send SMS of coupon issuance Whether send a coupon issue information by SMS. T: send SMS DEFAULT F |
| send_ | Whether to send the coupon issuance information via e-mail Whether send a coupon issue information by E-mail. T: send Email DEFAULT F |
| discount_ | Discount amount |
| discount_ | Discount rate |
List all coupons
GET
You can only retrieve coupons that are currently available with "List coupons" API (GET:/coupons). (Coupons that have expired cannot be retrieved.)
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| coupon_ | Coupon number |
| coupon_ | Coupon type O: Online coupon |
| coupon_ | Coupon name |
| benefit_ | Benefit type Type of benefit. Each type has different benefit. You can search multiple item with ,(comma) A: discount by amount |
| issue_ | Issue type Issue type of coupon. You can search multiple item with ,(comma) M: Issuance to target person |
| issue_ | Detailed issue type Types of coupon issuance M: For members |
| issued_ | Issued flag Whether or not the coupon has been issued before T: has been issued before |
| created_ Date | Search Start Date Search for coupons added after the search start date. Must be used with a search end date. |
| created_ Date | Search End Date Search for coupons that created before certain date. |
| deleted | Whether coupon is deleted Whether or not the coupon has been deleted You can search multiple item with ,(comma) T: deleted DEFAULT F |
| pause_ Date | Coupon pause start date Search start date, for coupons that based on coupon pause date. |
| pause_ Date | Coupon pause end date Search end date, for coupons that based on coupon pause date. |
| issue_ | Available order path Whether coupons are available on PC store, mobile store, or Plus App W: PC |
| issue_ | Issue unit Whether coupon issued based on product or order. P: Product coupon |
| issue_ | Issue reservation Whether use the function of coupon issue reservation. The reserved coupon will be issued automatically. T: use automatic issue reservation |
| available_ | Available date type Type of available date for coupons useage. You can search multiple item with ,(comma) F: General period |
| available_ Date | Available datetime Search for coupon that issue available at certain date. Valid only if available_period_type is F |
| available_ | Available Site Whether coupons are available on PC store, mobile store, or Plus App W: Only for Web shopping mall |
| available_ | Available scope Coupon available scope. 'Product coupon' applicable single product. 'Order coupon' applicable order. P: Product coupon |
| available_ | Available price type Criteria of coupon availble price amount. Whether the coupon is applicable to product price or order pricr or no restriction. U: No restrictions |
| available_ | minimum purchase amount is based on U: subtotal (before discount) of all products |
| limit Min : [1]~Max : [500] | Limit Set the maximum number of search result. DEFAULT 100 |
| offset Max : [8000] | Start location of list |
Count all coupons
GET /api/v2/admin/coupons/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| coupon_ | Coupon number |
| coupon_ | Coupon type Type of the coupon you want to retrieve O: Online coupon |
| coupon_ | Coupon name |
| benefit_ | Benefit type Types of discounts and rewards from coupons You can search multiple item with ,(comma) A: discount by amount |
| issue_ | Issue type Types of coupon issuance You can search multiple item with ,(comma) M: Issuance to target person |
| issue_ | Detailed issue type Types of coupons that are automatically issued M: For members |
| issued_ | Issued flag Whether or not the coupon has been issued before T: has been issued before |
| created_ Date | Search Start Date Start date for searching for coupons by issuance date. |
| created_ Date | Search End Date Search end date when searching coupons by issuance date. |
| deleted | Whether coupon is deleted Whether or not the coupon is deleted You can search multiple item with ,(comma) T: deleted DEFAULT F |
| pause_ Date | Coupon pause start date The date when coupon issuance begins to be suspended |
| pause_ Date | Coupon pause end date The date when coupons begin to be re-issued |
| issue_ | Available order path Whether coupons are available on PC store, mobile store, or Plus App W: PC |
| issue_ | Issue unit P: Product coupon |
| issue_ | Issue reservation T: use automatic issue reservation |
| available_ | Available date type Types of coupon validity You can search multiple item with ,(comma) F: General period |
| available_ Date | Available datetime Search for coupons that can be issued on the specified date. Valid only if available_period_type is F |
| available_ | Available Site Whether coupons are available on PC store, mobile store, or Plus App W: Only for Web shopping mall |
| available_ | Available scope Whether the coupon type is Product coupon or Checkout coupon P: Product coupon |
| available_ | Available price type Whether no restrictions are applied to the minimum purchase amount or it is based on subtotal (before discount)/product subtotal U: No restrictions |
| available_ | minimum purchase amount is based on U: subtotal (before discount) of all products |
Create a coupon
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_promotion |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| coupon_ Required Length Min : [1]~Max : [50] | Coupon name |
| benefit_ Required | Benefit type A: discount amount |
| issue_ Required | Issue type M: issue coupons to specified customers |
| available_ Required | Available date type F: General period |
| available_ Date | Available start date |
| available_ Date | Available end date |
| available_ Min : [1] | Available day |
| available_ Required | Available Site W: for online stores only |
| available_ Required | Available scope P: Product coupon |
| available_ Required | Applicable product U: No restrictions |
| available_ | List of coupon-applied products |
| available_ Required | Applicable category U: No restrictions |
| available_ | List of coupon-applied categories |
| available_ Required | Available Amount Type E: Payment before discount (except coupon) is applied |
| available_ Required Min : [1] | Max number per order |
| available_ | Available price type U: No restrictions DEFAULT U |
| available_ | minimum purchase amount is based on U: subtotal (before discount) of all products |
| available_ Min : [0.01]~Max : [999999999] | Available price |
| discount_ | Discount amount |
| benefit_price | |
| discount_ | Discount rate |
| benefit_percentage benefit_percentage_round_unit benefit_percentage_max_price | |
Coupons issues
Coupons issues properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| coupon_ | Coupon number |
| issue_ | coupon issuance code |
| member_ | Member id |
| group_ | Issue Member Group Number |
| issued_ timezone | Issued on |
| expiration_ timezone | service expiration date |
| used_ | Status |
| used_ timezone | Used on |
| related_ | Related order number |
| count | Coupons Issued count |
List all coupons issues
GET /api/v2/admin/coupons/{coupon_no}/issues
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| coupon_ Required | Coupon number |
| member_ Max Length : [20] | Member id |
| group_ | Group number |
| issued_ Date | Issued on |
| issued_ Date | Search Start Date |
| issued_ Date | Search End Date |
| used_ | Status T: Used |
| since_ | Search for history after this coupon issuance code |
| limit Max : [500] | Limit DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Create a coupons issues
POST /api/v2/admin/coupons/{coupon_no}/issues
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_promotion |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| coupon_ Required | Coupon number |
| issued_ Required | Issue member scope A: for every customer |
| group_ | Group number |
| member_ | Member id |
| send_ | Whether to send SMS of coupon issuance This cannot be used on Cafe24 Japan, Vietnam, Philippines. T: send SMS DEFAULT F |
| allow_ | Allow duplication T: Issued DEFAULT F |
| single_ | Single issue per once T: Issued one by one DEFAULT T |
| issue_ Min : [2] | Issue count per once DEFAULT 2 |
| issued_ | Issued Place Type W: Web |
| issued_ | Issued action type INSTALLATION: Coupon issuance when installing the app |
| issued_ | Issued By Event Type C: Attendance check event |
| request_ | Request admin id |
Customers coupons
Customers coupons properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| coupon_ | Coupon number |
| issue_ | coupon issuance code |
| coupon_ | Coupon name |
| available_ | Available price type U: No restrictions |
| available_ | Types of purchase amount eligible for coupon use U: order amount of all products |
| available_ | Available price |
| available_ | Available payment method all: no restrictions |
| benefit_ | Benefit type A: discount |
| benefit_ | Benefit amount |
| benefit_ | Benefit ratio |
| benefit_ | Benefit percentage cutoff unit |
| benefit_ | Maximum benefit ratio |
| credit_ | Instant reward (credits) |
| issued_ timezone | Issued on |
| available_ timezone | Available start date |
| available_ timezone | Available end date |
List all customers coupons
GET /api/v2/admin/customers/{member_id}/coupons
GET
Coupons that are available for use by the customer will be retrieved.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| member_ Required | Member id |
| offset Max : [10000] | Start location of list |
| limit Min : [1]~Max : [100] | Limit DEFAULT 10 |
Count all customers coupons
GET /api/v2/admin/customers/{member_id}/coupons/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| member_ Required | Member id |
Delete a customers coupon
DELETE /api/v2/admin/customers/{member_id}/coupons/{coupon_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_promotion |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| member_ Required | Member id |
| coupon_ Required | Coupon number |
| issue_ | coupon issuance code |
Application
Apps
Endpoints
Appstore orders
With Cafe24 Store order creation API, you can create an Cafe24 Store order to ask store admins to pay
Appstore orders properties
| Attribute | Description |
|---|---|
| order_ | Order ID Order ID of an order placed at Cafe24 Store It can only be viewed when retrieving details. |
| order_ | Order Name Name of the order. You can type it in when creating an order. It should be a name that indicates what has been purchased when the store admin makes a payment. It can only be viewed when retrieving details. |
| order_ | Order Amount Order amount you ask the store admin to pay when creating an order It can only be viewed when retrieving details. |
| currency | Currency It can only be viewed when retrieving details. KRW: Korean won (￦) |
| return_ | Return Url Page to which the store admin is directed after making a payment It can only be viewed when retrieving details. |
| automatic_ Max Length : [1] | Automatic payments status It can only be viewed when retrieving details. T: Use |
| created_ timezone | Order Created Date e.g. 2018-12-31 23:59:59 It can only be viewed when retrieving details. |
| confirmation_ | Payment URL URL to which the store admin is automatically directed to make a payment |
Get an appstore order
GET /api/v2/admin/appstore/orders/{order_id}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_application |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| order_ | Order ID App store order number to get |
Create an appstore order
POST /api/v2/admin/appstore/orders
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_application |
| Request Limit | 10 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| order_ Required Max Length : [100] | Order Name The name of the order in the App store order. The order can be specified when creating the order, and it must be what the user can know about the contents of the payment. |
| order_ Required | Order Amount Enter the amount of the order you want to user pay |
| return_ Required Max Length : [250] | Return URL The page that redirects a user automatically to after payment. Enter the Thank you page URL. |
| automatic_ Max Length : [1] | Automatic payments status T: Use DEFAULT F |
Appstore payments
Once a payment has been made for a Cafe24 Store order, you can read the payment details with Appstore payments properties.
Appstore payments properties
| Attribute | Description |
|---|---|
| order_ | Order ID Order ID of an order placed at Cafe24 Store |
| payment_ | payment status paid : complete payment |
| title | Payment name Name of the order. You can type it in when creating an order. It should be a name that indicates what has been purchased when the store admin makes a payment. |
| approval_ | Approval Number Payment approval number |
| payment_ | Payment Gateway Number |
| payment_ | Payment Method |
| payment_ | Payment Amount |
| refund_ | refund amount |
| currency | Currency KRW: Korean won (￦) |
| locale_ | Billing Country |
| automatic_ | Automatic payments status T: Use |
| pay_ timezone | Payment Approval Date |
| refund_ timezone | date of refund approval |
| expiration_ timezone | Expiration date |
List all appstore payments
GET /api/v2/admin/appstore/payments
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_application |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| order_ | Order ID App store order number to get You can search multiple item with ,(comma) |
| start_ Required Date | Search Start Date Search for paid orders after the search start date |
| end_ Required Date | Search End Date Search for orders that have been paid before the date |
| currency | Currency KRW: Korean won (￦) |
| limit Min : [1]~Max : [50] | Limit Set the maximum number of search result. DEFAULT 20 |
| offset Max : [10000] | Start location of list |
Count all appstore payments
GET /api/v2/admin/appstore/payments/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_application |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| order_ | Order ID Order number to search for in Cafe24 Store You can search multiple item with ,(comma) |
| start_ Required Date | Search Start Date Search for paid orders after the start date |
| end_ Required Date | Search End Date You can search for orders that have been paid for before the specified date |
| currency | Currency KRW: Korean won (￦) |
Scripttags
The script API allows you to install remotely located scripts on a specific page of the mall. The script API makes it easy to add function to the mall without changing the design of the mall.
Scripttags properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| script_ | Unique number of script A unique number assigned to a script |
| client_ | Client ID Client ID that installed script. |
| src URL | Original script path Original path of script which to be installed |
| display_ | Screen path "Path of screen display" to display Script. "Path of screen display" represents specific role of each page. |
| exclude_ | excluded path |
| skin_ | Skin number Skin number that wants to be applied scripttags. |
| integrity | subresource integrity |
| created_ timezone | Created date Date of installed script |
| updated_ timezone | Updated date Date of modified script |
List all scripttags
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_application |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| script_ | Unique number of script A unique number assigned to a script |
| src URL | Original script path Search for the path of original script. |
| display_ | Screen path "Path of screen display" to display Script. "Path of screen display" represents specific role of each page. You can search multiple item with ,(comma) |
| exclude_ | excluded path You can search multiple item with ,(comma) |
| skin_ | Skin number Skin number that wants to be applied scripttags. You can search multiple item with ,(comma) |
| integrity | subresource integrity |
| created_ Date | Script installation date search start date Search for scripts installed after the start date. Must be used with a search end date. |
| created_ Date | Script installation date search end date Search for script that installed date is before a certain date. |
| updated_ Date | Script modification date search start date Search for scripts edited after the start date. Must be used with a search end date. |
| updated_ Date | Script modification date search end date Search for scripts edited before the end date. Must be used with a search start date. |
Count all scripttags
GET /api/v2/admin/scripttags/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_application |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| script_ | Unique number of script A unique number assigned to a script |
| src URL | Original script path Search for the path of original script. |
| display_ | Screen path "Path of screen display" to display Script. "Path of screen display" represents specific role of each page. |
| skin_ | Skin number Skin number that wants to be applied scripttags. You can search multiple item with ,(comma) |
| created_ Date | Script installation date search start date Search for scripts installed after the start date. Must be used with a search end date. |
| created_ Date | Script installation date search end date Search for script that installed date is before a certain date. |
| updated_ Date | Script modification date search start date Search for scripts edited after the start date. Must be used with a search end date. |
| updated_ Date | Script modification date search end date Search for script that modified date is before a certain date. |
Get a scripttag
GET /api/v2/admin/scripttags/{script_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_application |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| script_ | Unique number of script A unique number assigned to a script |
Create a scripttag
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_application |
| Request Limit | 10 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| src URL | Original script path Original path of script which to be installed |
| display_ Required | Screen path "Path of screen display" to display Script. "Path of screen display" represents specific role of each page. |
| exclude_ | excluded path |
| skin_ | Skin number Skin number that wants to be applied scripttags. |
| integrity | subresource integrity |
Update a scripttag
PUT /api/v2/admin/scripttags/{script_no}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_application |
| Request Limit | 10 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| script_ Required | Unique number of script A unique number assigned to a script |
| src URL | Original script path Original path of script which to be installed |
| display_ | Screen path "Path of screen display" to display Script. "Path of screen display" represents specific role of each page. |
| exclude_ | excluded path |
| skin_ | Skin number Skin number that wants to be applied scripttags. |
| integrity | subresource integrity |
Delete a scripttag
DELETE /api/v2/admin/scripttags/{script_no}
DELETE
※ If you want to delete by multiple shopping mall, you can add "?Shop_no=N" parameter after end point.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_application |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| script_ Required | Unique number of script A unique number assigned to a script |
Category
Autodisplay
Autodisplay properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| display_ | auto layout number |
| use_ | Displayed on home page T: yes |
| category_ | Category number |
| display_ | detailed product category |
| display_ Min : [1]~Max : [200] | maximum quantity per auto layout |
| use_ | schedule layout T: yes |
| start_ timezone | start date |
| use_ | use hashtag T: yes |
| hash_ | hashtag |
| display_ | sorting order AOD: no. orders (high-low) |
| timetable Array Max : [24] | update frequency |
| period | date range for data collection 1: 1 day |
| except_ | Excluded categories A: Exclude from all categories |
| except_ | Exceptions category |
Create an autodisplay
POST /api/v2/admin/autodisplay
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_category |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| use_ Required | Displayed on home page T: yes |
| category_ Required | Category number |
| display_ Required | detailed product category |
| display_ Required Min : [1]~Max : [200] | maximum quantity per auto layout |
| use_ Required | schedule layout T: yes |
| start_ timezone | start date |
| use_ Required | use hashtag T: yes |
| hash_ | hashtag |
| display_ | sorting order AOD: no. orders (high-low) |
| timetable Array Max : [24] | update frequency |
| period | date range for data collection 1: 1 day |
| except_ | Excluded categories A: Exclude from all categories DEFAULT A |
| except_ | Exceptions category |
Update an autodisplay
PUT /api/v2/admin/autodisplay/{display_no}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_category |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| display_ Required | auto layout number |
| display_ Min : [1]~Max : [200] | maximum quantity per auto layout |
| use_ | schedule layout T: yes |
| start_ timezone | start date |
| use_ | use hashtag T: yes |
| hash_ | hashtag |
| display_ | sorting order AOD: no. orders (high-low) |
| timetable Array Max : [24] | update frequency |
| period | date range for data collection 1: 1 day |
| except_ | Excluded categories A: Exclude from all categories |
| except_ | Exceptions category |
Delete an autodisplay
DELETE /api/v2/admin/autodisplay/{display_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_category |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| display_ Required | auto layout number |
Categories
Categories allow the admin to display or categorize products in a way that customers can easily find them. You must display products in at least one category to sell them. One product can be displayed in multiple categories.
Categories properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| category_ | Category number A unique identifier assigned to a product category. It cannot be used for more than one product category. |
| category_ Min : [1]~Max : [4] | Category depth Depth of the product category. There are four product category depths. |
| parent_ | Parent Category Number The category number of the parent category when the category is either 2 depth (subcategory 1), 3 depth (subcategory 2), or 4 depth (subcategory 3) category. |
| category_ Max Length : [50] | Category name Name of the product category |
| display_ | Display setting Whether the product category is displayed either on the PC store, mobile store, or on both stores. A: PC + Mobile |
| full_ | Full Category Name The names of all parent categories to which the product category belongs. |
| full_ | Full Category Number This shows the category numbers of all parent categories that the current category belongs to. |
| root_ | Top category number The category number of the main category to which the category belongs |
| use_ | Main classification display status Whether or not the product category is displayed on the main page. If it is, [True], the product category is displayed as a home category even if it is subcategory 1, 2, or 3. T: Displayed |
| use_ | Display status Whether or not the product category is displayed. If it is “FALSE,” customers cannot access the product category. All multi-language stores must have the same settings. T: Displayed |
| display_ | Display order The order in which the admin has placed product categories |
| soldout_ | Sold-out product display status It shows whether out-of-stock products are displayed at the top or at the bottom. You can check whether a product is sold-out via “sold-out” parameter in “List all products.” B: Arranged out-of-stock items to the back |
| sub_ | Sub-category Product display status Whether to display products in both the current category and its sub-categories. T: Display |
| hashtag_ | Hashtag based product display Whether or not to use “Hashtag-based product display”. T: Display |
| hash_ | Hashtag The list of hashtags in the current category. |
| product_ | Category display scope This determines whether the common product layout settings are applied to all product categories or different settings by section. If it is set as [Apply common settings to all products], you can change the sort settings with the following parameters: A: All |
| product_ | Category display method The sorting method for the current category when [Product layout settings] is set as “Apply common settings to all categories.” A: Automatic arrangement |
| product_ | Category display key The sorting criteria for the current category when [Product layout settings] is set as “Apply common settings to all categories” and the sorting method as “Automatic sorting” or “Automatic + Custom.” A: Recently added product |
| product_ | Category display order Settings for sorting products in ascending or descending order D: Descending order |
| product_ | Category display period The period during which sales or views are counted when sorting products by “Sales(S)” or “Views(C)” in descending order W: Total period |
| normal_ | Category display method The sorting method for [Products] when [Product layout settings] is set as “Apply different settings by section.” A: Automatic arrangement |
| normal_ | Category display key The sorting criteria for [Products] when [Product layout settings] is set as “Apply different settings by section” A: Recently added product |
| normal_ | Category display order Settings for sorting products in [Products] in ascending or descending order D: Descending order |
| normal_ | Category display period The period during which sales or views are counted when sorting products in [Products] by “Sales(S)” or “Views(C)” in descending order W: Total period |
| recommend_ | Category display method The sorting method for [Recommended products] when [Product layout settings] is set as “Apply different settings by section.” A: Automatic arrangement |
| recommend_ | Category display key The sorting criteria for [Recommended products] when [Product layout settings] is set as “Apply different settings by section” A: Recently added product |
| recommend_ | Category display order Settings for sorting products in [Recommended products] in ascending or descending order D: Descending order |
| recommend_ | Category display period The period during which sales or views are counted when sorting products in [Recommended roducts] by “Sales(S)” or “Views(C)” in descending order W: Total period |
| new_ | Category display method The sorting method for [New products] when [Product layout settings] is set as “Apply different settings by section.” A: Automatic arrangement |
| new_ | Category display key The sorting criteria for [New products] when [Product layout settings] is set as “Apply different settings by section” A: Recently added product |
| new_ | Category display order Settings for sorting products in [New products] in ascending or descending order D: Descending order |
| new_ | Category display period The period during which sales or views are counted when sorting products in [New roducts] by “Sales(S)” or “Views(C)” in descending order W: Total period |
| access_ | permission to access F : for everyone |
List all categories
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_category |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| category_ Min : [1]~Max : [4] | Category depth Search for the depth of the category you want to retrieve |
| category_ | Category number Category number of the category you want to read |
| parent_ | Parent Category Number Search for the number of parent category which targeting product category belongs. |
| category_ | Category name Search for product categories of which names include the search query that you enter. The search query is case-insensitive. |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list Set the start location of search result. |
Count all categories
GET /api/v2/admin/categories/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_category |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| category_ Min : [1]~Max : [4] | Category depth Search for the category that you want to retrieve with its category depth. |
| category_ | Category number Category number of the category you want to read |
| parent_ | Parent Category Number You can search for the category with its parent category number. |
| category_ | Category name Search for product categories of which names include the search query that you enter. The search query is case-insensitive. |
Get a category
GET /api/v2/admin/categories/{category_no}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_category |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| category_ Required | Category number Category number of the category you want to read |
Create a category
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_category |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| parent_ | Parent Category Number If you want to register a category in a specific category, you can register it by entering the parent category number. |
| category_ Required Max Length : [50] | Category name The name of the category |
| display_ | Display setting Whether the product category is displayed on either the PC store, mobile store, or on both stores. A: PC + Mobile |
| use_ | Main classification display status Whether or not the product category is displayed on the main page. If it is, [True], the product category is displayed as a home category even if it is subcategory 1, 2, or 3. T: Displayed |
| use_ | Display status Whether the product category is displayed or not. The product category will not accessible when 'FALSE'. T: Displayed |
| soldout_ | Sold-out product display status Whether to display out-of-stock products at the top or bottom of the category. B: Arranged out-of-stock items to the back |
| sub_ | Sub-category Product display status Whether to display products that are displayed in the sub-category T: Display |
| hashtag_ | Hashtag based product display Whether use or not use hashtag based product display. T: Display |
| hash_ | Hashtag Hashtags of the category. |
| product_ | Category display scope Whether to sort products by category or sort by area A: All |
| product_ | Category display method If category display scope is "all", category display method. A: Automatic arrangement |
| product_ | Category display key If category display scope is "all" and category display method is "auto align" or "auto align + manual align", the sort key of category display. A: Recently added product |
| product_ | Category display order Whether category display is ascending or descending. D: Descending order |
| product_ | Category display period If category display key is "By sales (S)" or "By hits count(C)", the period for category display. W: Total period |
| normal_ | Category display method If category display scope is "By area", category display method in normal product area. A: Automatic arrangement |
| normal_ | Category display key If category display scope is "By area" and category display method is "auto align" or "auto align + manual align", the sort key of category display in normal product area. A: Recently added product |
| normal_ | Category display order Whether category display in normal product area is ascending or descending. D: Descending order |
| normal_ | Category display period If category display key is "By sales (S)" or "By hits count(C)", the period for category display. W: Total period |
| recommend_ | Category display method If category display scope is "By area", category display method by recommend product area. A: Automatic arrangement |
| recommend_ | Category display key If category display scope is "all" and category display method is "auto align" or "auto align + manual align", the sort key of category display. A: Recently added product |
| recommend_ | Category display order Whether category display is ascending or descending. D: Descending order |
| recommend_ | Category display period If category display key is "By sales (S)" or "By hits count(C)", the period for category display. W: Total period |
| new_ | Category display method If category display scope is "all", category display method. A: Automatic arrangement |
| new_ | Category display key If category display scope is "all" and category display method is "auto align" or "auto align + manual align", the sort key of category display. A: Recently added product |
| new_ | Category display order Whether category display is ascending or descending. D: Descending order |
| new_ | Category display period If category display key is "By sales (S)" or "By hits count(C)", the period for category display. W: Total period |
Update a category
PUT /api/v2/admin/categories/{category_no}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_category |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| category_ Required | Category number |
| category_ Max Length : [50] | Category name The name of the category |
| display_ | Display setting Whether the product category is displayed either on the PC store, mobile store, or on both stores. A: PC + Mobile |
| use_ | Main classification display status Whether or not the product category is displayed on the main page. If it is, [True], the product category is displayed as a home category even if it is subcategory 1, 2, or 3. T: Displayed |
| use_ | Display status Whether the product category is displayed or not. The product category will not accessible when 'FALSE'. T: Displayed |
| soldout_ | Sold-out product display status Whether to display out-of-stock products at the top or bottom of the category. B: Arranged out-of-stock items to the back |
| sub_ | Sub-category Product display status Whether to display products that are displayed in the sub-category T: Display |
| hashtag_ | Hashtag based product display Whether use or not use hashtag based product display. T: Display |
| hash_ | Hashtag Hashtags of the category. |
| product_ | Category display scope Whether to sort products by category or sort by area A: All |
| product_ | Category display method If category display scope is "all", category display method. A: Automatic arrangement |
| product_ | Category display key If category display scope is "all" and category display method is "auto align" or "auto align + manual align", the sort key of category display. A: Recently added product |
| product_ | Category display order Whether category display is ascending or descending. D: Descending order |
| product_ | Category display period If category display key is "By sales (S)" or "By hits count(C)", the period for category display. W: Total period |
| normal_ | Category display method If category display scope is "By area", category display method in normal product area. A: Automatic arrangement |
| normal_ | Category display key If category display scope is "By area" and category display method is "auto align" or "auto align + manual align", the sort key of category display in normal product area. A: Recently added product |
| normal_ | Category display order Whether category display in normal product area is ascending or descending. D: Descending order |
| normal_ | Category display period If category display key is "By sales (S)" or "By hits count(C)", the period for category display. W: Total period |
| recommend_ | Category display method If category display scope is "By area", category display method by recommend product area. A: Automatic arrangement |
| recommend_ | Category display key If category display scope is "all" and category display method is "auto align" or "auto align + manual align", the sort key of category display. A: Recently added product |
| recommend_ | Category display order Whether category display is ascending or descending. D: Descending order |
| recommend_ | Category display period If category display key is "By sales (S)" or "By hits count(C)", the period for category display. W: Total period |
| new_ | Category display method If category display scope is "all", category display method. A: Automatic arrangement |
| new_ | Category display key If category display scope is "all" and category display method is "auto align" or "auto align + manual align", the sort key of category display. A: Recently added product |
| new_ | Category display order Whether category display is ascending or descending. D: Descending order |
| new_ | Category display period If category display key is "By sales (S)" or "By hits count(C)", the period for category display. W: Total period |
Delete a category
DELETE /api/v2/admin/categories/{category_no}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_category |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| category_ Required | Category number |
Categories decorationimages
Categories decorationimages properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| category_ | Category number |
| use_ | menu image settings for PC store T: Used |
| menu_ | default menu image for PC store |
| menu_ | overlay menu image for PC store |
| use_ | header image settings for PC store T: Used |
| top_ | header image for PC store |
| use_ | headline image settings for PC store T: Used |
| title_ | headline image for PC store |
| use_ | menu image settings for mobile store T: Used |
| menu_ | default menu image for mobile store |
| use_ | header image settings for mobile store T: Used |
| top_ Array Max : [3] | header image for mobile store |
| use_ | headline image settings for mobile store T: Used |
| title_ | headline image for mobile store |
List all categories decoration images
GET /api/v2/admin/categories/{category_no}/decorationimages
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_category |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| category_ Required | Category number |
Update a categories decorationimage
PUT /api/v2/admin/categories/{category_no}/decorationimages
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_category |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| category_ Required | Category number |
| use_ | menu image settings for PC store T: Used |
| menu_ | default menu image for PC store |
| menu_ | overlay menu image for PC store |
| use_ | header image settings for PC store T: Used |
| top_ Array Max : [3] | header image for PC store |
| use_ | headline image settings for PC store T: Used |
| title_ | headline image for PC store |
| use_ | menu image settings for mobile store T: Used |
| menu_ | default menu image for mobile store |
| use_ | header image settings for mobile store T: Used |
| top_ Array Max : [3] | header image for mobile store |
| use_ | headline image settings for mobile store T: Used |
| title_ | headline image for mobile store |
Categories seo
Categories seo properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| category_ | Category number |
| search_ | exposure setting for search engine T: Use |
| meta_ | Browser title |
| meta_ | Meta tag 1: Author |
| meta_ | Meta tag 2: Description |
| meta_ | Meta tag 3: Keywords |
List all categories seo
GET /api/v2/admin/categories/{category_no}/seo
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_category |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| category_ Required | Category number |
Update a categories seo
PUT /api/v2/admin/categories/{category_no}/seo
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_category |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| category_ Required | Category number |
| search_ | exposure setting for search engine T: Use |
| meta_ | Browser title |
| meta_ | Meta tag 1: Author |
| meta_ | Meta tag 2: Description |
| meta_ | Meta tag 3: Keywords |
Mains
The main category (Mains) is a product category that can display products of the shopping mall on the main screen.
Endpoints
Mains properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| module_ | Module code The module code assigned main display group |
| display_ | main category number |
| group_ | Group Name Category name defined when main categories were created |
| soldout_ | Sold-out product display status The display location of sold out products. B: Arranged out-of-stock items to the back |
Collection
Brands
Brands refer to data entered in [Production information>Brand]. You can search products by brand and eveery product must be assigned to a brand (automatically assigned to “private brand” when unassigned.)
Brands properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| brand_ | Brand code |
| brand_ Max Length : [50] | Brand name |
| use_ | whether to use a brand Whether the brand is being used T: Use |
| search_ Max Length : [200] | Search keyword |
| product_ | Product count Number of products |
| created_ timezone | Created date |
List all brands
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| brand_ | Brand code You can search multiple item with ,(comma) |
| brand_ | Brand name You can search multiple item with ,(comma) |
| use_ | whether to use a brand T: Use |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Count all brands
GET /api/v2/admin/brands/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| brand_ | Brand code You can search multiple item with ,(comma) |
| brand_ | Brand name You can search multiple item with ,(comma) |
| use_ | whether to use a brand T: Use |
Create a brand
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_collection |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| brand_ Required | Brand name |
| use_ | whether to use a brand T: Use DEFAULT T |
| search_ Max Length : [200] | Search keyword |
Update a brand
PUT /api/v2/admin/brands/{brand_code}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_collection |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| brand_ Required Type : [A-Z0-9] | Brand code |
| brand_ | Brand name |
| use_ | whether to use a brand T: Use DEFAULT T |
| search_ Max Length : [200] | Search keyword |
Delete a brand
DELETE /api/v2/admin/brands/{brand_code}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| brand_ Required Type : [A-Z0-9] | Brand code |
Classifications
Custom category refers to information entered in [Products>Add products>Advanced settings>Production information>Custom category]. It is one of the category types and every product must be assigned to one custom category. If a product is unassigned, it is automatically assigned to Default custom category.
Classifications properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| classification_ Type : [A-Z0-9] | Classification code |
| classification_ Max Length : [200] | Classification name |
| classification_ Max Length : [300] | Classification description |
| use_ | Use classification |
| created_ timezone | Created date |
| product_ | Product count Number of products. |
List all classifications
GET /api/v2/admin/classifications
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| classification_ | Classification code You can search multiple item with ,(comma) |
| classification_ | Classification name You can search multiple item with ,(comma) |
| use_ | Use classification |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Count all classifications
GET /api/v2/admin/classifications/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| classification_ | Classification code You can search multiple item with ,(comma) |
| classification_ | Classification name You can search multiple item with ,(comma) |
| use_ | Use classification |
Manufacturers
Manufacturers is an information entered into the "production information" of a product. The manufacturer represents the subject who produced and produced the product, and is one of the sales categories that distinguish the products. The product must have one manufacturer (using "own manufacturer" when not specified)
Manufacturers properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| manufacturer_ Type : [A-Z0-9] | Manufacturer code Unique number of each manufacturer. This number cannot be duplicated in a mall. |
| manufacturer_ Max Length : [50] | Manufacturer name Name of manufacturer. Manufacturer name is the basic information for mall to distinguish each manufacturer. |
| president_ Max Length : [30] | CEO President name of manufacturer. |
| use_ | Use classification Whether use the manufacturer or not. T: Use |
| email Max Length : [255] | Email of manufacturer. It can only be viewed when retrieving details. |
| phone Max Length : [20] | Office phone number Phone number of manufacturer. It can only be viewed when retrieving details. |
| homepage Max Length : [255] | Home page Website address of manufacturer. It can only be viewed when retrieving details. |
| zipcode | Zipcode Zipcode of manufacturer. It can only be viewed when retrieving details. |
| address1 Max Length : [255] | Address 1 Address1 of manufacturer. (Street address, P.O. box, company name, c/o) It can only be viewed when retrieving details. |
| address2 Max Length : [255] | Address 2 Address2 of manufacturer. (Apartment, suite, unit, building, floor, etc) It can only be viewed when retrieving details. |
| created_ timezone | Created date It can only be viewed when retrieving details. |
List all manufacturers
GET /api/v2/admin/manufacturers
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| manufacturer_ | Manufacturer code Code of manufacturer to search. You can search multiple item with ,(comma) |
| manufacturer_ | Manufacturer name You can search multiple item with ,(comma) |
| use_ | Use manufacturer T: Use |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list Set the start location of search result. |
Count all manufacturers
GET /api/v2/admin/manufacturers/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| manufacturer_ | Manufacturer code Code of the manufacturer you want to retrieve You can search multiple item with ,(comma) |
| manufacturer_ | Manufacturer name Search for manufacturers of which names contain the search term that you enter. The search term is case-insensitive. You can search multiple item with ,(comma) |
| use_ | Use manufacturer T: Use |
Get a manufacturer
GET /api/v2/admin/manufacturers/{manufacturer_code}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| manufacturer_ Required Type : [A-Z0-9] | Manufacturer code |
Create a manufacturer
POST /api/v2/admin/manufacturers
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_collection |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| manufacturer_ Required | Manufacturer name |
| president_ Required Max Length : [30] | CEO |
| email Max Length : [255] | |
| phone Max Length : [20] | Office phone number |
| homepage Max Length : [255] | Home page |
| zipcode | Zipcode |
| address1 Max Length : [255] | Address 1 |
| address2 Max Length : [255] | Address 2 |
| use_ | Use classification T: Use |
Update a manufacturer
PUT /api/v2/admin/manufacturers/{manufacturer_code}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_collection |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| manufacturer_ Required Type : [A-Z0-9] | Manufacturer code |
| manufacturer_ | Manufacturer name |
| president_ | CEO |
| email Max Length : [255] | |
| phone Max Length : [20] | Office phone number |
| homepage Max Length : [255] | Home page |
| zipcode | Zipcode |
| address1 Max Length : [255] | Address 1 |
| address2 Max Length : [255] | Address 2 |
| use_ | Use classification T: Use |
Origin
Origin means the region where the product was produced. Country of origin is important data for overseas shipping. Cafes 24 coded a variety of countries of origin, and the country of origin code information can be checked through the Origin search API.
Endpoints
List all origin
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| origin_ | Origin place no |
| origin_ Max Length : [50] | Origin place name |
| foreign | Foreign |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Trends
Trends refers to the information that you enter into trends in the "production information" of a product. Trends is one of the sales categories that distinguish products, and products must have one trend (using "basic trends" when not specified).
Trends properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| trend_ Type : [A-Z0-9] | Trend code |
| trend_ Max Length : [50] | Trend name |
| use_ | whether to use trend Whether use trend or not. T: Use |
| created_ timezone | Created date |
| product_ | Product count Number of products. |
List all trends
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| trend_ | Trend code Code of trend. You can search multiple item with ,(comma) |
| trend_ | Trend name Name of trend. You can search multiple item with ,(comma) |
| use_ | whether to use trend Whether use trend or not. T: Use |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Count all trends
GET /api/v2/admin/trends/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_collection |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| trend_ | Trend code You can search multiple item with ,(comma) |
| trend_ | Trend name You can search multiple item with ,(comma) |
| use_ | whether to use trend Whether use trend or not. T: Use |
Supply
Suppliers
Suppliers refer to information entered into the supplier by the "production information" of the product. Supplier means a company or individual who can supply goods to the shopping mall and sell the goods. The supplier is one of the sales categories that distinguish the goods, and the goods must have one supplier (use "self-supply" when not specified)
Suppliers properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| supplier_ | Supplier code Unique number of each supplier. This number cannot be duplicated in a mall. |
| supplier_ Max Length : [100] | Supplier name Name of supplier. Supplier name is the basic information for mall to distinguish each supplier. |
| status | Approval status Business status information with corresponding supplier. A: Business on going |
| commission | Commission Commission information for commission payment type(P). |
| payment_ | Payment frequency term You can set the payment frequency term. 0: Do not set |
| business_ Max Length : [255] | Product type for business Product type of business dealing with supplier. |
| payment_ | Payment type You may choose the type of payment to paying with supplier. P: Commission type |
| supplier_ | Business type of supplier Business type of supplier. WS: Wholesale |
| use_ | Use classification Whether use the supplier or not. T: Use |
| created_ timezone | registered date Created date of supplier information. |
| updated_ timezone | Updated date Modified date of supplier information. |
| country_ | Country code of business address KOR: Korea |
| zipcode Max Length : [10] | Zipcode Zipcode of supplier. |
| address1 Max Length : [255] | Address 1 Address1 of supplier. (Street address, P.O. box, company name, c/o) |
| address2 Max Length : [255] | Address 2 Address2 of supplier. (Apartment, suite, unit, building, floor, etc) |
| manager_ | In Charge Person in charge at supplier. |
| trading_ | Trade type Trade type which provides from the supplier. It can only be viewed when retrieving details. D: Reatil |
| payment_ | criteria status for payment Criteria status for payment. It can only be viewed when retrieving details. 10 : complete payment |
| payment_ Min : [0]~Max : [6] | Payment start day Process payment at designated date. It can only be viewed when retrieving details. 0: Sunday |
| payment_ Min : [0]~Max : [6] | Payment end day Process payment at designated date. It can only be viewed when retrieving details. 0: Sunday |
| payment_ Min : [1]~Max : [31] | payment start date Set the payment start date in case for Payment frequency term is Monthly term(A) It can only be viewed when retrieving details. |
| payment_ Min : [1]~Max : [31] | payment end date Set the payment end date in case for Payment frequency term is Monthly term(A) It can only be viewed when retrieving details. |
| bank_ Max Length : [50] | Bank code Bank code for close payment to supplier. It can only be viewed when retrieving details. |
| bank_ | Bank account no Bank account number for close payment to supplier. It can only be viewed when retrieving details. |
| bank_ | Bank account holder number Bank account name for close payment to supplier. It can only be viewed when retrieving details. |
| phone Max Length : [20] | Office phone number Office phone number of supplier. It can only be viewed when retrieving details. |
| fax Max Length : [20] | Office fax number Office fax number of supplier. It can only be viewed when retrieving details. |
| market_ | Country code of market address It can only be viewed when retrieving details. KOR: Korea |
| market_ Max Length : [10] | Market address zip code It can only be viewed when retrieving details. |
| market_ | Market address 1 It can only be viewed when retrieving details. |
| market_ | Market address 2 It can only be viewed when retrieving details. |
| exchange_ | Country code of return address It can only be viewed when retrieving details. KOR: Korea |
| exchange_ Max Length : [10] | Return address zip code It can only be viewed when retrieving details. |
| exchange_ Max Length : [255] | Return address 1 It can only be viewed when retrieving details. |
| exchange_ Max Length : [255] | Return address 2 It can only be viewed when retrieving details. |
| homepage_ Max Length : [100] | Home page address It can only be viewed when retrieving details. |
| mall_ Max Length : [100] | Shopping mall address It can only be viewed when retrieving details. |
| account_ Max Length : [10] | Transaction start date It can only be viewed when retrieving details. |
| account_ Max Length : [10] | Transaction stop date It can only be viewed when retrieving details. |
| show_ Max Length : [100] | show supplier information It can only be viewed when retrieving details. SP: Phone number |
| memo Max Length : [255] | Important memo Memo for manage supplier. It can only be viewed when retrieving details. |
| company_ Max Length : [12] | Company registration number Business registration number with corresponding supplier. Displays when unique business registration number issued following to a country. It can only be viewed when retrieving details. |
| company_ | Company name Company name that supplier registered when registration of enterprise. It can only be viewed when retrieving details. |
| president_ | CEO President name that supplier registered when registration of enterprise. It can only be viewed when retrieving details. |
| company_ | Business Company type that supplier registered when registration of enterprise. It can only be viewed when retrieving details. |
| company_ | Business category Company item that supplier registered when registration of enterprise. It can only be viewed when retrieving details. |
| company_ | About us A brief introduction of the supplier. It can only be viewed when retrieving details. |
List all suppliers
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_supply |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| supplier_ | Supplier code Unique number of each supplier. This number cannot be duplicated in a mall. You can search multiple item with ,(comma) |
| supplier_ | Supplier name Name of supplier. Supplier name is the basic information for mall to distinguish each supplier. You can search multiple item with ,(comma) |
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Count all suppliers
GET /api/v2/admin/suppliers/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_supply |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| supplier_ | Supplier code Unique number of each supplier. This number cannot be duplicated in a mall. You can search multiple item with ,(comma) |
| supplier_ | Supplier name Name of supplier. Supplier name is the basic information for mall to distinguish each supplier. You can search multiple item with ,(comma) |
Get a supplier
GET /api/v2/admin/suppliers/{supplier_code}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_supply |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| supplier_ Required | Supplier code Unique number of each supplier. This number cannot be duplicated in a mall. |
Create a supplier
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_supply |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| supplier_ Required Max Length : [50] | Supplier name Name of supplier. Supplier name is the basic information for mall to distinguish each supplier. |
| manager_ Array Max : [3] | In Charge You can add up to three managers. |
| no name phone email | |
| use_ | Use classification Whether use the supplier or not. T: Use DEFAULT T |
| trading_ | Trade type Trade type which provides from the supplier. D: Reatil DEFAULT D |
| supplier_ | Business type of supplier Business type of supplier. WS: Wholesale DEFAULT WS |
| status | Approval status Business status information with corresponding supplier. A: Business on going DEFAULT A |
| business_ Max Length : [255] | Product type for business Product type of business dealing with supplier. |
| payment_ | Payment type You may choose the type of payment to paying with supplier. P: Commission type DEFAULT P |
| payment_ | Payment frequency term You can set the payment frequency term. 0: Do not set |
| payment_ | criteria status for payment Criteria status for payment. 10 : complete payment |
| payment_ Min : [0]~Max : [6] | Payment start day Process payment at designated date. 0: Sunday |
| payment_ Min : [0]~Max : [6] | Payment end day Process payment at designated date. 0: Sunday |
| payment_ Min : [1]~Max : [31] | payment start date Set the payment start date in case for Payment frequency term is Monthly term(A) |
| payment_ Min : [1]~Max : [31] | payment end date Set the payment end date in case for Payment frequency term is Monthly term(A) |
| commission | commission rate Commission information for commission payment type(P). DEFAULT 10 |
| phone Max Length : [20] | Office phone number Office phone number of supplier. |
| fax Max Length : [20] | Office fax number Office fax number of supplier. |
| country_ | Country code of business address KOR: Korea |
| zipcode Max Length : [10] | Zipcode Zipcode of supplier. |
| address1 Max Length : [255] | Address 1 Address1 of supplier. (Street address, P.O. box, company name, c/o) |
| address2 Max Length : [255] | Address 2 Address2 of supplier. (Apartment, suite, unit, building, floor, etc) |
| market_ | Country code of market address KOR: Korea |
| market_ Max Length : [10] | Market address zip code |
| market_ | Market address 1 |
| market_ | Market address 2 |
| exchange_ | Country code of return address KOR: Korea |
| exchange_ Max Length : [10] | Return address zip code |
| exchange_ Max Length : [255] | Return address 1 |
| exchange_ Max Length : [255] | Return address 2 |
| homepage_ Max Length : [100] | Home page address |
| mall_ Max Length : [100] | Shopping mall address |
| account_ Max Length : [10] | Transaction start date |
| account_ Max Length : [10] | Transaction stop date |
| memo Max Length : [255] | Important memo Memo for manage supplier. |
| company_ Max Length : [12] | Company registration number Business registration number with corresponding supplier. Displays when unique business registration number issued following to a country. |
| company_ Max Length : [30] | Company name Company name that supplier registered when registration of enterprise. |
| president_ Max Length : [20] | CEO President name that supplier registered when registration of enterprise. |
| company_ Max Length : [20] | Business Company type that supplier registered when registration of enterprise. |
| company_ Max Length : [20] | Business category Company item that supplier registered when registration of enterprise. |
| company_ | About us A brief introduction of the supplier. |
Update a supplier
PUT /api/v2/admin/suppliers/{supplier_code}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_supply |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| supplier_ Required Type : [A-Z0-9] | Supplier code Unique number of each supplier. This number cannot be duplicated in a mall. |
| supplier_ Max Length : [50] | Supplier name Name of supplier. Supplier name is the basic information for mall to distinguish each supplier. |
| use_ | Use classification Whether use the supplier or not. T: Use |
| trading_ | Trade type Trade type which provides from the supplier. D: Reatil |
| supplier_ | Business type of supplier Business type of supplier. WS: Wholesale |
| status | Approval status Business status information with corresponding supplier. A: Business on going |
| payment_ | Payment type You may choose the type of payment to paying with supplier. P: Commission type |
| payment_ | Payment frequency term You can set the payment frequency term. 0: Do not set |
| commission | commission rate Commission information for commission payment type(P). |
| manager_ Array Max : [3] | In Charge You can add up to three managers. Information on a specific manager can be edited by using "no". |
| no name phone email use_sms | |
| business_ Max Length : [255] | Product type for business Product type of business dealing with supplier. |
| payment_ | criteria status for payment Criteria status for payment. 10 : complete payment |
| payment_ Min : [0]~Max : [6] | Payment start day Process payment at designated date. 0: Sunday |
| payment_ Min : [0]~Max : [6] | Payment end day Process payment at designated date. 0: Sunday |
| payment_ Min : [1]~Max : [31] | payment start date Set the payment start date in case for Payment frequency term is Monthly term(A) |
| payment_ Min : [1]~Max : [31] | payment end date Set the payment end date in case for Payment frequency term is Monthly term(A) |
| phone Max Length : [20] | Office phone number Office phone number of supplier. |
| fax Max Length : [20] | Office fax number Office fax number of supplier. |
| country_ | Country code of business address KOR: Korea |
| zipcode Max Length : [10] | Zipcode Zipcode of supplier. |
| address1 Max Length : [255] | Address 1 Address1 of supplier. (Street address, P.O. box, company name, c/o) |
| address2 Max Length : [255] | Address 2 Address2 of supplier. (Apartment, suite, unit, building, floor, etc) |
| market_ | Country code of market address KOR: Korea |
| market_ Max Length : [10] | Market address zip code |
| market_ | Market address 1 |
| market_ | Market address 2 |
| exchange_ | Country code of return address KOR: Korea |
| exchange_ Max Length : [10] | Return address zip code |
| exchange_ Max Length : [255] | Return address 1 |
| exchange_ Max Length : [255] | Return address 2 |
| homepage_ Max Length : [100] | Home page address |
| mall_ Max Length : [100] | Shopping mall address |
| account_ Max Length : [10] | Transaction start date |
| account_ Max Length : [10] | Transaction stop date |
| memo Max Length : [255] | Important memo Memo for manage supplier. |
| company_ Max Length : [12] | Company registration number Business registration number with corresponding supplier. Displays when unique business registration number issued following to a country. |
| company_ Max Length : [30] | Company name Company name that supplier registered when registration of enterprise. |
| president_ Max Length : [20] | CEO President name that supplier registered when registration of enterprise. |
| company_ Max Length : [20] | Business Company type that supplier registered when registration of enterprise. |
| company_ Max Length : [20] | Business category Company item that supplier registered when registration of enterprise. |
| company_ | About us A brief introduction of the supplier. |
Delete a supplier
DELETE /api/v2/admin/suppliers/{supplier_code}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_supply |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| supplier_ Required Type : [A-Z0-9] | Supplier code |
Suppliers users
Supplier Users is used when the supplier logs in to the shopping mall and registers the goods directly. You can grant limited rights to supplier operators such as uploading products, managing classifications, and managing bulletin boards.
Suppliers users properties
| Attribute | Description |
|---|---|
| user_ Type : [a-zA-Z0-9] | Supplier operator ID ID of supplier operator when logging in the mall. Supplier operator can access the supplier administrator screen by logging in to the shopping mall administrator page same as the sub operator of the mall. |
| supplier_ Max Length : [8] | Supplier code System assigned code of supplier. This code cannot be duplicated. |
| supplier_ Max Length : [100] | Supplier name Name of supplier is a basic information which can separate each supplier at the shopping mall administrator page. |
| permission_ | Authority to select the classification when a product is registered Set the authority of whether the supplier operator can select the product classification when register product. T: Allow |
| permission_ | Authority to modify a product Permission of modify the product for supplier operator after register the product. T: Allow |
| permission_ | Authority to display a product Permission of display the product for supplier operator after register the product. T: Allow |
| permission_ | Authority to sell a product Permission of selling the product for supplier operator after register the product. T: Allow |
| permission_ | Permission to remove registered products Permission of delete the product for supplier operator after register the product. T: Allow |
| permission_ | authority setting for board Permission of access bulletin board for supplier operator after register the product. T: Allow |
| user_ | Suppliers/Users name Name of the supplier's operator means the name displayed in the "person (processor) who performed the job" when a supplier operator performs a certain operation on the shopping mall manager screen. It can only be viewed when retrieving details. |
| nick_ Length Min : [4]~Max : [20] | Nick name The nickname of the supplier's operator displayed in the "Writer" section if the operator of the supplier creates a post on the bulletin board. (only if the bulletin board is set to expose the 'nickname' instead of the writer name) It can only be viewed when retrieving details. |
| nick_ | Nickname icon type of supplier operator Can select type for Icon that shows in front of supplier operator nickname. It can only be viewed when retrieving details. D: Register Icon personally |
| nick_ Max Length : [255] | Nickname icon url of supplier operator Image path of supplier operator's nickname icon It can only be viewed when retrieving details. |
| use_ | Nickname icon display setting Whether display nickname icon or not when supplier operator creates a post on the bulletin board. It can only be viewed when retrieving details. T: Display |
| use_ | Board writer display setting Whether display writer's name or not when supplier operator creates a post on the bulletin board. It can only be viewed when retrieving details. T: Display |
| Email address of supplier operator. Can be used for store of supplier's contact information. It can only be viewed when retrieving details. | |
| phone | Office phone number Phone number of supplier operator. Can be used for store of supplier's contact information. It can only be viewed when retrieving details. |
| permission_ | Number of multi shopping mall A unique number assigned to a store using the default store language or other languages It can only be viewed when retrieving details. |
| permitted_ | Permission of classification access A product category that a supplier operator can select when registering a product. The supplier operator can upload the product only to the product category of selectable when registering the product. It can only be viewed when retrieving details. |
List all suppliers users
GET /api/v2/admin/suppliers/users
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_supply |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| user_ Type : [a-zA-Z0-9] | Supplier operator ID ID of supplier operator when logging in the mall. Supplier operator can access the supplier administrator screen by logging in to the shopping mall administrator page same as the sub operator of the mall. |
| supplier_ Max Length : [8] | Supplier code System assigned code of supplier. This code cannot be duplicated. |
| supplier_ Max Length : [100] | Supplier name Name of supplier is a basic information which can separate each supplier at the shopping mall administrator page. |
Count all suppliers users
GET /api/v2/admin/suppliers/users/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_supply |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| user_ Type : [a-zA-Z0-9] | Supplier operator ID ID of supplier operator when logging in the mall. Supplier operator can access the supplier administrator screen by logging in to the shopping mall administrator page same as the sub operator of the mall. |
| supplier_ Max Length : [8] | Supplier code System assigned code of supplier. This code cannot be duplicated. |
| supplier_ Max Length : [100] | Supplier name Name of supplier is a basic information which can separate each supplier at the shopping mall administrator page. |
Get a suppliers user
GET /api/v2/admin/suppliers/users/{user_id}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_supply |
| Request Limit | 10 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| user_ Type : [a-zA-Z0-9] | Supplier operator ID ID of supplier operator when logging in the mall. Supplier operator can access the supplier administrator screen by logging in to the shopping mall administrator page same as the sub operator of the mall. |
Shipping
Carriers
Carriers properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| carrier_ | shipping carrier ID |
| shipping_ | shipping carrier code |
| shipping_ | shipping carrier name |
| track_ | URL for tracking shipment |
| shipping_ | domestic/international shipping settings A: domestic |
| contact | primary contact |
| secondary_ | secondary contact |
| default_ | default shipping fee |
| homepage_ | Home page address |
| default_ | default shipping carrier settings T: Use |
| shipping_ | default shipping fee settings T: Used |
| shipping_ | default shipping fee data |
| express_ | linked carrier excluded information settings |
| links | link |
Get a carrier
GET /api/v2/admin/carriers/{carrier_id}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_shipping |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| carrier_ Required | Shipping company id |
Create a carrier
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_shipping |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| shipping_ Required | shipping carrier code |
| contact Required Max Length : [16] | primary contact |
| email Required Email | |
| shipping_ Max Length : [80] | shipping carrier name |
| track_ Max Length : [255] | URL for tracking shipment |
| secondary_ Max Length : [16] | secondary contact |
| default_ | default shipping fee |
| homepage_ Max Length : [255] | Home page address |
| shipping_ | default shipping fee settings T: Used DEFAULT F |
| shipping_ | default shipping fee data * Definitions of sub-properties of "shipping_fee_setting_detail" |
| shipping_type available_shipping_zone min_shipping_period max_shipping_period shipping_information shipping_fee_setting_domestic Array shipping_fee_type shipping_fee min_price use_product_category product_category_list Array category_no shipping_fee_criteria domestic_shipping_fee_list Array min_value max_value shipping_fee available_shipping_zone available_shipping_zone_list Array region start_zipcode end_zipcode available_order_time start_time end_time shipping_fee_setting_oversea Array shipping_fee_criteria shipping_country_list Array country_code country_shipping_fee_list Array country_code conditional min_value max_value shipping_fee additional_handling_fee additional_handling_fee_list Array country_code text min_value max_value additional_handling_fee unit rounding_unit rounding_rule maximum_quantity product_category_limit product_category_limit_list Array category_no product_maximum_quantity | |
Update a carrier
PUT /api/v2/admin/carriers/{carrier_id}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_shipping |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| carrier_ Required | shipping carrier ID |
| default_ | default shipping carrier settings T: Use DEFAULT T |
Delete a carrier
DELETE /api/v2/admin/carriers/{carrier_id}
DELETE
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_shipping |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| carrier_ Required | shipping carrier ID |
Shipping
Endpoints
Shipping properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| shipping_ | Shipping method shipping_01: Carrier |
| shipping_ | Other shipping methods |
| shipping_ | Domestic/International shipping A: Domestic shipping |
| shipping_ | Shipping period |
| shipping_ | Shipping fee type 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_ Max : [999999999] | shipping fee |
| free_ Max : [999999999] | Free shipping threshold |
| shipping_ Max : [999999999] | Quantity-based shipping rates |
| shipping_ | Advanced shipping rates setting |
| shipping_ | shipping fee criteria D: based on regular price before discount (Recommended) |
| product_ | Product weight |
| oversea_ | settings for shipping countries T: selected countries only |
| oversea_ | Shipping country |
| country_ | settings for shipping fee by country T: Enable |
| country_ | Shipping fee by country |
| international_ | International shipping insurance T: Enable |
| return_ | Return address |
| package_ | Parcel specifications |
Salesreport
Reports salesvolume
SalesVolume is the quantity of goods sold in the shopping mall. The sales quantity is updated periodically, so it may not be reflected in real time.
Endpoints
Reports salesvolume properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| collection_ | Settlement collection date Collection date on which sales volume statistics were collected |
| collection_ | Settlement collection time Collection time when sales volume statistics were collected |
| product_ | Product price Price of the product. |
| product_ | Product option price Additional price for option. |
| settle_ | Quantity completely paid Count for payment complete order at search period. |
| exchane_ | Quantity of products completely exchanged Quantity exchanged for the item during the searched period. |
| cancel_ | Quantity completely cancelled Count canceled product withint search period. |
| return_ | Quantity of products completely returned Count returned product at search period. |
| updated_ timezone | Final data renewal time Shows time when sales quantity statistical data is updated. |
| variants_ | Variant code Variants code of the product. |
| product_ | Product number |
| total_ | Total sales volume Total quantity sold during the time period that the item was searched. |
Get sales volume
GET /api/v2/admin/reports/salesvolume
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_salesreport |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| product_ | Product number System assigned code. This code cannot be duplicated. You can search multiple item with ,(comma) |
| variants_ | Variant code Variants code for search sales volume. |
| category_ | Category number Count sales volume of specific category. |
| mobile | Whether it is mobile or PC Count sales volume at mobile. T: Mobile |
| delivery_ | Delivery type Count sales volume of either domestic or abroad. A: Domestic |
| customer_ | Member level number Count sales volume of specific customer group. |
| group_ | Member level number |
| supplier_ Max Length : [20] | Supplier id Search for quantity registered with specific supplier ID among sales quantity. |
| start_ Required Date | Search Start Date Search start date for count sales volume(by order date). |
| end_ Required Date | Search End Date End date of search for sales volume(by order date). |
Personal
Carts
Endpoints
Carts properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| basket_ | cart item number |
| member_ | Member id |
| created_ timezone | date of deposition |
| product_ | Product number |
| additional_ | Additional option |
| variant_ Type : [A-Z0-9] | Product item code |
| quantity | Available inventory |
| product_ | Product price |
| option_ | Option price |
| product_ | Product bundle T: Set product |
| shipping_ | Delivery type A: Domestic |
| category_ | Category number |
List all carts
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_personal |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| member_ Required | Member id You can search multiple item with ,(comma) |
| offset Max : [10000] | Start location of list |
| limit Min : [1]~Max : [100] | Limit DEFAULT 10 |
Customers wishlist
Customers wishlist is a relational resource that lets you retrieve a list of products in a customer's wishlist.
Customers wishlist properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| wishlist_ | number of a wishlist product |
| product_ | Product number |
| variant_ Type : [A-Z0-9] | Variant code System assigned code. This code cannot be duplicated. |
| additional_ | Additional option |
| attached_ | Attached file option |
| price | Product price Selling price. Price that before applying coupon or other benefits. |
| product_ | Product bundle |
| created_ timezone | date of deposition Date when an item was added to the wishlist. |
| price_ Max Length : [20] | Alternative phrase of the selling price |
List all customers wishlist
GET /api/v2/admin/customers/{member_id}/wishlist
GET
Search a list of wishlist products of a customer.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_personal |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| member_ Required | Member id |
| shop_ | Shop Number DEFAULT 1 |
Count all customers wishlist
GET /api/v2/admin/customers/{member_id}/wishlist/count
GET
Count wishlist products of a customer.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_personal |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| member_ Required | Member id |
| shop_ | Shop Number DEFAULT 1 |
Products carts
List all products carts
GET /api/v2/admin/products/{product_no}/carts
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_personal |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
| limit Min : [1]~Max : [100] | Limit DEFAULT 10 |
| offset Max : [10000] | Start location of list |
Count all products carts
GET /api/v2/admin/products/{product_no}/carts/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_personal |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| product_ Required | Product number |
Privacy
Customersprivacy
A resource about personal information of a certain customer. You need to be extra careful when handling this resource as it contains sensitive information.
Customersprivacy properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages |
| member_ Max Length : [20] | Member id |
| name | Name name of the customer |
| name_ | English name English name of the customer |
| name_ | Phonetic transcription name (Japanese) phonetic name of the customer(Japanese) |
| phone | Office phone number phone of the customer |
| cellphone | Mobile mobile of the customer |
| email of the customer | |
| sms | Whether to receive SMS Whether receive SMS or not. 'Do not receive' status receives only important mail such as order status, service information. T: Receive |
| news_ | Whether to receive news mails Whether receive email or not. 'Do not receive' status receives only important mail such as order status, service information. 'Never receive email' status doesn't receives not only commercial mail but also important service or order related emails. T: Receive |
| wedding_ Date | Wedding anniversary wedding anniversary of the customer |
| birthday Date | Birthday Birthday of the customer |
| solar_ | Whether it is a solar calendar Whether birthday is based on solar calendar or not. T: Solar calendar |
| total_ | total points |
| available_ | available points |
| used_ | used points |
| city Max Length : [255] | City / Town |
| state Max Length : [255] | state |
| address1 Max Length : [255] | Address 1 The primary address of the customer. (city / county / province) |
| address2 Max Length : [255] | Address 2 The detailed address of the customer. |
| group_ | Group number number of member group of the customer |
| job_ | Job class job class of the customer |
| job | Job job of the customer |
| zipcode Max Length : [14] | Zipcode |
| created_ timezone | Created date signup date of the customer |
| member_ | Member authentication Member authentication type. Customer divided as 4 types based on member authentication. T: Authorized |
| use_ | Whether the member is blacklist Whether customer is a blacklist or not. You may limit the customer action for log-in, purchase, and both log-in and purchase. T: Set |
| blacklist_ | Blacklist type Blacklist type of the customer. You may limit the customer action for log-in, purchase, and both log-in and purchase. P: Block purchase |
| last_ timezone | Last login date last login date of the customer |
| member_ | Member authority Member authority classification. Member authority is separated to representative operator, sub operator, supplier, and ordinary member. C: General member |
| nick_ Max Length : [50] | Nick name nick name of the customer |
| recommend_ | Recommended id referrer ID that customer entered when joined member |
| residence | Residence residence of the customer |
| interest | Interest interest of the customer |
| gender | Gender Gender of the customer M: Male |
| member_ | Member type member type of the customer P: Individual |
| company_ | Company type In case member type is Business p: Individual business |
| foreigner_ | Foreigner type way how authenticate the foreign member in Korea F: Foreigner registration number |
| lifetime_ | Agree to shift to a permanent account T: Agree F: Do not agree |
| corporate_ | Corporate name corporate name of the customer |
| nationality | Nationality If the customer is a "foreign member", the nationality of the customer |
| shop_ | Shop name shop name of the customer |
| country_ | Country code The country of the customer |
| use_ | Whether to use mobile app whether customer using mobile app or not T: Using mobile app |
| join_ | Sign up medium P : PC |
| fixed_ | customer level fixing settings T: fix |
| available_ | available credits It can only be viewed when retrieving details. |
| additional_ | Additional information list Additional information of the customer It can only be viewed when retrieving details. |
List all customersprivacy
GET /api/v2/admin/customersprivacy
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_privacy |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| search_ | Search type Can choose member search criteria based on member information or join date. Can search regardless of offset when using join date criteria. customer_info : Search by customer information DEFAULT customer_info |
| created_ Date | search start date for join date search criteria Start date for searching for customers when search_type is create_date. You can search for customers who signed up after the start date. |
| member_ Max Length : [20] | Member id |
| news_ | Whether to receive news mails Whether receive email or not. 'Do not receive' status receives only important mail such as order status, service information. 'Never receive email' status doesn't receives not only commercial mail but also important service or order related emails. T: Receive |
| sms | Whether to receive SMS Whether receive SMS or not. 'Do not receive' status receives only important mail such as order status, service information. T: Receive |
| group_ | Group number number of member group of the customer |
| search_ | Search field Search field for targeted member. id: ID |
| keyword | Keyword Input search term of search field that targeted to search. You can search multiple item with ,(comma) |
| date_ | Date type Search criteria for search targeted member. Search start date and Search end date would be the time period of signup date if the search criteria is 'join'. join: Member registration date |
| start_ Date | Search Start Date Start date for searching for data by specific filters. 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. The date should be formatted as “YYYY-MM-DD HH:MM:SS.” |
| end_ Date | Search End Date End date when searching for data by filters. Must be used with a start date. If the end date is the same as the start date, results will be retrieved based on the date. The date should be formatted as “YYYY-MM-DD HH:MM:SS.” |
| member_ | Member type member type of the customer P: Individual |
| member_ | Member class This cannot be used on Cafe24 Japan, Vietnam. P: Individual |
| residence | Residence residence of the customer You can search multiple item with ,(comma) |
| gender | Gender Gender of the customer M: Male |
| member_ | Member authority Member authority classification. Member authority is separated to representative operator, sub operator, supplier, and ordinary member. C: General member DEFAULT C |
| join_ | Sign up medium P : PC |
| use_ | Whether to use mobile app T: Using mobile app |
| fixed_ | customer level fixing settings T: fix |
| limit Min : [1]~Max : [1000] | Limit Set the maximum number of search result. DEFAULT 30 |
| offset Max : [8000] | Start location of list When "created_date"is used for "search_type", offset parameter cannot be used. |
Count all customersprivacy
GET /api/v2/admin/customersprivacy/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_privacy |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| search_ | Search type You can choose whether to search for customers based on customer information or signup date. If you search with signup date, you can search for all customers regardless of offset. customer_info : Search by customer information DEFAULT customer_info |
| created_ Date | search start date for join date search criteria Start date for searching for customers when search_type is create_date. You can search for customers who signed up on or after the start date. |
| member_ Max Length : [20] | Member id |
| news_ | Whether to receive news mails Settings for receiving email notifications. If you unsubscribe from email notifications, you will still receive email updates about your order status or our services. If you select [Never] for email subscription, you do not receive any email notifications. T: Receive |
| sms | Whether to receive SMS Settings for receiving SMS notifications. If you unsubscribe, you will not receive advertisements but still receive notifications about Cafe24's services. T: Receive |
| group_ | Group number A number assigned to the customer level of the customer |
| search_ | Search field Customer search fields id: ID |
| keyword | Keyword You can search multiple item with ,(comma) |
| date_ | Date type join: Member registration date |
| start_ Date | Search Start Date Start date for searching for data by specific filters. Must be used with a search end date. If the start date is the same as the end date, results from the date will be retrieved. The date should be formatted as “YYYY-MM-DD HH:MM:SS.” |
| end_ Date | Search End Date End date when searching for data by filters. Must be used with a start date. If the end date is the same as the start date, results from the date will be retrieved. The date should be formatted as “YYYY-MM-DD HH:MM:SS.” |
| member_ | Member type Account type of the customer P: Individual |
| member_ | Member class This cannot be used on Cafe24 Japan, Vietnam. P: Individual |
| residence | Residence The customer's place of residence You can search multiple item with ,(comma) |
| gender | Gender Gender of the customer M: Male |
| member_ | Member authority Different permissions are assigned to customer account, head admin account, sub-admin account, and supplier account. C: General member DEFAULT C |
| join_ | Sign up medium P : PC |
| use_ | Whether to use mobile app T: Using mobile app |
| fixed_ | customer level fixing settings T: fix |
Get a customersprivacy
GET /api/v2/admin/customersprivacy/{member_id}
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_privacy |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number A unique number assigned to a store using the default store language or other languages DEFAULT 1 |
| member_ Required Max Length : [20] | Member id |
Update a customersprivacy
PUT /api/v2/admin/customersprivacy/{member_id}
PUT
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_privacy |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| member_ Required Max Length : [20] | Member id |
| cellphone | Mobile |
| email | |
| sms | Whether to receive SMS T: Receive |
| news_ | Whether to receive news mails T: Receive |
| birthday | Birthday |
| solar_ | Whether it is a solar calendar T: Solar calendar |
| address1 Max Length : [255] | Address 1 |
| address2 Max Length : [255] | Address 2 |
| zipcode Max Length : [14] | Zipcode |
| additional_ | Additional information list |
| key value | |
| city Max Length : [255] | City / Town |
| state Max Length : [255] | state |
| fixed_ | customer level fixing settings T: fix |
Products wishlist customers
Products wishlist customers is a resource that lets you retrieve a list of customers who added products to wishlist.
List all products wishlist customers
GET /api/v2/admin/products/{product_no}/wishlist/customers
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_privacy |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| product_ Required | Product number |
| shop_ | Shop Number DEFAULT 1 |
Count all products wishlist customers
GET /api/v2/admin/products/{product_no}/wishlist/customers/count
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_privacy |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| product_ Required | Product number |
| shop_ | Shop Number DEFAULT 1 |
Mileage
Credits
Credits are cash equivalents that can be used by the customers as a viable payment method to receive refunds. When using this API, not that this API requires sensitive scopes.
Endpoints
Credits properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| issue_ timezone | registered date |
| member_ Max Length : [20] | Member id |
| group_ | Group Name |
| increase_ | issued amount |
| decrease_ | deducted amount |
| balance | balance |
| admin_ | manager ID |
| admin_ | manager name |
| reason | Reason of processing |
| case | cases for issuing credits |
| order_ | Order ID |
List all credits
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_mileage |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| start_ Required Date | Search Start Date |
| end_ Required Date | Search End Date |
| type | whether increase/decrease credits I: payment history |
| case | cases for issuing credits A: cancel order |
| admin_ | manager ID |
| order_ Order ID | Order ID |
| search_ | Search field id: id |
| keyword | Keyword |
| limit Min : [1]~Max : [200] | Limit DEFAULT 50 |
| offset Max : [10000] | Start location of list |
Credits report
"Credits report" is a resource that allows you to retrieve a report of credits issued and deducted during a specified period of time.
Endpoints
List all credits report
GET /api/v2/admin/credits/report
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_mileage |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| start_ Required Date | Search Start Date |
| end_ Required Date | Search End Date |
| type | whether increase/decrease credits I: payment history |
| case | cases for issuing credits A: cancel order |
| admin_ | manager ID |
| search_ | Search field id: id |
| keyword | Keyword |
Points
A resource about store credit of a certain customer. You need to be extra careful when handling this resource as it has its own scope and can be very sensitive.
Points properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| case | mileage type |
| member_ | Member id |
| group_ | Group Name |
| available_ | reward points |
| available_ | deduct points |
| available_ | available points |
| unavailable_ | pending points |
| order_ timezone | Ordered date |
| issue_ timezone | mileage issued date |
| available_ | pending points available date |
| admin_ | manager ID |
| admin_ | manager name |
| order_ | Order ID |
| reason | reason for provide mileage Reason for increase / decrease mileage. |
| amount | mileage amount Maximum 1,000,000 mileage can be given for a single request. |
| type | whether increase/decrease mileage You can choose whether increase or decrease mileage. |
List all points
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_mileage |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| member_ Max Length : [20] | Member id |
| order_ Max Length : [100] | Order ID |
| group_ | Group number |
| start_ Required Date | Search Start Date |
| end_ Required Date | Search End Date |
| case | mileage type If you request all without specifying a loyalty point type, 'D: Refund to points' is excluded in response, hence you need to specify the type to retrieve a certain type of refund. A: points issued directly by admin |
| points_ | points history available: available points DEFAULT available |
| limit Min : [1]~Max : [100] | Limit DEFAULT 10 |
| offset Max : [8000] | Start location of list |
Increase / Decrease point
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_mileage |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| member_ Required Max Length : [20] | Member id |
| order_ Order ID | Order ID |
| amount Required Min : [0] | mileage amount |
| type Required | whether increase/decrease mileage increase : add mileage |
| reason | reason for provide mileage |
Points report
Points report is a resource that lets you retrieve a report on points issued during a specific date range.
Endpoints
Points report properties
| Attribute | Description |
|---|---|
| shop_ | Shop Number |
| available_ | available mileage increase |
| available_ | available mileage decrease |
| available_ | available mileage total |
| unavailable_ | unavailable mileage |
| unavailable_ | temporary member mileage coupon mileage |
List all points report
GET /api/v2/admin/points/report
GET
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_mileage |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| member_ Max Length : [20] | Member id |
| group_ | Group number |
| start_ Required Date | Search Start Date |
| end_ Required Date | Search End Date |
Notification
Customers invitation
Create a customers invitation
POST /api/v2/admin/customers/{member_id}/invitation
POST
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_notification |
| Request Limit | 40 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ Min : [1] | Shop Number DEFAULT 1 |
| member_ Required Max Length : [16] | Member id |
| invitation_ Required | Account invite method |
Sms
This resource allows you to automatically send SMS notifications regarding order or shipping status. You need to first check if SMS Delivery is enabled on a store before sending a request.
Endpoints
Send SMS
POST
This API can only be used in stores using Korean.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.write_notification |
| Request Limit | 1 |
| objects per single API call Limit | 1 |
Request
| Parameter | Description |
|---|---|
| shop_ | Shop Number DEFAULT 1 |
| sender_ Required | Sender ID Unique number of sender. |
| content Required | message |
| recipients Array Max : [100] | recipient number |
| member_ Array Max : [100] | Member id |
| exclude_ | whether exclude SMS rejected recipient May choose whether exclude SMS rejected recipient or not. T : exclude DEFAULT T |
| type | sent type Type of SMS. SMS : short message service DEFAULT SMS |
Sms senders
This resource is a child resource of SMS resource, and contains the number from which SMS will be sent.
Endpoints
Sms senders properties
| Attribute | Description |
|---|---|
| sender_ | Sender ID Unique number of a sender. |
| sender | Sender number Phone number of a sender. |
| auth_ | certification status Certification status of a sender. 00 : delete |
List all sms senders
GET
This API can only be used in stores using Korean.
Specification
| Property | Description |
|---|---|
| SCOPE | mall.read_notification |
| Request Limit | 40 |
Request
| Parameter | Description |
|---|---|
| limit Min : [1]~Max : [100] | Limit Set the maximum number of search result. DEFAULT 10 |
| offset Max : [8000] | Start location of list |
non-print
Codes
display_location code
| PAGE ROLE | CODE |
|---|---|
| Product category | PRODUCT_ |
| Product detail | PRODUCT_ |
| Product search | PRODUCT_ |
| Planned exhibition | PRODUCT_ |
| Recently viewed products | PRODUCT_ |
| Bulletin board main | BOARD_ |
| Bulletin board list | BOARD_ |
| Bulletin Board Details | BOARD_ |
| Write a post | BOARD_ |
| Edit post | BOARD_ |
| Posts reply | BOARD_ |
| Product Review List | BOARD_ |
| Product Review Details | BOARD_ |
| Write product review | BOARD_ |
| Edit Product Review | BOARD_ |
| Product Review Comment | BOARD_ |
| Gallery List (Grid) | BOARD_ |
| Gallery detail | BOARD_ |
| Write on Gallery | BOARD_ |
| Edit Gallery | BOARD_ |
| Gallery Reply | BOARD_ |
| Emergency Inquiry | BOARD_ |
| Private consultation list | BOARD_ |
| Private consultation details | BOARD_ |
| Write an 1: 1 custom consultation | BOARD_ |
| Modify an 1: 1 custom consultation | BOARD_ |
| Reply of 1: 1 custom consultation | BOARD_ |
| Sign Up | MEMBER_ |
| Modify membership information | MEMBER_ |
| Terms of Use | MEMBER_ |
| Privacy Statement | MEMBER_ |
| Membership result | MEMBER_ |
| Find ID | MEMBER_ |
| Find Password | MEMBER_ |
| My Shopping Main Screen | MYSHOP_ |
| My shopping order history | MYSHOP_ |
| My Shopping Order Details | MYSHOP_ |
| My shopping mileage history | MYSHOP_ |
| My Shopping Coupon History | MYSHOP_ |
| My Shopping Deposit History | MYSHOP_ |
| Shipping Address List | MYSHOP_ |
| Shipping Address Register | MYSHOP_ |
| Edit shipping address | MYSHOP_ |
| main screen | MAIN |
| Members only accessible pages | MAIN_ |
| Personal authentication page | MAIN_ |
| User Guide (FAQ) | SHOPINFO_ |
| About Us | SHOPINFO_ |
| Shopping cart screen | ORDER_ |
| Order Form Screen | ORDER_ |
| Order Completed | ORDER_ |
| Gift Guide | ORDER_ |
| Coupon Zone | COUPON_ |
| Login screen | MEMBER_ |
| My Shopping List | MYSHOP_ |
| Compare products | PRODUCT_ |
| Operational log list | BOARD_ |
| Read operational log | BOARD_ |
| Delete comments on post | BOARD_ |
| Secret posts | BOARD_ |
| Delete Gallery comment | BOARD_ |
| Gallery secret posts | BOARD_ |
| Bulk purchase inquiry list | BOARD_ |
| Modify Bulk Purchase inquiry | BOARD_ |
| Registration of bulk purchase inquiry | BOARD_ |
| Detail of bulk purchase inquiry | BOARD_ |
| One line memo list | BOARD_ |
| Member password authentication | MEMBER_ |
| ID Search Results | MEMBER_ |
| Password Find Results | MEMBER_ |
| Find password security question | MEMBER_ |
| Access restrictions | MEMBER_ |
| My posts | MYSHOP_ |
| View pending mileage history | MYSHOP_ |
| Cancellation | MYSHOP_ |
| Exchange request | MYSHOP_ |
| Request Return | MYSHOP_ |
| Tax Invoice Application Form | MYSHOP_ |
| Cash Receipt Application Form | MYSHOP_ |
| Attendance Check (Comments type) | ATTEND_ |
| Attendance Check (Calendar type) | ATTEND_ |
| Calendar Bulletin (Daily) | CALENDAR_ |
| Calendar bulletin additional item | CALENDAR_ |
| Calendar Bulletin (Monthly) | CALENDAR_ |
| Calendar Bulletin (Weekly) | CALENDAR_ |
| Supplier main | SUPPLY_ |
| Shortcut (Lincon) | LINK_ |