VibeFox ECPay for OpenCart — 도움말

요구 사항

OpenCart: 3.0.x(3.0.5.0에서 테스트됨) 또는 4.0.2 이상(4.1.0.3에서 테스트됨).

PHP: 8.0 이상.

통화: 신 타이완 달러(TWD). ECPay는 TWD로만 결제를 받으므로, 고객이 TWD로 체크아웃할 때만 결제 방법이 표시됩니다. 쇼핑몰에 TWD가 없다면 System > Localisation > Currencies에서 코드 TWD로 추가하십시오. ECPay는 소수를 받지 않으므로 금액은 정수 TWD로 전송됩니다. 주문 합계는 가장 가까운 달러 단위로 반올림됩니다. 반올림을 피하려면 TWD의 소수점 자릿수를 0으로 설정하십시오.

ECPay 계정: 실제 결제를 하려면 ECPay 가맹점 계정의 MerchantID, HashKey, HashIV가 필요합니다. 이는 ECPay 가맹점 관리 페이지(vendor.ecpay.com.tw)에서 확인할 수 있습니다. 테스트에는 ECPay 계정이 필요하지 않습니다.

사이트 접근: ECPay가 결제 알림을 전달할 수 있도록, 쇼핑몰은 인터넷에서 HTTP/HTTPS 80/443 포트로 접근할 수 있어야 합니다. 사이트 앞단의 방화벽이나 기본 인증은 알림을 차단합니다.

VibeFox 라이선스 키: vibefox.net에서 구매합니다. 키 하나는 도메인 하나에서 사용할 수 있습니다.

설치

다운로드는 두 OpenCart 버전용 패키지가 들어 있는 zip 파일 하나입니다. 컴퓨터에서 압축을 푸십시오. 압축 파일에는 README.txt, OpenCart 3용 패키지 wcp_ecpay_payment_gateway-oc3-(version).ocmod.zip, OpenCart 4용 패키지 wcp_ecpay_payment_gateway.ocmod.zip이 들어 있습니다. 사용 중인 OpenCart 버전의 패키지만 설치하십시오. 라이선스 키는 두 버전 모두 같습니다.

OpenCart 3

1. 관리자 화면에서 Extensions > Installer로 이동하여 Upload를 클릭하고, wcp_ecpay_payment_gateway-oc3-(version).ocmod.zip 파일을 선택하십시오. 이 확장 기능에는 OCMOD 수정 사항이 없으므로 Extensions > Modifications를 새로 고칠 필요가 없습니다. 설치 도구 대신, 이 패키지의 upload 폴더 내용을 쇼핑몰의 루트 폴더에 복사할 수도 있습니다.

2. Extensions > Extensions로 이동하여 유형을 Payments로 선택하십시오. VibeFox ECPay Payment Gateway를 찾아 Install(녹색 + 버튼)을 클릭하십시오. 관리자 사용자에게는 결제 확장 기능 목록을 변경할 권한이 있어야 합니다.

3. Edit(연필 버튼)을 클릭하여 설정 페이지를 여십시오. 페이지 상단의 라이선스 블록에 있는 License key에 VibeFox 라이선스 키를 붙여넣고 Activate를 클릭하십시오(라이선스 키 참조).

4. Enable/Disable을 켜고, 결제 방법을 선택하고, 첫 테스트를 위해 Test Mode는 켜 두십시오. Save를 클릭하십시오.

5. 실제 결제를 위해서는 Merchant ID, Hash Key, Hash IV를 입력하고(설정 참조), Test Mode를 끈 다음 Save를 클릭하십시오.

OpenCart 4

1. 관리자 화면에서 Extensions > Installer로 이동하여 Upload를 클릭하고, wcp_ecpay_payment_gateway.ocmod.zip 파일을 선택하십시오. 파일 이름을 바꾸지 마십시오. OpenCart 4는 확장 기능 코드를 파일 이름에서 가져오므로, 이름을 바꾼 패키지는 작동하지 않습니다.

2. 설치된 확장 기능 목록에 패키지가 같은 페이지에 나타납니다. 그 옆의 Install(녹색 + 버튼)을 클릭하십시오.

