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

스트라이프 터미널 게이트웨이

스트라이프 터미널 게이트웨이를 사용하면 WooCommerce POS 내에서 스트라이프 터미널 하드웨어 리더를 사용하여 대면 결제를 수락할 수 있습니다. 이 게이트웨이는 물리적 카드 리더와 테스트용 시뮬레이터 모드를 모두 지원합니다.

기능​

하드웨어 통합

인터넷 연결을 통해 물리적 스트라이프 터미널 리더 연결

시뮬레이터 모드

스트라이프의 시뮬레이터를 사용하여 하드웨어 없이 결제 테스트

실시간 처리

즉각적인 결제 처리 및 확인

안전한 거래

스트라이프를 통한 PCI 준수 결제 처리

설치​

1

다운로드 및 설치

  1. WooCommerce용 스트라이프 터미널 릴리스 페이지 방문
  2. 최신 stripe-terminal-for-woocommerce.zip 파일 다운로드
  3. WordPress 관리에서 플러그인 > 새로 추가 > 플러그인 업로드로 이동
  4. zip 파일 업로드 후 플러그인 활성화
2

스트라이프 설정 구성

  1. WP 관리 > WooCommerce > 설정 > 결제로 이동
  2. 결제 방법 목록에서 스트라이프 터미널 찾기
  3. 스트라이프 터미널을 클릭하여 설정을 엽니다
  4. 스트라이프 비밀 키 입력 (이 키는 스트라이프 대시보드에서 얻을 수 있습니다)
  5. 설정 저장
참고

WooCommerce 설정에서 스트라이프 터미널 게이트웨이를 활성화할 필요가 없습니다. 다음 단계에서 POS 전용으로 활성화됩니다.

3

WooCommerce POS에서 활성화

  1. WP 관리 > WooCommerce POS > 설정 > 체크아웃으로 이동
  2. 목록에서 스트라이프 터미널 게이트웨이 찾기
  3. POS에서 사용하기 위해 게이트웨이를 활성화
  4. 설정 저장

사용법​

리더 연결​

POS의 체크아웃 중 스트라이프 터미널 게이트웨이를 선택하면:

  1. 연결 방법 선택: 물리적 리더를 연결하거나 시뮬레이터를 사용할 수 있습니다
  2. 물리적 리더: 화면의 지시에 따라 스트라이프 터미널 장치 연결
  3. 시뮬레이터: 하드웨어 없이 다양한 결제 시나리오를 테스트하기 위해 시뮬레이터 모드 선택

결제 처리​

  1. 아이템 추가: POS에서 장바구니에 제품 추가
  2. 게이트웨이 선택: 결제 방법으로 "스트라이프 터미널" 선택
  3. 리더 연결: 리더를 연결하거나 시뮬레이터 모드 선택
  4. 결제 처리: 거래를 완료하기 위한 안내에 따라 진행
  5. 확인: 성공적인 결제가 이루어지면 주문이 자동으로 완료됨

시뮬레이터로 테스트​

시뮬레이터를 사용하여 다양한 결제 방법과 시나리오를 테스트할 수 있습니다:

  • 카드 결제: 다양한 카드 종류(Visa, Mastercard 등) 테스트
  • 직접 결제: 탭으로 결제하는 거래 시뮬레이션
  • 오류 시나리오: 결제 거절 및 기타 오류 조건 테스트
  • 다양한 금액: 다양한 거래 금액 테스트

요구 사항​

스트라이프 계정: 터미널이 활성화된 활성 스트라이프 계정
API 키: 대시보드에서 가져온 스트라이프 비밀 키
WooCommerce POS: POS 체크아웃을 위한 Pro 버전 필요
HTTPS: 사이트는 보안을 위해 SSL/HTTPS를 사용해야 함

하드웨어 호환성​

연결 요구 사항

이 구현은 스트라이프의 JavaScript SDK를 사용하므로 웹 애플리케이션을 통해 작동하지만 인터넷에 연결된 터미널만 필요합니다. 블루투스 터미널은 현재 지원되지 않습니다.

지원되는 터미널 (인터넷 연결)​

  • 스트라이프 리더 S700 ✅ - 이더넷/WiFi 연결된 터미널
  • WisePOS E ✅ - WiFi 연결된 터미널

지원되지 않는 터미널 (블루투스)​

  • BBPOS Chipper 2X BT ❌ - 블루투스 전용
  • BBPOS WisePad 3 ❌ - 블루투스 전용
  • Verifone P400 ❌ - 블루투스 전용
향후 지원

블루투스 터미널 지원은 2026년 1분기에 iOS 및 Android 애플리케이션에 추가됩니다. 이로 인해 M2 및 WisePad 3을 포함한 모든 스트라이프 터미널 인증 리더에 대한 지원이 가능해집니다.

일반적인 문제​

리더가 연결되지 않음
  • 지원되는 인터넷 연결 터미널(S700 또는 WisePOS E)을 사용하고 있는지 확인
  • 터미널이 WiFi/Ethernet에 연결되어 온라인인지 확인
  • 스트라이프 계정에 터미널이 활성화되어 있는지 확인
  • 스트라이프 대시보드에서 터미널이 등록되어 있는지 확인
결제 거절됨
  • 스트라이프 계정이 활성 상태이며 양호한지 확인
  • 사용 중인 카드가 유효한지 확인
  • 충분한 자금이 있는지 확인
SSL 인증서 오류
  • 스트라이프 터미널은 HTTPS가 필요하므로, 사이트에 유효한 SSL 인증서가 있는지 확인
  • SSL 인증서가 제대로 구성되어 있는지 확인

도움 받기​

기술 지원을 위해:

스크린샷​

스크린샷은 다음 업데이트에 추가되어 다음 내용을 보여줍니다:

  • WooCommerce 결제 설정에서 게이트웨이 구성
  • 스트라이프 터미널 선택이 있는 POS 체크아웃 인터페이스
  • 다양한 결제 방법으로 시뮬레이터 테스트 인터페이스