연동가이드

Appearance

프론트 연동 시작하기 ​

프론트 연동 방법 ​

프론트는 다음 두 가지 방법 중 하나를 선택하여 연동할 수 있어요.

1. 프론트 플러그인 SDK ​

업종별 맞춤 UI와 결제 기능을 통합하여 개발하고 싶은 경우에 적합해요.

특징:

  • 업종별 맞춤 UI/UX 제공
  • 외부 시스템(EMR, CRM 등)과 연동
  • 모든 결제 수단 지원
  • Template API 기반 일관된 디자인

적합한 사례: 병원, 약국, 학원, 뷰티샵 등 업종별 특화 솔루션

2. 프론트 Windows DLL ​

기존 Windows POS 시스템에 결제 기능만 추가하고 싶은 경우에 적합해요.

특징:

  • 기존 POS 시스템 그대로 유지
  • 최소한의 개발로 결제 기능 추가
  • Windows 환경 전용

적합한 사례: 기존 Windows POS 시스템 운영 중인 대규모 POS사 또는 프랜차이즈

참고

DLL 연동은 일정 규모 이상의 POS사 또는 프랜차이즈를 대상으로 제한적으로 지원하고 있어요. 개발 문서는 프론트 DLL 연동 가이드에서 확인할 수 있고, DLL 파일과 예제 소스는 개별 검토 후 제공해요. DLL 연동을 검토 중이라면, 아래 내용을 먼저 확인해주세요.

  • 현재 제공되는 API / 시리얼 / 웹소켓 방식으로 구현이 어려운 이유가 있으신가요?
  • DLL 연동이 반드시 필요한 구체적인 이유가 있으신가요?

DLL 연동 관련 질문은 개발자 포럼에 남겨주세요. 파일 제공을 위한 개별 검토가 필요한 경우 위 내용과 함께 연동 목적 및 서비스 규모를 개발자센터 메일로 보내주세요.

자주 묻는 질문 ​

결제 기능 ​

어떤 결제 수단을 사용할 수 있나요? ​

A. 프론트 단말기에서 지원하는 모든 결제 수단을 사용할 수 있어요.

  • 카드 결제: 신용카드, 체크카드 (IC카드, 마그네틱카드)
  • NFC 결제: 삼성페이, 애플페이 등
  • QR/바코드: 토스페이, 카카오페이, 네이버페이 등
  • 현금: 현금 수령 후 현금영수증 발행 가능

결제 승인과 승인 취소는 어떻게 하나요? ​

A. SDK의 payment 모듈을 통해 간단하게 결제를 요청할 수 있어요.

하드웨어 기능 ​

카메라 기능을 사용할 수 있나요? ​

A. 네, QR/바코드 스캔을 위한 카메라 기능을 제공해요. Reference 바로가기

javascript
// Template API를 통한 QR 스캔
sdk.template.renderQRScanPage({
  title: 'QR을 화면에 스캔해주세요',
  onSuccess: data => {
    console.log("스캔 결과:", data.value);
  },
  onBack: () => {
    console.log("취소됨");
  }
});

프린터 기능을 사용할 수 있나요? ​

A. 네, 영수증 프린터를 통해 출력이 가능해요. Reference 바로가기

javascript
await sdk.printer.printReceipt({
  paymentKey: "paymentKey-abc123",  // 결제 요청 시에 전달한 paymentKey
  count: 1,
  additionalText: "감사합니다"
});

NFC 기능을 사용할 수 있나요? ​

A. NFC는 결제 용도로만 사용 가능하며, 별도 NFC 태그 읽기는 지원하지 않아요.

UI/UX 기능 ​

Template API를 꼭 사용해야 하나요? ​

A. 네, 프론트 플러그인은 반드시 Template API를 사용해야 해요.

  • 일관된 UI: 토스플레이스 디자인 가이드라인 준수
  • 검수 통과: 디자인 검수 시 필수 요구사항

자세한 내용은 화면 구성 가이드를 참고하세요.

다국어 지원이 가능한가요? ​

A. 네, 일부 페이지에서 다국어 지원이 가능해요. Reference 바로가기

javascript
// Template API에서 언어 설정
sdk.template.renderOrderPage({
  localeCode: "en", // "ko" 또는 "en"
  order: {
    items: [
      {
        label: 'Americano', // 영어일 경우 직접 영어로 입력
        value: 3000
      }
    ],
    summary: {
      totalAmount: 3000,
      discountAmount: 0
    }
  }
});

연동 및 배포 ​

새 버전 출시 후 단말기를 재부팅해야 반영되나요? ​

A. 아니요, 자동으로 업데이트돼요.

  • 새 버전 배포 시 자동으로 반영
  • 단말기 재부팅 불필요

실제 매장에 설치하려면 어떻게 해야 하나요? ​

A. VAN 대리점을 통해 설치해야 해요.

  1. 라이브 배포 검수 통과 필수
  2. VAN 대리점을 통한 매장별 플러그인 활성화

자세한 내용은 플러그인 배포 가이드를 참고하세요.