3. Extensions > Extensions로 이동하여 유형을 Payments로 선택하십시오. VibeFox ECPay Payment Gateway를 찾아 Install(녹색 + 버튼)을 클릭한 다음 Edit(연필 버튼)을 클릭하십시오.

4. 라이선스 키와 설정은 OpenCart 3의 3~5단계와 같이 입력하십시오. 설정 페이지와 필드는 두 버전에서 같습니다. 알림 URL만 다릅니다(결제 알림 참조).

새로 설치하면 결제 방법은 꺼진 상태이고 테스트 모드는 켜진 상태로 시작됩니다. 알림 URL은 모든 결제와 함께 전송되므로 ECPay에서 별도로 설정할 것은 없습니다.

설정

모든 설정은 확장 기능 페이지에 있습니다: Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit. 섹션은 왼쪽에 나열되며, 목록 아래의 Save 버튼은 페이지 전체를 저장합니다. 설정 위쪽에는 쇼핑몰의 기본 통화가 TWD가 아니고 사용 가능한 TWD 통화가 없을 때 오류가 표시됩니다(이 경우 ECPay는 체크아웃에 표시되지 않습니다). TWD가 두 번째 통화일 뿐이라면 경고가 표시됩니다(이 경우 ECPay는 TWD로 결제하는 고객에게만 표시됩니다). 운영 모드에서 MerchantID, HashKey, HashIV 중 하나라도 없으면 오류가 표시됩니다. 테스트 모드가 켜져 있는 동안에는, 결제가 공개 테스트 가맹점 3002607을 사용하는 ECPay 샌드박스(demo 환경)로 전송되며 실제 금액은 청구되지 않는다는 점, 그리고 공개 샌드박스 키를 아는 누구나 테스트 주문을 확정할 수 있다는 점이 경고됩니다. 따라서 실제 주문을 받기 전에 테스트 모드를 반드시 끄십시오. 확장 기능을 수정할 권한이 없으면 페이지에 설정은 표시되지만 저장할 수 없습니다.

저장할 때 Title은 비워 둘 수 없으며(최대 128자), Sort Order는 정수여야 하고, Total은 0 이상의 숫자여야 합니다. 그렇지 않으면 아무것도 저장되지 않습니다. 그 밖의 수정 사항은 설정 위에 메시지와 함께 저장됩니다(아래 필드 참조).

ECPay (綠界)

Enable/Disable: Enable ECPay Payment는 결제 방법을 켜거나 끕니다. 기본값: 꺼짐.

Title: 고객이 체크아웃에서 보는 결제 방법 이름입니다. 주문에 저장되는 결제 방법 이름이기도 합니다. 기본값: ECPay (綠界). 필수.

Description: Confirm Order 단계에서 고객에게 표시되는 문구입니다. 기본값: Pay securely via ECPay (Credit Card, ATM, CVS, Barcode).

Sort Order: 체크아웃에서 결제 방법 가운데 ECPay의 표시 순서입니다. 비워 두거나 정수를 입력하십시오.

Geo Zone: 선택한 지역(Geo Zone)에 있는 결제 주소에만 ECPay를 제공합니다. 기본값: All zones. Geo Zone은 System > Localisation > Geo Zones에서 설정합니다.

Total: ECPay를 제공하기 전에 주문이 도달해야 하는, 쇼핑몰 기본 통화 기준의 체크아웃 합계입니다. 비워 두면 어떤 합계에서든 ECPay를 제공합니다.

ECPay 계정

MerchantID, HashKey, HashIV는 ECPay 가맹점 관리 페이지(vendor.ecpay.com.tw)의 System development management > System integration settings(系統開發管理 > 系統介接設定)에서 확인할 수 있습니다.

Test Mode: 결제를 ECPay 공개 테스트 가맹점 3002607을 사용하여 ECPay 샌드박스(payment-stage.ecpay.com.tw)로 보냅니다. 실제 금액은 청구되지 않습니다. 아래의 자격 증명은 테스트 모드가 꺼져 있을 때만 사용됩니다. 기본값: 켜짐. 켜져 있는 동안 고객은 Confirm Order 단계에서 TEST MODE — ECPay sandbox, no real money is charged. 문구를 봅니다.

