Vipps MobilePay 게이트웨이
Vipps MobilePay 게이트웨이를 통해 WooCommerce POS 내에서 전화 기반 결제를 직접 수락할 수 있습니다. 고객은 화면의 QR 코드를 스캔하거나 전화에서 푸시 알림을 확인하여 결제합니다. 카드 리더 하드웨어는 필요 없습니다.
기능
QR 코드 결제
고객이 스캔하여 전화로 결제할 수 있도록 체크아웃에서 QR 코드를 표시합니다.
푸시 알림
고객의 전화번호를 입력하여 고객의 전화로 직접 결제 요청을 전송합니다.
Nordic 커버리지
노르웨이의 Vipps, 덴마크와 핀란드의 MobilePay와 함께 작동합니다.
자동 캡처
승인 직후 자금을 즉시 캡처하거나 수동 캡처를 위해 예약합니다.
설치
다운로드 및 설치
- WCPOS Vipps MobilePay 릴리스 페이지에 방문합니다.
- 최신 wcpos-vipps.zip 파일을 다운로드합니다.
- WordPress 관리 화면에서
Plugins > Add New > Upload Plugin으로 이동합니다. - zip 파일을 업로드하고 플러그인을 활성화합니다.
Vipps 자격 증명 구성
WP Admin > WooCommerce > Settings > Payments로 이동합니다.- 결제 수단 목록에서 WCPOS Vipps MobilePay를 찾습니다.
- WCPOS Vipps MobilePay를 클릭하여 설정에 접근합니다.
- Vipps 포털에서 자격 증명을 입력합니다:
- 상인 일련 번호 (MSN)
- 클라이언트 ID
- 클라이언트 비밀
- 구독 키
- 설정을 저장합니다.
여기에서 POS 사용을 위해 게이트웨이를 활성화할 필요는 없습니다. 다음 단계에서 POS를 위해 특별히 활성화됩니다. WooCommerce 설정에서 활성화하면 온라인 상점 체크아웃에서도 사용 가능하게 되어 테스트에 유용할 수 있습니다.
공식 Vipps MobilePay로 체크아웃 플러그인이 설치된 경우, 이 플러그인을 활성화하면 자격 증명이 자동으로 가져와집니다. 수동 자격 증명 입력을 건너뛸 수 있습니다.
WooCommerce POS에서 활성화
WP Admin > WooCommerce POS > Settings > Checkout로 이동합니다.- 목록에서 WCPOS Vipps MobilePay 게이트웨이를 찾습니다.
- POS 사용을 위해 게이트웨이를 활성화합니다.
- 설정을 저장합니다.
사용법
결제 처리 — QR 코드
- 상품 추가: POS에 카트에 제품을 추가합니다.
- 게이트웨이 선택: 결제 수단으로 "Vipps MobilePay"를 선택합니다.
- QR 코드 생성: "QR 코드 생성" 버튼을 클릭합니다.
- 고객 스캔: 고객이 Vipps 또는 MobilePay 앱으로 QR 코드를 스캔합니다.
- 고객 확인: 고객이 앱에서 결제를 확인합니다.
- 자동 완료: 결제가 승인되면 주문이 자동으로 완료됩니다.
결제 처리 — 푸시 알림
- 상품 추가: POS에 카트에 제품을 추가합니다.
- 게이트웨이 선택: 결제 수단으로 "Vipps MobilePay"를 선택합니다.
- 전화번호 입력: 고객의 전화번호를 입력합니다.
- 전화로 전송: "전화로 전송" 버튼을 클릭합니다.
- 고객 확인: 고객이 푸시 알림을 받고 앱에서 결제를 확인합니다.
- 자동 완료: 결제가 승인되면 주문이 자동으로 완료됩니다.
결제 취소
고객이 확인하기를 기다리는 동안, 결제 취소 버튼을 클릭하여 거래를 중단할 수 있습니다. 이는 Vipps 측에서 보류 중인 결제를 취소하고 체크아웃 인터페이스를 초기화합니다.
환불
환불은 표준 WooCommerce 환불 프로세스를 통해 처리됩니다. 주문을 열고 환불을 클릭한 다음 금액을 입력하면 환불이 Vipps API를 통해 자동으로 처리됩니다.
지원되는 시장
Vipps MobilePay는 두 브랜드로 북유럽 지역에서 운영됩니다:
| 지역 | 브랜드 | 통화 |
|---|---|---|
| 노르웨이 | Vipps | NOK |
| 덴마크, 핀란드 | MobilePay | DKK, EUR |
상인 계정에 따라 사용 가능한 시장과 통화가 결정됩니다. 지원되는 시장의 고객은 현지 Vipps 또는 MobilePay 앱을 사용하여 결제할 수 있습니다.
요구 사항
문제 해결
일반적인 문제
결제가 완료되지 않음
- 체크아웃은 최대 5분 동안 폴링합니다. 고객이 그 시간 내에 확인하지 않으면 결제가 시간 초과됩니다.
- 테스트 모드와 프로덕션 자격 증명을 혼동하지 않도록 확인합니다.
- POS 장치와 고객의 전화 모두에서 인터넷 연결이 안정적인지 확인합니다.
자격 증명 오류
- 모든 네 개의 자격 증명 필드 (MSN, 클라이언트 ID, 클라이언트 비밀, 구독 키)를 다시 확인합니다.
- 테스트 모드가 활성화된 경우 테스트 자격 증명을 사용하고 비활성화된 경우 프로덕션 자격 증명을 사용하고 있는지 확인합니다.
- Vipps 포털에서 자격 증명을 확인합니다.
QR 코드 생성 안 됨
- 사이트가 HTTPS에서 실행되고 있는지 확인합니다. Vipps API는 HTTP 사이트의 요청을 거부합니다.
- API 오류 세부정보를 위해 WooCommerce 로그를 확인합니다 (
WooCommerce > Status > Logs). - 상인 계정이 활성 상태이며 ePayment API가 활성화되어 있는지 확인합니다.
도움 받기
기술 지원을 위해:
- GitHub 리포지토리를 방문하여 문제를 보고합니다.
- API 관련 질문을 위해 Vipps 개발자 문서를 확인합니다.
- 계정 및 자격 증명 문제는 Vipps MobilePay 지원에 문의합니다.
스크린샷
스크린샷은 다음과 같은 내용을 보여주기 위해 향후 업데이트에서 추가될 예정입니다:
- WooCommerce 결제 설정의 게이트웨이 구성
- QR 코드 및 푸시 알림 옵션이 포함된 POS 체크아웃 인터페이스
- 결제 확인 흐름