Subscription Order Service

This is an API service for shopping mall customers in which subscription orders are automatically created and products are delivered. When a customer conveniently applies for the subscription order service for a desired product, an automatic order is created according to the specified cycle and date, allowing the customer to easily receive the product.

---

Key Features

• Subscription Order Application

  • Applications are made by adding products eligible for subscription orders to the cart.

  • Delivery and payment information is automatically set to the member's default information.

  • As optional settings, delivery request notes, application period, and application date can be specified.

  • Non-members cannot apply for the subscription order service.

• Subscription Order Data Creation

  • A subscription delivery order is automatically created on the next order creation date of the applied product.

• Subscription Order Service Application List Lookup

  • Retrieves the list of subscription order service applications for the member number.

  • Only orders within the lookup period are returned.

• Subscription Order Service Detail Lookup

  • Retrieves the subscription order details based on the subscription order number.

• Subscription Order Change and Cancellation

  • Cancellation and order cycle changes are possible from the subscription order service details.

  • The next scheduled order date can be changed by using Skip All.

Process Definition — Subscription Order Application

1

Order Eligibility Validation

Users can enter the subscription order application form from the cart screen. Upon entering the application form, an overall validation is performed to check whether the product is eligible for ordering and whether the member is in a state eligible to order.

2

Order Application Form Lookup

Auto-payment card, member default delivery address, order product, delivery, and accumulation information are divided into order sheet information needed to display the order sheet and order creation information needed to create the order application, and delivered accordingly.

3

Subscription Order Number Issuance

Issues a subscription order number for creating the subscription order application.

4

Apply for Subscription Order

Creates the subscription order application based on the order information selected on the screen.

5

Application Completion Information Lookup

Retrieves the subscription order application completion information to display on the application completion page.

6

Subscription Order Creation

A daily batch creates orders for subscription order applications whose next scheduled order creation date has arrived.

Process Definition — Subscription Order Application Lookup

1

Subscription Order List Lookup

For members, the subscription order application list can be viewed via My Page > Subscription Order Application History.

2

Subscription Order History Detail Lookup

Clicking the subscription order number navigates to the subscription order application details.

API Function List

API	Description	Server	Method	Remarks
Subscription Order Application Form Lookup	Retrieves the member's subscription order application form information.	Order	POST	🔗View API > Product lookup: /api/goods/v1/detail/goods Member default delivery address lookup: /api/member/v1/front/dlvpInfo​ Delivery policy lookup: /api/goods/v1/delivery/deliProcInfo
Subscription Order Number Issuance	Issues the subscription order number.	Order	GET	🔗View API >
Subscription Order Application	Applies for the subscription order.	Order	POST	🔗View API >
Subscription Order Application Completion Information Lookup	Retrieves the subscription order application information after a successful application.	Order	GET	🔗View API >
Subscription Order History Lookup	Retrieves the order list for the member number. Non-members cannot view the order history list. Only orders within the lookup start date/time and lookup end date/time are retrieved.	Order	GET	🔗View API >
Subscription Order History Detail Lookup	Retrieves the subscription order history for the subscription order number.	Order	GET	🔗View API >

Terminology

Term	Description
Subscription Delivery Cycle Value	A string composed of comma-separated numbers (e.g., “1,2,3”). When the cycle code is month, it represents the day of the month; when it is week, it represents the day of the week.
Next Order Creation Date	A date generated based on the subscription delivery cycle value. It is first generated at the time of application, and when that date arrives, the subscription order is created.

Other Notes

• The subscription delivery cycle is managed via a common code. (OM034)

• When the scheduled subscription order date is first generated, the number of days corresponding to the larger of OM021's values (order application scheduled notice date, order creation date) must pass before the date becomes eligible for creation.