Merchant ID: ECPay Merchant ID(운영)입니다. 테스트 모드에서는 무시됩니다.

Hash Key: ECPay Hash Key(운영)입니다. 테스트 모드에서는 무시됩니다.

Hash IV: ECPay Hash IV(운영)입니다. 테스트 모드에서는 무시됩니다.

붙여넣은 자격 증명에 공백이나 줄바꿈이 있으면 모든 서명이 깨지므로, 저장할 때 자동으로 제거되며 페이지에서 이를 알려 줍니다. 저장된 Hash Key와 Hash IV는 다시 표시되지 않습니다. 필드는 비어 있고 Saved — leave empty to keep it.이라고 표시됩니다. 값을 변경하려는 경우에만 새 값을 입력하십시오. 저장된 값을 삭제하려면 필드 아래의 Clear the saved value on save를 체크한 다음 Save를 클릭하십시오.

결제 옵션

Enabled Payment Methods: 고객에게 제공되는 결제 방법입니다. 둘 이상이면 고객은 Confirm Order 단계에서 선택합니다. ATM, CVS, Barcode 주문은 고객이 결제할 때까지 대기 상태로 남아 있습니다. 최소 한 가지 방법을 선택해야 하며, 아무것도 선택되지 않으면 Credit Card가 켜지고 페이지에서 이를 알려 줍니다. 기본값: Credit Card.

Credit Card: ECPay 페이지에서 카드로 결제합니다.

ATM (Virtual Account): 고객이 가상 계좌를 받아 계좌이체를 합니다.

CVS (Convenience Store): 고객이 편의점에서 결제할 수 있는 결제 코드를 받습니다.

Barcode: 고객이 편의점 바코드를 받습니다.

Default Payment Method: 미리 선택되는 결제 방법입니다. 켜진 방법 중 하나여야 하며, 그렇지 않으면 켜진 첫 번째 방법이 사용됩니다. 기본값: Credit Card.

Order Prefix: ECPay 거래 번호(MerchantTradeNo)의 접두사이며, 영문자나 숫자 최대 5자입니다. 다른 문자는 저장할 때 메시지와 함께 제거됩니다. 여러 쇼핑몰이 하나의 ECPay 계정을 함께 쓸 때 유용합니다. 쇼핑몰마다 고유한 접두사를 지정하십시오. 기본값: EC.

결제 알림

ECPay는 결제 결과와 ATM, CVS, 바코드 세부 정보를 쇼핑몰로 보냅니다. 이 섹션에는 Notification URL이 표시됩니다. 형식은 OpenCart 3에서 https://your-store/index.php?route=extension/payment/wcp_ecpay_payment_gateway/notify, OpenCart 4에서 https://your-store/index.php?route=extension/wcp_ecpay_payment_gateway/payment/wcp_ecpay_payment_gateway.notify와 같습니다. 이 URL은 모든 결제와 함께 전송되므로 ECPay에서 설정할 것은 없지만, 인터넷에서 80/443 포트로 접근할 수 있어야 하며 앞단에 방화벽이나 기본 인증이 없어야 합니다. 유지 보수 모드에서도 차단되지 않습니다.

각 알림은 결제가 시작된 환경(테스트 또는 운영)의 키로 CheckMacValue 서명을 확인하고, 해당 결제의 MerchantID도 확인합니다. 유효한 서명이 없는 알림은 거부되며, ECPay는 이를 다시 보냅니다. 알림이 없으면 주문에는 상태가 지정되지 않으므로, ECPay 가맹점 관리 페이지에서 결제를 확인하십시오.

주문

OpenCart는 Confirm Order 단계에서 주문을 상태 없이(누락된 주문) 생성합니다. 서명된 ECPay 알림을 받아야만 주문에 상태가 지정됩니다. 카드 결제가 실패하거나 중단되면 주문은 상태 없이 남으며, 고객은 다시 결제할 수 있습니다. 아래 각 필드에는 OpenCart 주문 상태가 나열됩니다.

