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