Stripe Terminal 게이트웨이
Stripe Terminal 게이트웨이를 사용하면 WCPOS 내에서 Stripe Terminal 하드웨어 리더기를 통해 대면 결제를 직접 수락할 수 있습니다. 이 게이트웨이는 물리적 카드 리더기와 테스트용 시뮬레이터 모드를 모두 지원합니다.
기능
하드웨어 연동
인터넷 연결을 통해 물리적 Stripe Terminal 리더기를 연결합니다
시뮬레이터 모드
Stripe 시뮬레이터를 사용하여 하드웨어 없이 결제를 테스트합니다
실시간 처리
즉각적인 결제 처리 및 확인
안전한 거래
Stripe를 통한 PCI 규격 준수 결제 처리
전화 주문 (MOTO)
리더기에 카드 정보를 직접 입력하여 전화로 카드 결제를 받을 수 있습니다
설치
Stripe Terminal for WooCommerce 설치
WP Admin > POS > 설정 > 확장에서 설치하거나, GitHub 릴리스 페이지에서 최신 플러그인 zip 파일(GitHub 소스 코드 zip 또는 tarball이 아님)을 다운로드한 후 플러그인 > 새로 추가 > 플러그인 업로드를 통해 업로드하세요.
Stripe 설정 구성
WP Admin > WooCommerce > 설정 > 결제로 이동합니다- 결제 수단 목록에서 Stripe Terminal을 찾습니다
- Stripe Terminal을 클릭하여 설정에 접근합니다
- Stripe Secret Key를 입력합니다(Stripe Dashboard에서 확인할 수 있습니다)
- 설정을 저장합니다
WooCommerce 설정에서 Stripe Terminal 게이트웨이를 활성화할 필요는 없습니다. 다음 단계에서 POS 전용으로 활성화됩니다.
WCPOS에서 활성화
WP Admin > POS > 설정 > 결제로 이동하세요- 목록에서 Stripe Terminal 게이트웨이를 찾으세요
- POS에서 사용할 수 있도록 게이트웨이를 활성화하세요
- 설정을 저장하세요
사용 방법
리더기 연결
POS에서 결제 시 Stripe Terminal 게이트웨이를 선택하면:
- 연결 방법 선택: 실제 리더기를 연결하거나 시뮬레이터를 사용할 수 있습니다
- 물리적 리더기: 화면의 안내에 따라 Stripe Terminal 장치를 연결하세요
- 시뮬레이터: 하드웨어 없이 다양한 결제 시나리오를 테스트하려면 시뮬레이터 모드를 선택하세요
결제 처리
- 상품 추가: POS에서 장바구니에 상품을 추가하세요
- 게이트웨이 선택: 결제 수단으로 "Stripe Terminal"을 선택하세요
- 리더기 연결: 리더기를 연결하거나 시뮬레이터 모드를 선택하세요
- 결제 처리: 안내에 따라 거래를 완료하세요
- 확인: 결제가 성공하면 주문이 자동으로 완료됩니다
시뮬레이터로 테스트
시뮬레이터를 사용하면 다양한 결제 수단과 시나리오를 테스트할 수 있습니다:
- 카드 결제: 다양한 카드 유형(Visa, Mastercard 등)을 테스트하세요
- 비접촉 결제: 탭 투 페이 거래를 시뮬레이션하세요
- 오류 시나리오: 결제 거부 및 기타 오류 상황을 테스트합니다
- 다양한 금액: 다양한 거래 금액을 테스트합니다
전화 주문 (MOTO)
MOTO(Mail Order/Telephone Order)는 고객이 물리적으로 매장에 없는 경우(예: 전화로 주문을 받는 경우) 카드 결제를 처리할 수 있는 기능입니다. 카드를 탭하거나 삽입하는 대신, 판매자가 터미널 리더 화면에 카드 정보를 직접 입력합니다.
설정
Stripe에 MOTO 액세스 요청
MOTO는 기본적으로 활성화되어 있지 않습니다. Stripe 지원팀에 문의하여 계정에 대한 MOTO 권한 활성화를 요청하세요. 빠르게 처리되지만 Stripe의 수동 승인이 필요합니다.
플러그인 설정에서 활성화
WP Admin > WooCommerce > 설정 > 결제 > Stripe Terminal로 이동합니다- 전화 주문 (MOTO) 체크박스를 선택합니다
- 설정을 저장합니다
호환 리더 연결
MOTO는 지원되는 단말기에 나열된 호환 가능한 인터넷 연결 리더기에서만 작동합니다. 다른 리더기 유형에서는 토글이 표시되지 않습니다.
전화 주문 처리
- 호환 가능한 리더기를 연결합니다(지원되는 단말기 참조)
- 결제 화면에서 전화 주문을 켭니다
- 카드 결제 받기를 클릭합니다 — 리더기에 탭/삽입 안내 대신 카드 번호 입력 화면이 표시됩니다
- 리더기에서 고객의 카드 번호, 유효기간, CVV를 입력합니다
- 이후 결제는 정상적으로 진행됩니다
MOTO 결제는 결제 수단 유형으로 card가 아닌 card_present를 사용합니다. 따라서 Stripe 관점에서는 온라인 거래와 더 유사하게 처리되므로 대면 결제 요금이 아닌 일반 온라인 카드 처리 수수료가 적용됩니다.
전화 주문 토글은 다음 세 가지 조건이 모두 충족될 때만 표시됩니다: 플러그인 설정에서 MOTO 설정이 활성화되어 있고, 호환 가능한 리더기가 연결되어 있으며, 리더기가 시뮬레이터가 아닌 경우입니다. 토글이 보이지 않으면 이 조건들을 확인하십시오.
요구 사항
하드웨어 호환성
이 구현은 Stripe의 JavaScript SDK를 사용하므로 웹 애플리케이션을 통해 작동하지만 인터넷에 연결된 단말기만 지원합니다. 블루투스 단말기는 현재 지원되지 않습니다.
지원 단말기 (인터넷 연결)
- Stripe Reader S700/S710 ✅ - 이더넷/WiFi 연결 단말기
- WisePOS E ✅ - WiFi 연결 단말기
WCPOS는 위에 나열된 인터넷 연결 리더기인 Stripe Reader S700/S710 및 BBPOS WisePOS E와 함께 작동합니다. Stripe Terminal 및 각 리더기를 이용할 수 있는 국가는 WCPOS가 아닌 Stripe에서 정합니다. 리더기를 구매하기 전에 Stripe의 Terminal 전 세계 이용 가능 여부 페이지와 국가별 리더기 이용 가능 여부 표를 확인하세요.
2026년 11월 3일 기준, Stripe는 Terminal 이용 가능 국가로 호주, 오스트리아, 벨기에, 캐나다, 체코, 덴마크, 핀란드, 프랑스, 독일, 아일랜드, 이탈리아, 일본, 룩셈부르크, 말레이시아, 네덜란드, 뉴질랜드, 노르웨이, 포르투갈, 싱가포르, 스페인, 스웨덴, 스위스, 영국 및 미국을 안내합니다. 미리보기 이용 가능 국가는 불가리아, 크로아티아, 키프로스, 에스토니아, 홍콩, 헝가리, 라트비아, 리히텐슈타인, 리투아니아, 몰타, 폴란드, 루마니아, 슬로바키아 및 슬로베니아입니다. 지브롤터와 멕시코는 Tap to Pay만 이용할 수 있는 국가로 안내되어 있습니다. 리더기 모델은 국가마다 다르므로 해당 국가에 대한 Stripe의 표를 확인하세요.
이탈리아: 이탈리아에서 Stripe Terminal을 이용할 수 있으며, Stripe는 이탈리아에서 사용할 수 있는 리더기로 Stripe Reader S700, S710 및 BBPOS WisePOS E를 안내합니다.
Stripe는 리더기가 등록된 Terminal Location을 통해 국가별 설정을 적용하며, Location을 만든 후에는 국가를 변경할 수 없습니다. 리더기를 사용할 국가의 Location에 등록하세요.
미지원 단말기 (블루투스)
- BBPOS Chipper 2X BT ❌ - 블루투스 전용
- BBPOS WisePad 3 ❌ - 블루투스 전용
- Verifone P400 ❌ - 블루투스 전용
블루투스 단말기 지원은 향후 iOS 및 Android 앱 릴리스에 추가될 예정입니다. 이를 통해 M2 및 WisePad 3을 포함한 모든 Stripe Terminal 인증 리더기를 지원할 수 있게 됩니다.
일반적인 문제
리더기가 연결되지 않음
- 지원되는 인터넷 연결 단말기를 사용하고 있는지 확인하세요
- 단말기가 WiFi/이더넷에 연결되어 있고 온라인 상태인지 확인하세요
- Stripe 계정에서 Terminal이 활성화되어 있는지 확인하세요
- 단말기가 Stripe 대시보드에 등록되어 있는지 확인하세요
결제 거부됨
- Stripe 계정이 활성 상태이며 정상적으로 유지되고 있는지 확인하세요
- 사용 중인 카드가 유효한지 확인하세요
- 잔액이 충분한지 확인하세요
전화 주문 토글이 표시되지 않음
WooCommerce > 설정 > 결제 > Stripe Terminal에서 전화 주문(MOTO) 설정이 활성화되어 있는지 확인하세요- 호환되는 리더기에 연결되어 있는지 확인하세요(지원되는 단말기 참조) — 다른 리더기 유형에서는 토글이 표시되지 않습니다
- 시뮬레이터를 사용할 때는 토글이 표시되지 않습니다
MOTO 결제가 오류와 함께 실패함
- Stripe에서 계정에 MOTO 권한을 활성화했는지 확인하세요 — 아직 요청하지 않았다면 Stripe 지원팀에 문의하세요
- 리더기에 카드 정보가 올바르게 입력되었는지 다시 확인하세요
- MOTO 결제는 더 엄격한 사기 방지 검사가 적용될 수 있습니다 — 카드가 유효하고 잔액이 충분한지 확인하세요
SSL 인증서 오류
- Stripe Terminal은 HTTPS가 필요합니다 - 사이트에 유효한 SSL 인증서가 설치되어 있는지 확인하세요
- SSL 인증서가 올바르게 구성되어 있는지 확인하세요
도움 받기
기술 지원:
- 문제를 보고하려면 GitHub 저장소를 방문하세요
- 하드웨어 관련 안내는 Stripe Terminal 문서를 참조하세요
- 계정 관련 문제는 Stripe 지원팀에 문의하세요
스크린샷
다음 항목을 보여주는 스크린샷이 향후 업데이트에서 추가될 예정입니다:
- WooCommerce 결제 설정의 게이트웨이 구성
- Stripe Terminal이 선택된 POS 결제 화면
- 다양한 결제 수단이 표시된 시뮬레이터 테스트 화면