> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Magento

## 1단계: 백엔드 구성 (OAuth1 API)

*이 단계를 통해 Kleep는 알고리즘 보정을 위해 귀하의 제품 카탈로그, 주문 이력 및 반품 데이터를 검색할 수 있습니다.*

### 1. OAuth1 통합 생성

1. **Magento 관리자 패널**에 로그인합니다.
2. **시스템 > 통합**으로 이동합니다.
3. \*\*"새 통합 추가"\*\*를 클릭합니다.
4. **이름** 필드를 입력합니다 (예: "Kleep Integration").
5. 확인을 위해 **관리자 비밀번호**를 입력합니다.

### 2. API 권한 구성

| **경로**                            | 세부 정보                   |
| --------------------------------- | ----------------------- |
| `/products/*`                     | 모든 제품 리소스에 대한 액세스       |
| `/categories/*`                   | 모든 카테고리 리소스에 대한 액세스     |
| `/orders/*`                       | 모든 주문 리소스에 대한 액세스       |
| `/returns/*`                      | 모든 반품 리소스에 대한 액세스       |
| `/returnsAttributeMetadata/*`     | 모든 반품 속성 리소스에 대한 액세스    |
| `/returnsItemAttributeMetadata/*` | 모든 반품 항목 속성 리소스에 대한 액세스 |
| `/creditmemos/*`                  | 모든 크레딧 메모 리소스에 대한 액세스   |
| `/creditmemo/*`                   | 단일 크레딧 메모 리소스에 대한 액세스   |
| `/stockItems/*`                   | 모든 재고 리소스에 대한 액세스       |
| `/store/*`                        | 모든 스토어 리소스에 대한 액세스      |
| `/inventory/*`                    | 모든 인벤토리 리소스에 대한 액세스     |
| `/customers/*`                    | 모든 고객 리소스에 대한 액세스       |

**Magento의 다음 ACL에 해당해야 합니다**:

* `Magento_Catalog::products`
* `Magento_Catalog::categories`
* `Magento_Sales::sales`
* `Magento_Sales::creditmemo`
* `Magento_Sales::actions_view`
* `Magento_Rma::rma`
* `Magento_Rma::magento_rma`
* `Magento_Rma::rma_attributes`
* `Vendor_Module::returns`
* `Magento_CatalogInventory::cataloginventory`
* `Magento_Store::store`
* `Magento_Config::config`
* `Magento_Inventory::inventory`
* `Magento_Customer::customer`

**⚠️ 중요:**

* Magento 인스턴스가 추가 API 레이어나 커스텀 엔드포인트(예: 사용자 정의 반품/RMA API)를 노출하는 경우, 당사와 협의하시기 바랍니다.
* Magento API를 통한 통합 없이 외부 반품 제공업체를 사용하는 경우, 반품 데이터 문서를 참조하거나 올바른 통합 방법을 선택하기 위해 당사와 협의하시기 바랍니다.

### 3. 자격 증명 활성화 및 검색

1. \*\*"저장"\*\*을 클릭하여 통합을 생성합니다.
2. 새로 생성된 통합에서 \*\*"활성화"\*\*를 클릭합니다.
3. 팝업에 귀하의 **OAuth 자격 증명**이 표시됩니다:
   * Consumer Key
   * Consumer Secret
   * Access Token
   * Access Token Secret
4. **이 자격 증명을 복사하세요** – Kleep 담당자에게 전송해야 합니다.

Magento 2 API 자격 증명 생성 및 검색에 대한 안내는 다음을 참조하세요:

> [Subscribe Pro 튜토리얼: Magento 2 API 자격 증명 생성 및 가져오기](https://docs.subscribepro.com/integrations/magento-2/installation/step-3-magento-api-connection/)
> [Adobe 공식 튜토리얼: Magento 2 OAuth 인증](https://developer.adobe.com/commerce/webapi/get-started/authentication/gs-authentication-oauth/)

### 4. Kleep에 자격 증명 전송

이메일을 통해 Kleep 담당자에게 다음 정보를 전송하세요:

1. **스토어의 완전한 API 기본 URL을 제공해 주세요.**
2. **OAuth1 자격 증명**
   * Consumer Key
   * Consumer Secret
   * Access Token
   * Access Token Secret

***

## 2단계: 프론트엔드 통합 (위젯)

*이 단계는 Kleep 스크립트를 제품 페이지(PDP)에 추가하는 것을 포함합니다. 모든 버전의 Magento와 호환됩니다.*

[**JS Library 위젯 가이드**](/ko/cms/js-library)를 따라 제품 페이지에 프론트엔드 CTA를 설치하고 구성하세요.

***

## 3단계: 누락 데이터 관리 (SFTP)

*이 섹션은 표준 API 엔드포인트를 통해 데이터를 검색할 수 없는 경우에 적용됩니다.*

Magento API가 반품 또는 특정 데이터 검색을 허용하지 않는 경우, CSV 파일 교환을 통해 진행합니다.

아래 문서를 참조하세요. 이 가이드는 누락 데이터 전송 과정을 단계별로 안내합니다:

***

## **4단계: 검증 및 프로덕션 배포**

### 1. 테스트 환경

먼저 **Preprod/Staging** 환경에 배포합니다.

### 2. 시각적 검증

실서비스 전환 전에 다음을 확인하세요:

* 버튼이 올바르게 표시되나요?
* 클릭 시 팝업(Drawer)이 열리나요?
* 브라우저 콘솔에 "CORS" 오류가 없나요?

### 3. 실서비스 전환

귀하와 Kleep 팀이 검증하면, **프로덕션** 테마에 수정 사항을 배포하세요.---

## 쿠키 및 데이터 개인정보 보호

Kleep는 방문자 동의에 의해 완전히 제어됩니다: 스크립트는 CMP를 통해 동의가 수집된 **후에만** 로드되며, 이에 따라 로딩을 조건화해야 합니다. 트래커의 전체 목록, 처리되는 데이터, 목적 및 법적 근거, 호스팅, 하위 처리자 및 보안에 대해서는 [쿠키, CMP 및 데이터 개인정보 보호](/ko/cookie-consent)를 참조하세요.