카페24 상품 옵션 설정 가이드
ASPECA 자수 커스터마이징 서비스를 사용하려면 카페24 상품에 아래 옵션들을 직접 추가해야 합니다.
옵션 설정 후 자수 앱 관리자 페이지에서 해당 상품을 활성화하면 고객이 상품 페이지에서 자수 커스터마이징을 이용할 수 있습니다.
고객이 자수 또는 로고 추가를 선택할 수 있는 옵션입니다.
| 옵션명 | 옵션값 | 추가금액 |
|---|---|---|
| 커스터마이징 | 선택안함 | 0원 |
| 자수 | +10,000원 | |
| 로고 | +15,000원 | |
| 자수+로고 | +25,000원 |
옵션을 추가할 상품의 수정 페이지로 이동합니다.
기존 옵션(색상, 사이즈 등)이 있다면 그 아래에 새 옵션을 추가합니다.
커스터마이징 입력
옵션 타입은 "셀렉트박스"를 선택합니다.
아래 4개 값을 순서대로 입력합니다:
선택안함 (추가금액: 0)자수 (추가금액: 10000)로고 (추가금액: 15000)자수+로고 (추가금액: 25000)"필수" 또는 "선택"으로 설정합니다. 필수로 설정하면 고객이 반드시 선택해야 합니다.
옵션이 조합형인 경우, 옵션 추가 후 "품목 생성" 버튼을 클릭하여 품목을 생성합니다.
디테일 추가 옵션이 필요한 상품에 설정합니다.
| 옵션명 | 옵션값 | 추가금액 |
|---|---|---|
| 디테일 옵션 | 선택안함 | 0원 |
| 디테일 추가 | +10,000원 |
선택안함, 디테일 추가로
정확히 입력해야 합니다.
커스터마이징 옵션과 동일한 방식으로 설정합니다:
디테일선택안함 (추가금액 0)디테일 추가 (추가금액 10000)자수 커스터마이징 데이터를 연동하기 위한 시스템 키 저장용 옵션입니다.
이 옵션은 고객이 직접 입력하는 것이 아닙니다.
고객이 자수 커스터마이징을 완료하면 고유 키(ID)가 자동으로 입력되며,
이 키를 통해 커스터마이징 정보를 조회합니다.
추가입력 옵션을 설정할 상품의 수정 페이지로 이동합니다.
일반 옵션 설정 아래쪽에 "추가입력 옵션" 영역이 있습니다.
추가입력 옵션 사용을 활성화합니다.
커스텀설정 완료 후 상품을 저장합니다.
| 설정 항목 | 설정값 | 설명 |
|---|---|---|
| 사용여부 | 사용 | 추가입력 옵션 활성화 |
| 옵션명 | 커스텀 |
시스템 키 저장용 (고객 입력 아님) |
| 필수여부 | 선택 | 커스터마이징 안 하는 고객도 주문 가능 |
| 입력글자수 | 200자 | 고유 키 저장에 충분한 길이 |
옵션명은 반드시 커스텀로 입력해야 자수 앱에서 자동으로 인식합니다.
이 옵션은 화면에 표시되지 않도록 CSS로 숨김 처리됩니다.
카페24에서 옵션 설정을 완료한 후, 자수 앱 관리자 페이지에서 상품을 활성화합니다.
https://api.aspeca.co.kr/admin에 접속합니다.
상단 메뉴에서 "상품활성화" 탭을 클릭합니다.
옵션을 설정한 상품을 검색하여 "활성화" 버튼을 클릭합니다.
"상품이미지" 탭에서 자수 미리보기용 상품 이미지를 등록할 수 있습니다.
이제 해당 상품 페이지에서 고객이 자수 커스터마이징을 이용할 수 있습니다.
자수 커스터마이징 기능이 작동하려면 카페24 스킨에 스크립트를 삽입해야 합니다.
상품 상세 페이지에서 커스터마이징 버튼을 표시합니다.
상품 상세 페이지 스킨 파일을 엽니다. (예: product/detail.html)
<script src="https://api.aspeca.co.kr/js/embroidery.js"></script>
<script>
ASPECA_EMBROIDERY.init({
buttonContainer: '.xans-product-action, .btn_option_area, .option_area',
productNo: '{$product_no}',
productName: '{$name}',
productImage: '{$image_medium}'
});
</script>
장바구니에서 커스터마이징 정보를 표시합니다.
장바구니 페이지 스킨 파일을 엽니다. (예: order/basket.html)
<script src="https://api.aspeca.co.kr/js/cart-customization.js"></script>
이 스크립트는 장바구니에서 커스터마이징 키(ASP-xxxx-xxxx)를 자동으로 찾아
실제 커스터마이징 내용(자수 문구, 로고 위치 등)으로 변환해서 표시합니다.
자수 앱에서 옵션을 인식하지 못해 커스터마이징 기능이 정상 작동하지 않습니다.
반드시 가이드에 명시된 옵션값(선택안함, 자수, 로고, 자수+로고)을
정확히 입력해주세요.
네, 추가금액은 원하는 금액으로 자유롭게 설정할 수 있습니다. 단, 옵션값 이름은 반드시 동일하게 유지해야 합니다.
조합형 옵션(색상+사이즈 등)을 사용하는 상품에 새 옵션을 추가하면 기존 품목 설정이 변경될 수 있습니다. 옵션 추가 전에 기존 재고/가격 설정을 확인하시기 바랍니다.
로고 위치(좌가슴, 우가슴, 좌소매, 우소매, 포켓중앙)는 고객이 상품 페이지의 자수 커스터마이징 팝업에서 직접 선택합니다. 카페24 상품 옵션에는 추가하지 않아도 됩니다.
포켓중앙에 로고를 넣으면 포켓 사용이 불가능합니다. 고객이 포켓중앙을 선택하면 자동으로 안내 문구가 표시됩니다.
한 줄당 최대 8자까지 입력할 수 있습니다. 모든 글자 타입(1줄, 2줄, 좌2+우1)에 동일하게 적용됩니다.
고객이 "수정" 버튼을 클릭하면 커스터마이징 팝업이 다시 열리고, 수정 완료 시 기존 옵션이 자동으로 교체됩니다. 기존 옵션 행이 삭제된 후 새 옵션이 적용되므로 중복 문제가 발생하지 않습니다.
네, 네이버페이 등 외부 결제 주문도 정상적으로 매핑됩니다. 카페24 추가입력옵션에 저장된 ASP- 키를 통해 자동으로 연결됩니다.