Payment accepted: ECPay가 예상 금액으로 결제를 확인했을 때의 상태입니다. 기본값: Processing.

Awaiting ECPay payment: 고객이 ATM 가상 계좌, CVS 결제 코드 또는 바코드를 받고 나중에 ATM이나 매장에서 결제할 때의 상태입니다. 기본값: Pending.

ECPay payment on hold: ECPay가 다른 금액이나 통화를 보고했을 때, 운영 모드에 샌드박스 결제가 도착했을 때, 또는 주문 상태가 변경된 뒤(예: 취소된 뒤) 결제가 도착했을 때의 상태입니다. 이유는 주문 메모에 설명됩니다. 기본값: Pending. OpenCart에는 On hold 상태가 없기 때문입니다. System > Localisation > Order Statuses에서 직접 상태를 만들고 여기서 선택할 수 있습니다.

Payment error: 대기 중인 주문의 최근 ATM, CVS 또는 바코드 결제가 실패했을 때의 상태입니다. 기본값: Failed.

고급

Enable Logging: 주문 번호, 거래 번호, 금액, ECPay 반환 코드를 OpenCart 로그 폴더(storage/logs)의 ecpay_p_debug.log.php에 기록합니다. 이 파일은 웹에서 열 수 없으며, 5MB에 도달하면 ecpay_p_debug.old.log.php로 옮겨집니다. 키나 고객 데이터는 기록되지 않습니다. 이 스위치가 꺼져 있어도 오류는 항상 기록됩니다. 기본값: 꺼짐.

Log: 로그의 크기와 최신 항목을 보여 줍니다. Clear log를 클릭하면 로그가 비워집니다.

Delete Data on Uninstall: 켜져 있으면 확장 기능을 제거할 때 설정과 로그가 삭제됩니다. ECPay 결제 기록은 항상 보관되므로, 다시 설치한 뒤에도 기존 주문이 계속 작동합니다. 기본값: 꺼짐.

가져오기 / 내보내기

Export: Download JSON은 설정을 JSON 파일로 저장합니다. Hash Key와 Hash IV는 내보내지 않습니다.

Import: 이전에 내보낸 JSON을 붙여넣고 Import를 클릭하여 설정을 복원하십시오. 저장된 Hash Key와 Hash IV는 유지됩니다.

체크아웃

Payment Method 단계에서 고객은 결제 방법을 선택합니다(기본값은 ECPay (綠界)). Confirm Order 단계에서 고객은 쇼핑몰의 설명과, You will be redirected to the ECPay payment page to complete the payment.라는 안내 문구를 봅니다. 여러 방법이 켜져 있으면 고객은 Payment Method 아래에서 Credit Card, ATM (Virtual Account), CVS (Convenience Store) 또는 Barcode도 선택합니다. OpenCart는 이 단계에서 주문을 생성하며, 여전히 상태는 없습니다. OpenCart 4에서는 고객이 결제 방법 블록의 Choose 버튼을 눌러 Payment method options 창에서 방법을 고르고, 체크아웃 페이지 하단의 Confirm Order를 클릭합니다. ECPay 방법의 선택은 이 버튼 위에 표시됩니다.

고객이 Confirm Order를 클릭하면 페이지에 Redirecting to ECPay for payment. Please wait...가 표시되고, 고객은 ECPay 결제 페이지로 이동합니다. 주문 합계는 상품 이름과 수량과 함께 정수 TWD로 전송됩니다. ECPay 페이지는 대만어와 홍콩 언어에는 번체 중국어로, 해당 언어에는 간체 중국어, 한국어 또는 일본어로 표시되며, 그 밖의 모든 언어에는 영어로 표시됩니다. 고객의 쇼핑몰 언어에 따릅니다.

