필요한 계정과 환경
- WooCommerce가 설치·활성화된 WordPress site와 관리자 권한이 필요합니다.
- 별도 WooCommerce 개발자 회원가입은 필요하지 않습니다.
- WordPress 관리자 → 설정 → 고유주소에서 '일반' 이외 형식을 선택해 저장합니다. '글 이름' 형식을 권장합니다.
- 쇼핑몰 기본 주소가 유효한 HTTPS 인증서를 사용하고 외부에서 접속 가능한지 확인합니다.
Consumer Key/Secret 발급
- WooCommerce 쇼핑몰의 WordPress 관리자 화면에 로그인합니다.
- WooCommerce → 설정 → 고급 → REST API로 이동합니다.
- API 키 생성 또는 키 추가를 선택합니다.
- 설명에는 'ORCA 주문 연동'처럼 용도를 알아볼 수 있는 이름을 입력합니다.
- 사용자는 계속 활성 상태로 유지할 관리자 또는 연동 전용 WordPress 사용자를 선택합니다.
- 권한은 주문 조회에 필요한 읽기(Read)로 선택합니다.
- API 키 생성을 누른 뒤 ck_로 시작하는 Consumer Key와 cs_로 시작하는 Consumer Secret을 즉시 복사합니다. Consumer Secret은 이 화면에서 한 번만 확인할 수 있습니다.
ORCA에 등록
- ORCA 로그인 → 연동관리 → 판매채널 관리로 이동합니다.
- 판매채널 추가에서 WooCommerce를 선택합니다.
- 채널 이름에는 ORCA에서 구분할 쇼핑몰 이름을 입력합니다.
- 사이트 URL에는 /wp-admin 또는 /wp-json 경로를 제외한 쇼핑몰 HTTPS 기본 주소를 입력합니다. 예: https://shop.example.com
- 발급 화면에서 복사한 Consumer Key와 Consumer Secret을 입력합니다.
- 연결 테스트를 실행하고 성공 메시지를 확인한 뒤 저장합니다.
ORCA Sales Channel Management →
보안과 문제 확인
- Legacy REST API key가 아니라 현재 WordPress REST API key를 사용합니다.
- 401 또는 403 오류는 Key/Secret 오입력, 연결 사용자 비활성화, 읽기 권한을 확인합니다.
- 404 오류는 WordPress 고유주소가 '일반'인지와 https://사이트주소/wp-json/wc/v3 접근 여부를 확인합니다.
- SSL 오류는 사이트 HTTPS 인증서의 유효기간과 인증서 체인을 확인합니다.
- Secret을 잃어버리면 복구할 수 없으므로 기존 key를 폐기하고 새 key를 생성합니다.