PayPal 리더(Zettle) 게이트웨이
PayPal 리더 게이트웨이를 사용하면 WCPOS에서 직접 PayPal 리더(Zettle) 카드 단말기를 사용하여 직접 카드 결제를 허용할 수 있습니다. 브라우저는 Zettle의 Reader Connect API에 대한 보안 연결을 통해 리더에서 실시간 결제 상태를 스트리밍하므로 계산원은 결제의 각 단계를 실시간으로 확인할 수 있습니다.
특징
직접카드결제
PayPal 리더(Zettle) 터미널에서 칩, 비접촉식 및 모바일 지갑 결제를 이용하세요.
실시간 결제현황
POS는 연결 중, 결제 진행 중, 완료 또는 취소 등 실시간 진행 상황을 표시합니다.
서버측에서 확인된 금액
보고된 금액은 주문이 이루어지기 전에 항상 주문 총액과 비교하여 확인됩니다.
간단한 페어링
장치에 표시된 페어링 코드를 사용하여 게이트웨이 설정에서 리더를 연결하세요.
요구사항
PayPal 리더/Zettle 가용성, 지원되는 리더 모델 및 지원 국가는 WCPOS가 아닌 Zettle 판매자 계정에 따라 결정됩니다. 구매하기 전에 PayPal/Zettle가 지원되는 리더와 지역인지 확인하세요.
설치
WooCommerce용 PayPal 리더 설치
WP Admin > POS > Settings > Extensions에서 설치하거나 GitHub 릴리스 페이지에서 최신 플러그인 zip 자산(GitHub 소스 코드 zip 또는 tarball 아님)을 다운로드하고 Plugins > Add New > Upload Plugin를 통해 업로드하세요. WooCommerce가 설치되어 활성화되어 있어야 합니다.
게이트웨이 구성
WP Admin > WooCommerce > Settings > Payments로 이동합니다.- 결제 방법 목록에서 PayPal Reader를 찾아 해당 설정을 엽니다.
- 설정을 확인하는 동안 테스트 모드 활성화를 켜두세요. 테스트 모드에서 Zettle 개발자 판매자 계정의 자격 증명을 사용하세요. 나중에 실시간 결제를 받으려면 비활성화하세요.
- Zettle 클라이언트 ID를 입력하세요. — Zettle 개발자 포털의 Zettle OAuth 클라이언트 ID입니다.
- Zettle 어설션, 즉 Zettle OAuth 어설션(JWT)을 입력하세요. 이 내용은 비밀로 취급됩니다
- 선택적으로 고객에게 표시되는 제목 및 설명을 설정하세요.
- 설정 저장
'웹 체크아웃을 위해 PayPal 리더 활성화' 확인란은 온라인 상점의 체크아웃 전용입니다. POS에는 필요하지 않습니다. 이후 단계에서 POS에 대한 게이트웨이를 활성화합니다.
리더를 페어링하세요
- 저장 후 설정 화면 하단의 페어링된 리더 섹션으로 스크롤하세요. (클라이언트 ID와 Assertion이 저장되면 나타남)
- PayPal 리더 장치에서 설정 → 개발자와 연결을 열어 페어링 코드를 표시하세요.
- 새 리더 페어링에서 페어링 코드를 입력하고 선택적으로 리더 이름(예: '전면 카운터')을 입력합니다.
- 리더 페어링을 클릭합니다. 리더가 페어링된 목록에 나타나고 결제를 받을 준비가 되었습니다.
결제를 받으려면 먼저 리더가 성공적으로 페어링되어야 합니다. 리더를 제거하려면 페어링된 목록에서 Unpair를 사용하세요.
WCPOS에서 활성화
WP Admin > POS > Settings > Checkout로 이동- 목록에서 PayPal Reader 게이트웨이를 찾으세요.
- POS에서 사용하도록 활성화합니다.
- 설정 저장
결제 받기
- POS의 장바구니에 항목을 추가하고 결제를 진행하세요.
- 결제 방법으로 PayPal Reader를 선택하세요.
- 페어링된 리더기를 선택하고 결제를 시작하세요. (페어링된 항목이 없으면 매장 관리자에게
WooCommerce → Settings → Payments → PayPal Reader에서 페어링하도록 요청하라는 메시지가 표시됩니다.) - POS는 연결 시 실시간 상태를 표시합니다. '리더에 연결 중…', '리더 준비됨. 결제 요청 중…', '결제 진행 중…'
- 고객이 리더기에 카드를 탭하거나 삽입합니다.
- 성공하면 주문 총액과 금액이 확인되고 거래 참조가 기록되며 자동으로 주문이 이루어집니다.
- 리더기에서 요청을 취소하려면 언제든지 결제 취소를 사용하세요.
실시간 스트리밍 중
테스트 모드에서 모든 것을 확인한 후:
- 테스트 모드 활성화 비활성화
- Zettle 테스트 자격 증명을 프로덕션 클라이언트 ID 및 어설션으로 바꾸세요.
- 저장 - 끝점과 흐름이 동일합니다. 판매자 계정만 다릅니다
요구 사항 요약 및 제한 사항
- 주문은 리더 결과가 확인된 후에만 완료됩니다. WCPOS는 결제가 완료되었다고 보고하지 않으면 주문을 하지 않습니다.
- 금액 불일치 방지. 독자가 보고한 금액이 주문 총액과 일치하지 않으면 결제가 거부됩니다. 결제 도중 장바구니 총액을 편집하지 마세요.
- 연결성. 실시간 결제는 Zettle의 리더 연결 API에 대한 세션을 유지하는 브라우저에 따라 달라집니다. 안정적인 인터넷 연결이 필요합니다.
문제 해결
페어링된 독자 섹션이 표시되지 않습니다.
먼저 Zettle 클라이언트 ID와 어설션을 저장하세요. 페어링 패널은 두 자격 증명이 모두 저장된 후에만 나타납니다. 그렇지 않으면 _'리더를 페어링하기 전에 위의 Zettle 클라이언트 ID 및 어설션을 저장하십시오.'_가 표시됩니다.
리더가 페어링되지 않음
- 리더에서 설정 → 개발자와 연결을 열어 새로운 페어링 코드를 받았는지 확인하세요.
- 만료되기 전에 표시된 대로 코드를 정확하게 입력하세요.
- Zettle 클라이언트 ID와 어설션이 정확하고 저장되었는지 확인하세요.
- 리더와 네트워크가 안정적인 인터넷 연결을 가지고 있는지 확인하십시오.
금액이 일치하지 않아 결제가 거부되었습니다.
플러그인은 주문 총액에 대해 독자가 보고한 금액을 확인하고 불일치를 거부합니다. 결제가 진행되는 동안 장바구니 또는 주문 총액을 변경하지 마십시오. 결제를 취소하고 장바구니를 조정한 다음 새 결제를 시작하십시오.
실제 결제가 처리되지 않습니다. / '모의리더'에 대한 관리자 경고가 나타납니다.
개발/CI 상수(PRWC_USE_MOCK_READER)는 wp-config.php에 정의됩니다. 실시간 결제를 받기 전에 해당 상수를 제거하세요. 설정된 동안에는 실제 결제가 처리되지 않습니다.
도움 받기
- GitHub 저장소의 게이트웨이 문제를 보고하세요.
- 계정, 리더 하드웨어 및 지역별 가용성에 대한 질문은 PayPal/Zettle 지원팀에 문의하세요.