주문은 ECPay가 서명된 서버 알림으로 결제를 확인한 후에만 결제 완료로 표시됩니다. 그런 다음 일반적인 OpenCart 방식으로 상태를 받고, 평소의 주문 이메일이 발송되며 재고가 업데이트됩니다. 고객이 ECPay 페이지의 쇼핑몰로 돌아가기 링크를 클릭했을 때 주문에 이미 상태가 있으면 OpenCart 주문 완료 페이지가 열립니다. 결제 완료된 주문에는 Your ECPay payment has been received.가, 검토 중인 주문에는 Your ECPay payment was received and is being reviewed by the store.가 표시되며, 대기 중인 ATM, CVS, Barcode 주문에는 결제 안내가 표시됩니다. 알림이 아직 도착하지 않았다면 Payment confirmation 페이지에 We have not received a payment confirmation from ECPay for this order yet. Your order will be confirmed as soon as ECPay confirms the payment.가 표시되고, Check again 및 Back to checkout 버튼이 나타납니다. ECPay가 결제 실패를 알려 오면 고객은 The payment was not completed. You can try again or choose another payment method.와 함께 체크아웃으로 돌아갑니다. 장바구니는 유지됩니다. OpenCart 4에서는 이 메시지가 체크아웃 페이지 위에 표시됩니다.

ATM, CVS, Barcode의 경우 고객은 먼저 결제 정보를 받습니다. 주문은 Awaiting ECPay payment 상태를 받으며, 은행 코드와 가상 계좌, 편의점 결제 코드 또는 바코드, 금액, Pay before 기한은 주문 완료 페이지의 ECPay payment instructions 아래에 표시되고, 로그인한 고객의 경우 고객 계정의 주문 정보에도 표시됩니다. 고객이 결제하면 ECPay는 다른 알림을 보내고, 주문은 결제 완료로 표시됩니다. 결제 안내는 OpenCart 이메일에 포함되지 않습니다.

ECPay는 재사용된 번호를 거부하므로, 시도할 때마다 새 ECPay 거래 번호가 생성됩니다. 따라서 결제 실패 후 재시도가 가능하며, 고객이 브라우저에서 뒤로 가서 Confirm Order를 다시 클릭하면 새 시도가 시작됩니다. 장바구니당 최대 30회까지 결제를 시도할 수 있습니다. OpenCart 3은 Confirm Order 단계가 표시될 때마다 새 주문을 생성하고, OpenCart 4는 체크아웃의 주문을 하나 유지하며 업데이트하므로 재시도는 같은 주문을 새 ECPay 거래 번호로 결제합니다. 같은 장바구니의 다른 주문이 이미 결제되었거나 ATM 또는 CVS 결제를 기다리고 있으면, 고객은 완료 페이지로 이동하며 새 결제는 시작되지 않습니다.

OpenCart 4는 성공 페이지가 표시될 때까지 주문을 체크아웃에 유지합니다. 그 사이에 주문이 결제 없이 닫힌 경우(예: ATM 또는 CVS 결제가 실패했거나 취소한 경우), 고객을 Your previous order was cancelled or its payment failed. Please confirm the order again.와 함께 체크아웃으로 돌려보내며, 다음 Confirm Order에서 그 장바구니의 새 주문에 대한 결제가 진행됩니다. 주문이 이미 결제되었거나(또는 ATM·편의점 결제를 기다리고 있으며), 그 뒤 장바구니가 변경된 경우(수량 변경 포함), 메시지는 Your previous order is already paid (or awaits its ATM / convenience store payment). Please confirm the order again: the cart will be paid with a new order.입니다. 결제 완료된 주문이 다른 장바구니에 대해 결제 완료로 표시되는 일은 없습니다.

결제를 시작할 수 없으면 고객은 Confirm Order 단계에 머무르며 버튼 위에 짧은 메시지를 보게 됩니다. 예를 들어 반올림 후 합계가 1 TWD 미만이면 The order total is too small for ECPay.가 표시됩니다. 방법별 ECPay 자체 금액 한도는 체크아웃이 아니라 ECPay 페이지에서 확인됩니다.

이미 시작된 결제의 알림은 결제 방법을 끄더라도 계속 접수되며, 고객은 이미 이루어진 주문의 결제 안내를 계속 볼 수 있습니다.

