주 콘텐츠로 건너뛰기
버전: 1.x

SumUp 단말기 게이트웨이

SumUp 단말기 게이트웨이를 사용하면 WooCommerce POS 내에서 SumUp 카드 리더기를 사용하여 카드 결제를 수락할 수 있습니다. 이 게이트웨이는 오프라인 거래를 위한 SumUp의 결제 처리 시스템과 원활하게 통합됩니다.

기능​

하드웨어 통합

인터넷 연결을 통해 SumUp 카드 리더기를 POS 시스템에 연결합니다.

실시간 처리

즉시 결제 처리 및 주문 완료

안전한 거래

SumUp을 통한 PCI 준수 결제 처리

간편한 페어링

페어링 코드를 사용한 간단한 장치 페어링 과정

설치​

1

다운로드 및 설치

  1. SumUp Terminal for WooCommerce 릴리스 페이지를 방문합니다.
  2. 최신 sumup-terminal-for-woocommerce.zip 파일을 다운로드합니다.
  3. WordPress 관리자에서 플러그인 > 새로 추가 > 플러그인 업로드로 이동합니다.
  4. zip 파일을 업로드하고 플러그인을 활성화합니다.
2

SumUp 설정 구성

  1. WP 관리자 > WooCommerce > 설정 > 결제로 이동합니다.
  2. 결제 방법 목록에서 SumUp Terminal을 찾습니다.
  3. SumUp Terminal을 클릭하여 설정에 접근합니다.
  4. SumUp API 키를 입력합니다 (SumUp 상인 대시보드에서 확인 가능).
  5. 설정을 저장합니다.
참고

WooCommerce 설정에서 SumUp 단말기 게이트웨이를 활성화할 필요가 없습니다. 이후 단계에서 POS에 특별히 활성화됩니다.

3

SumUp 단말기 페어링

  1. 동일한 설정 페이지에서 리더 페어링 섹션을 찾습니다.
  2. SumUp 장치에서 페어링 화면으로 이동하여 페어링 코드를 표시합니다.
  3. SumUp 장치에 표시된 페어링 코드를 입력합니다.
  4. **"리더 페어링"**을 클릭하여 연결을 설정합니다.
  5. 리더가 성공적으로 페어링되었다는 확인을 기다립니다.
중요

결제를 처리하기 전에 리더가 성공적으로 페어링되어야 합니다. 진행하기 전에 페어링 과정이 완료되었는지 확인하십시오.

4

WooCommerce POS에서 활성화

  1. WP 관리자 > WooCommerce POS > 설정 > 결제로 이동합니다.
  2. 목록에서 SumUp Terminal 게이트웨이를 찾습니다.
  3. POS에서 사용하기 위해 게이트웨이를 활성화합니다.
  4. 설정을 저장합니다.

사용법​

결제 처리​

  1. 상품 추가: POS에서 장바구니에 상품을 추가합니다.
  2. 게이트웨이 선택: 결제 방법으로 "SumUp Terminal"을 선택합니다.
  3. 결제 시작: SumUp 장치에서 새 결제를 시작하도록 클릭합니다.
  4. 고객 결제: 고객이 SumUp 단말기에서 결제를 완료합니다.
  5. 자동 완료: 결제가 감지되면 주문이 자동으로 완료됩니다.

결제 제어​

SumUp 단말기 게이트웨이를 사용할 때 다음 옵션을 이용할 수 있습니다:

  • 새 결제 시작: 연결된 단말기에서 결제 요청을 시작합니다.
  • 결제 취소: 현재 진행 중인 결제를 취소합니다.
  • 결제 상태: 결제 처리의 현재 상태를 모니터링합니다.

주문 관리​

  • 자동 업데이트: 주문이 성공적인 결제 후 자동으로 완료로 표시됩니다.
  • 결제 추적: 모든 결제 세부 정보가 주문 메모에 기록됩니다.
  • 영수증 생성: 성공적인 결제 후 표준 POS 영수증이 생성됩니다.

요구사항​

SumUp 계정: 활성 SumUp 상인 계정
API 접근: 상인 대시보드에서의 SumUp API 키
호환 하드웨어: SumUp 카드 리더기 장치
WooCommerce POS: POS 체크아웃을 위한 Pro 버전 필요
안정적인 연결: API 통신을 위한 신뢰할 수 있는 인터넷 연결

하드웨어 호환성​

연결 요구사항

이 구현은 SumUp의 JavaScript SDK를 사용하며, 이는 웹 애플리케이션을 통해 작동하지만 인터넷에 연결된 단말기만 필요합니다. Bluetooth 단말기는 현재 지원되지 않습니다.

지원되는 단말기 (인터넷 연결됨)​

  • SumUp Solo ✅ - WiFi/Ethernet 연결 단말기

지원되지 않는 단말기 (Bluetooth)​

  • SumUp Air ❌ - Bluetooth 전용
  • SumUp 3G ❌ - Bluetooth 전용
향후 지원

Bluetooth 단말기 지원은 2026년 1분기에 iOS 및 Android 애플리케이션에 추가될 예정입니다. 이는 Air 및 3G 모델을 포함한 모든 SumUp 인증 단말기의 지원을 가능하게 합니다.

문제 해결​

일반적인 문제​

리더가 페어링되지 않음
  • 지원되는 인터넷 연결 단말기(Solo 전용)를 사용하고 있는지 확인합니다.
  • SumUp Solo 장치가 WiFi에 연결되어 온라인 상태인지 확인합니다.
  • 장치가 페어링 모드에 있고 페어링 코드가 정확히 입력되었는지 확인합니다.
  • SumUp 계정에 API 접근이 활성화되어 있는지 확인합니다.
  • 페어링 중 안정적인 인터넷 연결을 확보합니다.
결제가 처리되지 않음
  • 리더가 제대로 페어링되었는지 확인합니다.
  • SumUp 계정이 활성 상태인지 확인합니다.
  • 장치의 배터리와 연결 상태가 충분한지 확인합니다.
  • API 키가 올바르고 활성화되어 있는지 확인합니다.
주문이 완료되지 않음
  • 인터넷 연결의 안정성을 확인합니다.
  • SumUp 계정의 웹후크 설정을 확인합니다.
  • SumUp 단말기에서 결제가 성공적으로 처리되었는지 확인합니다.
  • API 통신 문제에 대한 WordPress 오류 로그를 확인합니다.

API 속도 제한​

게이트웨이는 API 호출을 줄이고 속도 제한을 피하기 위해 최적화되어 있습니다:

  • 결제 상태를 효율적으로 확인합니다.
  • 불필요한 API 요청을 최소화합니다.
  • 자동 재시도 로직으로 일시적인 실패를 처리합니다.

도움 받기​

기술 지원을 위해:

  • 문제를 신고하려면 GitHub 리포지토리를 방문합니다.
  • API 관련 질문에 대해서는 SumUp 개발자 문서를 확인합니다.
  • 계정 및 하드웨어 문제에 대해서는 SumUp 지원팀에 문의합니다.

스크린샷​

스크린샷은 다음 업데이트에 추가되어 다음을 보여줄 것입니다:

  • SumUp API 키 구성 및 장치 페어링 인터페이스
  • WooCommerce POS 설정에서 게이트웨이 활성화
  • POS 체크아웃에서의 결제 처리 워크플로