스크립트 직접 로드 방식 개발 가이드

시작하기

1. SDK 불러오기

SDK를 불러와서 플러그인 개발을 시작해요.

js

// SDK 불러오기 (아래 버전은 예시예요. 최신 버전을 확인해서 사용해주세요)
importScripts('https://sdk.tossplace.com/pos-plugins/umd/0.0.27/pos-plugin-sdk.js');

// 카테고리 목록 조회 예시
(window as any).posPluginSdk.category.getCategories()
    .then((categories) => {
        console.log('카테고리 목록:', categories);
    })
    .catch((error) => {
        console.error('카테고리 조회 실패:', error);
    });

최신 버전 확인

URL에 들어가는 버전은 예시예요. 최신 버전은 npm 패키지 페이지에서 확인해주세요.

버전별로 어떤 기능이 추가·변경됐는지는 POS Plugin SDK 변경 이력에서 볼 수 있어요.

배포 가이드

1. 파일 구조

배포를 위한 zip 파일의 구조는 다음과 같아요:

플러그인.zip
└─ 플러그인_디렉토리
   └─ main.js    // 메인 스크립트 파일

2. 파일 제약사항

• zip 파일명: 자유롭게 지정 가능
• 디렉토리명: 자유롭게 지정 가능
• 메인 파일: 반드시 main.js로 지정

3. 배포 프로세스

1. 개발 완료된 스크립트를 main.js로 저장
2. 디렉토리와 함께 zip 파일로 압축
3. 토스플레이스 개발자센터에 업로드
4. 플러그인 검수 및 배포 진행

주의사항

• 웹 워커 환경: 모든 코드는 웹 워커 환경에서 실행됨을 고려
• 에러 처리: Promise 체인에서 적절한 에러 처리 구현
• 타입 안전성: TypeScript와 달리 타입 체크가 없으므로 주의 필요