이 확장 기능은 ECPay 페이지에서의 일회성 결제만 받습니다. OpenCart에서의 환불, 저장된 카드, 구독 또는 정기 결제(定期定額), 할부, Apple Pay, 전자 송장, 물류는 지원하지 않으며, 서버 측 상태 조회도 없습니다. 쇼핑몰이 알림을 받을 수 없다면 ECPay 가맹점 관리 페이지에서 결제를 확인하십시오.

주문

주문 상태

No status (missing order): 고객이 ECPay로 보내졌지만 결제하지 않았거나, 카드 결제가 실패했거나, 알림이 아직 도착하지 않은 경우입니다. Sales > Orders에서 이러한 주문은 Order Status 필터를 Missing Orders로 설정한 경우에만 표시됩니다.

Awaiting ECPay payment (default Pending): 고객이 ATM, CVS 또는 Barcode를 선택하여 결제 정보를 받은 상태입니다. 메모에는 은행 코드와 가상 계좌, 결제 코드 또는 바코드, 그리고 기한이 표시됩니다.

Payment accepted (default Processing): 결제가 확인된 상태입니다. 메모에는 ECPay TradeNo, 결제 유형, 금액, 거래 번호가 표시됩니다(샌드박스 결제에는 테스트 모드 표시가 함께 나타납니다).

ECPay payment on hold (default Pending): ECPay가 주문과 다른 금액이나 통화를 보고한 경우(예: 결제가 시작된 뒤 다른 탭에서 장바구니가 변경된 경우), 운영 모드로 전환한 뒤 샌드박스 결제가 도착한 경우(실제 금액은 청구되지 않음), 또는 주문 상태를 변경한 뒤(예: 취소한 뒤) 결제가 도착한 경우입니다. 메모에 이유가 설명됩니다. ECPay 가맹점 관리 페이지와 대조한 뒤 주문을 처리하거나 그곳에서 결제를 환불하십시오.

Payment error (default Failed): 대기 중인 주문의 최근 ATM, CVS 또는 바코드 결제가 실패했다고 ECPay가 보고한 상태입니다. 메모에는 ECPay 반환 코드와 메시지가 표시됩니다.

반복된 알림은 무시됩니다. 결제 완료된 주문은 뒤늦은 실패 알림으로 다시 열리지 않습니다. 이미 결제된 주문에 대한 두 번째 결제(예: 브라우저 탭 두 개에서 결제한 경우)는 메모로 한 번 기록되므로, ECPay 가맹점 관리 페이지에서 환불할 수 있습니다. ECPay 가맹점 관리 페이지에서 시작된 시뮬레이션 결제는 메모로만 기록되며, ECPay가 이에 대해 금액을 받지 않으므로 주문을 결제 완료로 표시하지 않습니다.

메모는 고객에게 보이지 않는 주문의 History 항목입니다.

VibeFox ECPay Payment Gateway 탭

Sales > Orders에서 ECPay로 결제된 주문을 여십시오. 주문 페이지 하단, History 및 Additional 옆에 있는 VibeFox ECPay Payment Gateway 탭에는 그 주문의 모든 결제 시도가 나열됩니다. 샌드박스 시도에는 Test mode 표시가 붙은 MerchantTradeNo, 결제 방법, TWD 금액, 상태, ECPay TradeNo, 결제 유형과 날짜, ECPay 반환 코드, 시작 날짜가 표시됩니다. 그 아래에는 주문의 ECPay notes가 있습니다. 보류 상태의 주문에 대해 이 탭은 ECPay 가맹점 관리 페이지와 대조하라고 알려 줍니다. 이 탭은 읽기 전용이며, 확장 기능에 접근할 수 있는 사용자에게 표시됩니다.

환불

OpenCart에서의 환불은 제공되지 않습니다. ECPay 가맹점 관리 페이지에서 결제를 환불한 다음, OpenCart에서 주문 상태를 수동으로 업데이트하십시오. Sales > Returns의 상품 반품은 ECPay를 통해 돈을 돌려주지 않습니다.

라이선스 키

이 확장 기능은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록 License — VibeFox ECPay Payment Gateway는 Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit 페이지에서 설정 위에 있는 첫 번째 블록입니다. 키를 License key에 붙여넣고 Activate를 클릭하십시오. 이후 블록에는 마스킹된 키, 상태(예: 라이선스가 유효한 날짜와 도메인), 그리고 다음 버튼이 표시됩니다. Check now는 상태를 다시 확인하고, Change key는 다른 키를 입력하며, Remove key는 이 쇼핑몰에서 키를 제거합니다. 그 아래에는 Product: opencart-payment-ecpay 줄과, vibefox.net 계정을 여는 Manage licenses and domains in your account 링크가 있습니다. 이 확장 기능의 Modify 권한이 있는 관리자 사용자만 키를 변경할 수 있습니다. 블록의 텍스트는 관리자 화면의 언어를 따릅니다(영어와 러시아어가 포함되어 있습니다).

키가 승인되지 않으면 블록에 그 이유가 표시됩니다. 예를 들어 Key not found, This key belongs to another product, Domain limit reached 또는 날짜가 붙은 License expired on입니다. 쇼핑몰 주소를 변경한 후, 또는 계정에서 도메인 슬롯을 비운 후에는 Check now를 클릭하십시오. 라이선스 서버에 연결할 수 없으면, 확장 기능은 마지막으로 확인된 상태로 계속 작동합니다.

키 하나는 도메인 하나에서 작동합니다. 즉 OpenCart 설정에 있는 쇼핑몰 주소입니다. 쇼핑몰에서 키를 제거해도 도메인 슬롯은 비워지지 않습니다. vibefox.net 계정에서 슬롯을 비우십시오.

활성 키가 없으면 ECPay는 체크아웃에서 고객에게 표시되지 않습니다. 그럼에도 결제가 시작되면 고객은 This payment method is not available. Please choose another one.를 보게 됩니다. 같은 브라우저에서 관리자 화면에 로그인한 관리자 사용자는 쇼핑몰에서 결제 방법을 (unlicensed — visible to admins only) 표시와 함께 여전히 볼 수 있으므로, 키를 구매하기 전에 확장 기능을 설정하고 테스트할 수 있습니다. OpenCart 4에서는 이 미리 보기를 사용할 수 없습니다. 쇼핑몰은 관리자 로그인을 인식하지 못하므로, 활성 키가 없으면 결제 방법은 모든 사용자에게 숨겨집니다. Edit 페이지를 한 번 열면 관리자 Dashboard에 알림이 나타납니다. ×로 닫으면 7일 동안 숨겨집니다. 기존 주문은 영향을 받지 않으며, 이미 시작된 결제도 계속 확인됩니다.

라이선스가 만료되어도 확장 기능은 계속 작동하지만, 업데이트와 지원에는 갱신이 필요합니다. 관리자 Dashboard 또는 Edit 페이지를 열면 상태가 자동으로 다시 확인됩니다. 키를 입력한 후 처음 14일 동안은 하루에 한 번, 그 뒤에는 일주일에 한 번입니다. cron 작업은 필요하지 않습니다. 확장 기능을 제거하면 라이선스 키와 라이선스 상태는 항상 삭제됩니다.

문제 해결

ECPay가 체크아웃에 나타나지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 고객이 TWD로 체크아웃하는지, 그리고 운영 모드에서 Merchant ID, Hash Key, Hash IV가 설정되어 있는지 확인하십시오. 설정 페이지에는 통화와 운영 자격 증명에 관한 메시지가 표시됩니다. 또한 결제 주소가 선택한 Geo Zone에 있는지, 그리고 주문이 설정의 Total에 도달하는지 확인하십시오.

결제는 완료되었지만 주문에 상태가 없음: ECPay 알림이 쇼핑몰에 도달하지 못했습니다(사이트 다운, 방화벽, 기본 인증). ECPay는 여러 번 재시도합니다. ECPay 가맹점 관리 페이지에서 거래를 확인할 수도 있습니다. 확장 기능이 받은 알림을 보려면 Enable Logging을 켜십시오. 거부된 알림은 어떤 경우에도 오류로 기록됩니다.

알림이 0|CheckMacValue verification failed로 응답함: Hash Key 또는 Hash IV가 ECPay 계정과 일치하지 않거나, 결제가 다른 환경에서 시작되었습니다. ECPay 가맹점 관리 페이지에서 다시 복사하십시오.

알림이 0|MerchantID mismatch로 응답함: 알림은 결제를 시작할 때 사용한 가맹점과 다른 ECPay 가맹점의 것입니다.

알림이 0|Order not found로 응답함: 거래 번호가 이 쇼핑몰에서 발급되지 않았습니다. 예를 들어 여러 쇼핑몰이 하나의 ECPay 계정을 함께 사용하는 경우입니다. 쇼핑몰마다 고유한 Order Prefix를 지정하십시오.

알림이 0|Retry로 응답함: 같은 순간에 다른 알림이 주문을 처리하고 있었거나, 주문 상태를 설정할 수 없었습니다. ECPay는 알림을 다시 보냅니다. 이유를 보려면 Enable Logging을 켜십시오.

알림 URL에 0|Method not allowed in the browser가 표시됨: 정상입니다. 이 URL은 ECPay의 요청만 받습니다.

고객에게 This payment method is not available. Please reload the checkout page.가 표시됨: 체크아웃 세션이 주문과 더 이상 맞지 않거나, 그사이 결제 방법이 꺼졌습니다. 고객은 체크아웃 페이지를 다시 불러와야 합니다.

고객에게 The order total is too small for ECPay.가 표시됨: 반올림 후 주문 합계가 1 TWD 미만이어서 ECPay로 결제할 수 없습니다.

고객에게 Too many payment attempts for this order가 표시됨: 장바구니가 30회의 결제 시도에 도달했습니다. 고객에게 새 장바구니를 시작하도록 요청하십시오.

주문이 보류 상태임: VibeFox ECPay Payment Gateway 탭의 메모를 읽고(주문 상태 참조), ECPay 가맹점 관리 페이지와 대조한 다음, 주문을 처리하거나 그곳에서 결제를 환불하십시오.

개발자용: 결제 양식이 ECPay로 전송되기 전에, 확장 기능은 매개변수와 주문을 포함하여 OpenCart 이벤트 ecpay_p_request_params를 발생시킵니다. 이 이벤트로는 가맹점, 거래 번호, 금액을 변경할 수 없습니다.

제거

Extensions > Extensions로 이동하여 유형을 Payments로 선택하고, VibeFox ECPay Payment Gateway 옆의 Uninstall(빨간색 − 버튼)을 클릭하십시오. 이 확장 기능의 라이선스 키와 라이선스 상태는 항상 제거됩니다. OpenCart는 확장 기능 자체의 설정을 항상 제거합니다. 구체적으로 Enable/Disable, Sort Order, Geo Zone, Total과 Orders 섹션의 주문 상태이며, 이들은 다시 설치할 때 기본값으로 돌아갑니다. 확장 기능의 OpenCart 이벤트도 제거됩니다(OpenCart 4에서는 이벤트와 함께, 유지 보수 모드에서도 알림을 통과시키는 시작 액션도 제거됩니다). Delete Data on Uninstall이 켜져 있으면 나머지 설정(제목, 설명, 테스트 모드, 자격 증명, 결제 옵션, 로깅)과 로그도 제거됩니다. 꺼져 있으면 나중에 다시 설치할 수 있도록 보관됩니다. ECPay 결제 기록은 항상 보관되므로, 다시 설치한 뒤에도 이전 결제의 지연된 알림이 계속 확인됩니다. 기존 주문은 결제 메모를 유지합니다.

OpenCart 4에서 확장 기능의 파일까지 제거하려면, 제거 후 Extensions > Installer로 이동하여 설치된 확장 기능 목록에서 VibeFox ECPay Payment Gateway 옆의 Uninstall(주황색 − 버튼)을 클릭한 다음, Delete(빨간색 휴지통 버튼)를 클릭하여 업로드한 패키지를 삭제하십시오.

ECPay는 각 소유자의 상표입니다. 이 확장 기능은 ECPay와 제휴하거나 ECPay의 승인을 받지 않았습니다.