VibeFox Helcim for OpenCart — 도움말
요구 사항
OpenCart: 3.0.x (3.0.5.0에서 테스트됨) 또는 4.0.2 이상 (4.1.0.3에서 테스트됨).
PHP: 8.0 이상.
HTTPS 및 PCI DSS: 카드 정보는 체크아웃 페이지에서 입력되며 쇼핑몰 서버에서 Helcim으로 전송됩니다. 카드 정보는 저장되거나 로그에 기록되지 않지만 쇼핑몰 서버를 거치므로, 쇼핑몰에는 체크아웃용 SSL 인증서가 필요하고 호스팅은 PCI DSS(SAQ D)를 충족해야 합니다.
통화: Helcim은 CAD와 USD를 처리합니다. 결제 수단은 체크아웃 통화가 확장 프로그램에 설정된 Account currencies 중 하나일 때만 표시됩니다.
Helcim 계정: 캐나다 또는 미국의 Helcim 가맹점 계정과 거래 처리 권한이 있는 API 토큰(Configuration 참조). Helcim 테스트(developer) 계정은 테스트용으로 선택 사항입니다.
VibeFox 라이선스 키: vibefox.net에서 구매합니다. 키 하나는 도메인 하나에서 사용할 수 있습니다.
설치
다운로드 파일은 두 OpenCart 버전용 패키지를 모두 담은 zip 파일 하나입니다. 컴퓨터에서 압축을 해제하십시오. README.txt, OpenCart 3 패키지 wcp_helcim_gateway-oc3-(version).ocmod.zip, OpenCart 4 패키지 wcp_helcim_gateway.ocmod.zip이 들어 있습니다. 사용하는 OpenCart 버전의 패키지만 설치하십시오. 라이선스 키는 두 버전에서 동일합니다.
OpenCart 3
1. 관리자 화면에서 Extensions > Installer로 이동하여 Upload를 클릭하고 wcp_helcim_gateway-oc3-(version).ocmod.zip 파일을 선택합니다. 이 확장 프로그램에는 OCMOD 수정 사항이 없으므로 Extensions > Modifications를 새로 고칠 필요가 없습니다. 설치 도구 대신 이 패키지의 upload 폴더 내용을 쇼핑몰의 루트 폴더에 복사할 수도 있습니다.
2. Extensions > Extensions로 이동하여 유형을 Payments로 선택합니다. VibeFox Helcim Gateway를 찾아 Install(녹색 + 버튼)을 클릭합니다. 관리자 사용자는 결제 확장 프로그램 목록을 수정할 권한이 있어야 합니다.
3. Edit(연필 버튼)을 클릭하여 설정 페이지를 엽니다. 페이지 상단 라이선스 블록의 License key에 VibeFox 라이선스 키를 붙여 넣고 Activate를 클릭합니다(License key 참조).
4. Helcim에서 All Tools > Integrations > API Access Configuration을 열고, 거래 처리 권한(구매, 사전 승인, 캡처, 환불)을 가진 API 액세스를 만든 다음 토큰을 복사합니다.
5. 토큰을 Live API token에 붙여 넣고, Helcim 테스트 계정이 있다면 그 토큰을 Test API token에 붙여 넣습니다.
6. Transaction type과 Account currencies를 선택하고, Enable / Disable을 켠 다음 Save를 클릭합니다. 먼저 테스트하려면 Test mode를 켜고 테스트 계정으로 결제한 후 끕니다.
OpenCart 4
1. 관리자 화면에서 Extensions > Installer로 이동하여 Upload를 클릭하고 wcp_helcim_gateway.ocmod.zip 파일을 선택합니다. 파일 이름을 바꾸지 마십시오. OpenCart 4는 파일 이름에서 확장 프로그램 코드를 가져오므로, 이름을 바꾼 패키지는 작동하지 않습니다.
2. 패키지는 같은 페이지의 설치된 확장 프로그램 목록에 나타납니다. 그 옆의 Install(녹색 + 버튼)을 클릭합니다.
3. Extensions > Extensions로 이동하여 유형을 Payments로 선택합니다. VibeFox Helcim Gateway를 찾아 Install(녹색 + 버튼)을 클릭한 다음 Edit(연필 버튼)을 클릭합니다.
4. OpenCart 3의 3~6단계와 같이 라이선스 키, API 토큰, 결제 설정을 입력합니다. 설정 페이지와 그 필드는 두 버전에서 동일합니다.
새로 설치하면 결제 수단이 꺼져 있고 테스트 모드도 꺼진 상태로 시작합니다.
설정
모든 설정은 확장 프로그램 페이지에 있습니다: Extensions > Extensions > Payments > VibeFox Helcim Gateway > Edit. 섹션은 왼쪽에 나열되며, 목록 아래의 Save 버튼은 페이지 전체를 저장합니다. 설정 위에는 쇼핑몰의 기본 통화가 Account currencies 중 하나가 아니면(이 경우 Helcim은 허용된 통화의 주문에만 제공됨) 경고가 표시되며, 결제 수단이 켜져 있는 동안 현재 모드의 API 토큰이 비어 있으면(이 경우 결제 수단이 체크아웃에서 숨겨짐) 경고가 표시됩니다. 확장 프로그램을 수정할 권한이 없으면 페이지에 설정은 표시되지만 저장할 수 없습니다.
저장할 때 Title은 비어 있으면 안 되며(최대 128자), Sort Order는 정수여야 하고, Total은 0 이상의 숫자여야 하며, 모든 주문 상태가 존재해야 합니다. 잘못된 항목이 있으면 아무것도 저장되지 않고 페이지에 오류 목록이 표시됩니다.
Helcim
Enable / Disable: Enable Helcim Gateway는 결제 수단을 켜거나 끕니다. 기본값: 꺼짐.
Title: 체크아웃에 표시되는 결제 수단의 제목. 주문에 저장되는 결제 수단 이름이기도 합니다. 기본값: Credit card (Helcim). 필수.
Description: Confirm Order 단계에서 카드 양식 위에 고객에게 표시되는 텍스트. 기본값: Pay securely with your credit card.
Sort Order: 체크아웃에서 결제 수단의 위치. 비워 두거나 정수를 입력합니다.
Geo Zone: 선택한 지역(Geo Zone)에 속한 결제 주소에 대해서만 카드 양식을 제공합니다. 기본값: All zones. Geo Zone은 System > Localisation > Geo Zones에서 설정합니다.
Total: 결제 수단을 제공하기 위해 주문이 도달해야 하는 체크아웃 금액(쇼핑몰 기본 통화 기준). 비워 두면 모든 금액에 대해 제공됩니다.
API 자격 증명
Helcim에서 All Tools > Integrations > API Access Configuration으로 이동하여 API 액세스를 만들고 토큰을 복사합니다. 구매, 사전 승인, 캡처, 환불에 대한 거래 처리 권한을 부여하십시오. Helcim 테스트 계정은 실제 계정과 같은 API 주소를 사용하므로, 테스트 모드에서는 Helcim 테스트 계정의 토큰을 사용하면 됩니다. 이 섹션에는 Helcim API 문서로 연결되는 링크가 있습니다.
Live API token: 실제 Helcim 계정의 API 토큰. 테스트 모드가 꺼져 있을 때 사용됩니다.
Test mode: Test API token(Helcim 테스트 계정)을 사용합니다. 결제, 캡처, 환불은 Helcim 테스트 계정으로 전송되며, 고객에게는 테스트 모드 안내가 표시됩니다. 주문의 캡처와 환불은 항상 해당 주문이 결제된 모드의 토큰을 사용합니다. 기본값: 꺼짐.
Test API token: Helcim 테스트(developer) 계정의 API 토큰. 테스트 모드가 켜져 있을 때 사용됩니다.
저장된 토큰은 다시 표시되지 않습니다. 필드는 비어 있으며 Saved — leave empty to keep it.이 표시됩니다. 변경하려는 경우에만 새 값을 입력하십시오. 저장된 토큰을 제거하려면 필드 아래의 Clear the saved token on save를 선택하고 Save를 클릭합니다.
결제
Transaction type: 카드에 요금을 청구하는 방식.
Account currencies: Helcim 계정이 처리할 수 있는 통화. 주문은 항상 주문 통화로 청구됩니다. 다른 통화의 경우 결제 수단은 체크아웃에서 숨겨집니다.
주문
주문은 Confirm Order 단계에서 상태 없이 생성되며(누락된 주문), Helcim이 카드를 승인한 후에만 상태를 받습니다. 각 필드에는 OpenCart의 주문 상태가 나열됩니다.
Order Status After Payment: 카드에 청구됨(구매 또는 사전 승인 캡처). 기본값: Processing.
Authorized Status: 사전 승인: 금액은 보류만 되었으며 아직 청구되지 않았습니다. 주문 탭의 Capture payment로 캡처하십시오. 기본값: Pending. OpenCart에는 On hold 상태가 없기 때문입니다.
On Hold (Review) Status: Helcim의 응답이 주문과 일치하지 않는 경우(부분 승인, 다른 통화, 거래 ID 없음, 또는 주문 합계가 청구 금액과 다름). 주문을 처리하기 전에 Helcim에서 거래를 확인하십시오. 메모에 이유가 설명됩니다. 기본값: Pending. 승인된 주문과 검토가 필요한 주문을 구분하려면 System > Localisation > Order Statuses에서 직접 상태를 만들 수 있습니다.
Canceled Status: 캡처되지 않은 사전 승인이 주문 탭에서 해제됨(고객에게 청구되지 않음). 기본값: Canceled.
Refunded Status: 주문 탭에서 결제가 전액 환불된 후 설정됩니다. 기본값: Refunded.
고급
Debug log: API 요청과 응답을 OpenCart 로그 폴더(storage/logs)의 wc_hlg_debug.log.php에 기록합니다. 이 파일은 웹에서 열 수 없습니다. 카드 번호는 마지막 4자리로 줄여서 기록됩니다. CVC, 유효 기간, 토큰, 이름, 주소, 이메일, IP 주소는 절대 기록되지 않습니다. 오류(거절되거나 실패한 결제, API 오류, 실패한 캡처와 환불)는 이 옵션이 꺼져 있어도 항상 기록됩니다. 기본값: 꺼짐.
Log: 로그의 크기와 최근 항목을 표시합니다. Clear log를 클릭하면 로그가 비워집니다.
Delete data on uninstall: 켜져 있으면 확장 프로그램을 제거할 때 게이트웨이 설정과 로그 파일이 삭제됩니다. Helcim 거래와 환불은 항상 유지되므로, 이전에 결제된 주문은 재설치 후에도 캡처하고 환불할 수 있습니다. 기본값: 꺼짐.
가져오기 / 내보내기
Export: Download JSON은 설정을 JSON 파일로 저장합니다. API 토큰은 내보내지 않습니다.
Import: 이전에 내보낸 JSON을 붙여 넣고 Import를 클릭하면 설정이 복원됩니다. 저장된 API 토큰은 유지됩니다.
체크아웃
Payment Method 단계에서 고객은 결제 수단을 선택합니다(기본값은 Credit card (Helcim)). Confirm Order 단계에서 고객에게는 카드 아이콘, 쇼핑몰의 설명, 그리고 Card Number, Expiry (MM/YY), CVC, Cardholder Name이 포함된 양식이 표시됩니다. 테스트 모드에서는 양식에 TEST MODE — payments go to a Helcim test account, no real charges are made.가 표시됩니다. OpenCart는 이 단계에서 주문을 만들지만, 아직 상태는 없습니다. 고객이 Confirm Order를 클릭하면 확장 프로그램은 카드 번호의 체크섬, 유효 기간이 올바르고 만료되지 않았는지, CVC가 3자리 또는 4자리인지, 이름이 입력되었는지 확인합니다. 오류는 양식 위에 표시되며 Helcim으로는 아무것도 전송되지 않습니다.
OpenCart 4에서는 고객이 결제 수단 블록의 Choose 버튼을 눌러 Payment method options 창에서 결제 수단을 선택합니다. 그러면 카드 양식이 체크아웃 페이지 하단의 주문 확인 블록에, Confirm Order 버튼 위에 나타납니다. 기본적으로 OpenCart 4는 결제 주소를 묻지 않습니다. 이 경우 확장 프로그램은 주소 확인을 위해 배송 주소를 카드 소유자 이름과 함께 Helcim에 전송합니다.
그다음 쇼핑몰 서버는 주문 통화로 된 주문 합계에 대해 카드를 구매 또는 사전 승인으로 Helcim에 보냅니다. 카드 소유자 이름, 결제 주소, 전화번호, 이메일은 주소 확인을 위해 전송됩니다. 결제는 Helcim에서 주문 번호, -OC, 짧은 코드로 구성된 인보이스 번호로 표시됩니다. Helcim은 같은 요청 안에서 응답합니다. 주문은 Helcim이 거래를 승인한 후에만 상태를 받으며, 이는 일반적인 주문 이메일과 재고 업데이트를 포함한 OpenCart의 표준 방식입니다. 장바구니는 즉시 비워지고, 고객은 OpenCart 주문 완료 페이지로 이동합니다.
장바구니당 한 번에 하나의 결제 시도만 실행되며, 이미 결제된 장바구니는 그 사이에 OpenCart가 새 주문을 만들었더라도 다시 청구되지 않습니다(OpenCart 3에서는 Confirm Order 단계가 표시될 때마다 새 주문이 생성됩니다. OpenCart 4에서는 이전 주문이나 두 번째 브라우저 탭이 여전히 같은 장바구니를 보유할 수 있습니다). OpenCart 4는 체크아웃용 주문을 하나만 유지하고 업데이트하므로, 카드가 거절된 후에도 고객은 같은 주문에 대해 결제합니다. 그 주문이 그 사이 종료되었거나(예: 쇼핑몰에서 주문을 취소한 경우), 이미 결제되었고 장바구니에 새 구매 항목이 있는 경우, Confirm Order를 누르면 고객은 체크아웃 페이지로 돌아가고, 그 위에 Your previous order is already closed (cancelled or refunded by the store) or paid for another cart. Please confirm the order again: the cart will be paid with a new order. 메시지가 표시됩니다. 다음 Confirm Order에서는 장바구니의 새 주문에 대해 결제가 이루어집니다. 수량 변경을 포함하여 장바구니가 바뀌면 자체 결제가 필요한 새 장바구니로 간주됩니다. 모든 시도에는 멱등성 키가 사용됩니다. Helcim이 응답하지 않으면 주문은 상태 없이 남고, 5분 이내의 재시도는 카드를 두 번 청구하는 대신 Helcim의 원래 결과를 반환합니다. 결제는 승인되었지만 주문 상태를 설정할 수 없었다면, 같은 장바구니의 다음 시도는 카드를 다시 청구하지 않고 상태를 설정합니다.
고객이 양식 위에서 볼 수 있는 메시지: Helcim이 거절하면 Your card was declined. Please check the card details or use another card.; 다른 거절된 요청에서는 Helcim의 이유와 함께 Payment failed:; Helcim이 응답하지 않으면 We could not confirm your payment with the card processor. Please try again in a minute; if the problem persists, contact us before using another card.; API 토큰이 거부되면 This payment method is temporarily unavailable. Please choose another payment method.; 이중 제출 시 Your payment is already being processed. Please wait a moment and check your e-mail before trying again.; 결제는 접수되었지만 주문을 자동으로 완료할 수 없으면 Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again.. 고객은 같은 장바구니로 Confirm Order 단계에 머무릅니다. 기술적인 세부 정보는 로그에 기록됩니다.
이 확장 프로그램은 HelcimPay.js나 Helcim.js를 사용하지 않으므로 카드 정보는 쇼핑몰 서버를 거칩니다. 저장된 카드, 구독, ACH 또는 은행 결제, Apple Pay, Google Pay, 3-D Secure는 지원하지 않으며, Helcim 웹훅도 없습니다.
주문과 환불
주문 상태
상태 없음(누락된 주문): 카드가 거절되었거나, Helcim이 응답하지 않았거나, 고객이 아직 결제하지 않은 경우. 거절과 오류는 로그에 기록되고 메모로 추가됩니다. Sales > Orders에서 이러한 주문은 Order Status 필터를 Missing Orders로 설정했을 때만 표시됩니다.
Order Status After Payment(기본값 Processing): 구매가 승인되었거나 사전 승인이 캡처되었습니다. 메모에는 거래 ID, 승인 코드, 카드 종류, 마지막 4자리, 모드가 표시됩니다.
Authorized Status(기본값 Pending): 사전 승인이 승인되었습니다. 금액은 보류만 되어 있습니다. 캡처하거나 전액 환불로 해제하십시오.
On Hold (Review) Status(기본값 Pending): Helcim이 거래를 승인했지만, 응답의 금액, 통화 또는 거래 ID가 주문과 일치하지 않습니다. 예를 들어 부분 승인 후이거나 결제 중에 주문 합계가 변경된 경우입니다. 메모에는 Helcim response verification FAILED라고 표시됩니다. 주문을 처리하기 전에 Helcim에서 거래를 확인하십시오.
Refunded Status(기본값 Refunded): 확장 프로그램을 통해 결제가 전액 환불되었습니다.
Canceled Status(기본값 Canceled): 캡처되지 않은 사전 승인이 해제되었습니다. 고객에게 청구되지 않았습니다.
메모는 고객에게 보이지 않는 주문의 History 항목입니다.
VibeFox Helcim Gateway 탭
Sales > Orders에서 Helcim으로 결제된 주문을 엽니다. 주문 페이지 하단의 History와 Additional 옆에 있는 VibeFox Helcim Gateway 탭에는 Transaction ID(캡처 후에는 사전 승인 ID도)가 표시되며, 테스트 결제에는 Test mode 표시가 붙습니다. 또한 Transaction type과 캡처 상태, Invoice, Card와 승인 코드, Approved / order / refunded 금액, 캡처 버튼과 환불 양식, 환불 내역, 주문의 Helcim notes가 표시됩니다. 이 탭은 확장 프로그램에 접근 권한이 있는 사용자에게 표시되며, 캡처와 환불에는 수정 권한이 필요합니다(System > Users > User Groups에서 설정).
캡처
캡처되지 않은 사전 승인의 경우, 탭에서 Capture payment를 클릭하고(버튼에 금액이 표시됨) Capture the pre-authorized amount through Helcim?을 확인합니다. 환불을 뺀 현재 주문 합계가 캡처됩니다. 이 금액은 승인된 금액보다 적을 수는 있지만 많을 수는 없습니다. 캡처에는 주문이 결제된 모드의 토큰이 사용됩니다. 캡처가 성공하면 주문은 Order Status After Payment 상태가 됩니다. 캡처가 실패하면 탭에 이유가 표시되고 메모에 추가됩니다.
환불
탭에서 Amount를 입력합니다(아직 환불되지 않은 금액이 자동으로 채워집니다). 필요하면 Reason (optional)도 입력하고 Refund via Helcim을 클릭합니다. Refund this amount through Helcim? This cannot be undone.를 확인하십시오. 구매 또는 캡처된 사전 승인에 대한 전액 및 부분 환불이 지원되며, Helcim이 실제로 청구한 금액까지만 가능합니다. 따라서 부분 승인 후에는 고객이 결제한 금액 이상을 환불할 수 없습니다. 캡처되지 않은 사전 승인의 경우 버튼은 Release pre-authorization이 되며, 전체 금액만 해제할 수 있고, 보류가 제거되고 주문은 Canceled Status 상태가 됩니다.
환불은 주문이 결제된 모드로 전송되므로, 해당 모드의 토큰이 설정되어 있어야 합니다. Helcim이 승인한 경우에만 유효합니다. Helcim이 거절하면 탭에 오류가 표시되고 환불은 기록되지 않습니다. 성공한 환불은 Helcim 환불 거래 ID와 함께 환불 내역과 메모에 추가됩니다. 전액 환불은 고객에게 알리지 않고, 수동으로 상태를 변경한 것처럼 상품을 재고로 되돌리지 않은 채 주문을 Refunded Status 상태로 만듭니다. 부분 환불은 상태를 변경하지 않습니다. 시간 초과 후 재시도해도 두 번 환불되지 않습니다.
Sales > Returns의 상품 반품은 Helcim을 통해 돈을 돌려주지 않습니다. 이 확장 프로그램은 Helcim 웹훅을 받지 않으므로, Helcim 대시보드에서 수행한 캡처, 환불, 취소는 OpenCart에 반영되지 않습니다. 따라서 주문 페이지에서 처리하십시오.
라이선스 키
이 확장 프로그램은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록 License — VibeFox Helcim Gateway는 Extensions > Extensions > Payments > VibeFox Helcim Gateway > Edit의 첫 번째 블록이며, 설정 위에 있습니다. 키를 License key에 붙여 넣고 Activate를 클릭하십시오. 그 후 이 블록에는 마스킹된 키, 상태(예: 라이선스가 유효한 날짜와 쇼핑몰 도메인), 그리고 Check now(상태 다시 확인), Change key(다른 키 입력), Remove key(이 쇼핑몰에서 키 제거) 버튼이 표시됩니다. 그 아래에는 Product: opencart-payment-helcim 줄과 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 계정에서 슬롯을 해제하십시오.
유효한 키가 없으면 체크아웃에서 고객에게 Helcim이 표시되지 않습니다. 그럼에도 결제가 시작되면 고객에게 This payment method is not available. Please choose another one.가 표시됩니다. 같은 브라우저에서 관리자 화면에 로그인한 관리자 사용자는 쇼핑몰에서 (unlicensed — visible to admins only)로 표시된 결제 수단을 계속 볼 수 있으므로, 키를 구매하기 전에 확장 프로그램을 설정하고 테스트할 수 있습니다. OpenCart 4에서는 이 미리 보기를 사용할 수 없습니다. 쇼핑몰이 관리자 로그인을 인식하지 못하므로, 활성 키가 없으면 결제 수단이 모든 사용자에게 숨겨집니다. Edit 페이지를 한 번 열면 관리자 화면의 Dashboard에 알림이 나타납니다. ×로 닫으면 7일 동안 숨겨집니다. 기존 주문은 영향을 받지 않습니다. 이미 완료된 결제는 유지되며, 캡처와 환불도 계속 작동합니다.
라이선스가 만료되어도 확장 프로그램은 계속 작동하지만, 업데이트와 지원에는 갱신이 필요합니다. 상태는 관리자 화면의 Dashboard 또는 Edit 페이지를 열 때 자동으로 다시 확인됩니다. 키를 입력한 후 처음 14일 동안은 하루에 한 번, 그 후에는 일주일에 한 번입니다. cron 작업은 필요하지 않습니다. 확장 프로그램을 제거하면 라이선스 키와 라이선스 상태는 항상 삭제됩니다.
문제 해결
Helcim이 체크아웃에 나타나지 않음: 라이선스가 활성 상태인지, Enable / Disable이 켜져 있는지, 현재 모드에 API 토큰(Live API token, 또는 테스트 모드에서는 Test API token)이 설정되어 있는지, 체크아웃 통화가 Account currencies 중 하나인지 확인하십시오. 토큰이 없거나 쇼핑몰 통화가 허용되지 않으면 설정 페이지에 경고가 표시됩니다. 또한 결제 주소가 선택한 Geo Zone에 있고, 주문이 설정의 Total에 도달했는지도 확인하십시오.
고객이 We could not confirm your payment를 보았음: Helcim이 응답하지 않아 카드가 청구되었을 수 있습니다. 주문 메모와 로그에 Helcim 인보이스가 표시됩니다. 고객에게 다시 청구하기 전에 Helcim에서 해당 인보이스를 확인하십시오. 5분 이내의 재시도는 원래 결과를 반환하며 이중 청구되지 않습니다.
고객이 This payment method is temporarily unavailable를 봄: Helcim이 API 토큰을 거부했습니다. 주문 메모는 토큰과 그 권한을 확인하라고 안내합니다. API 액세스에 거래 처리 권한이 있는지 확인하십시오.
고객이 This payment method is not available. Please reload the checkout page.를 봄: 체크아웃 세션이 더 이상 주문과 일치하지 않거나, 그사이 결제 수단이 꺼졌거나, 토큰 또는 통화가 더 이상 맞지 않습니다. 고객은 체크아웃 페이지를 새로 고칩니다.
Helcim 사유로 결제 실패: Helcim이 카드나 청구 정보 등의 이유로 요청을 거절했습니다. 주문 메모와 로그에 세부 정보가 있습니다.
고객이 Your payment was received, but the order could not be completed를 봄: Helcim은 결제를 승인했지만 OpenCart가 주문 상태를 설정하지 못했습니다. 이유는 로그에 있습니다. 고객이 같은 장바구니를 다시 제출하면 두 번째 청구 없이 승인된 결제를 기준으로 상태가 설정됩니다.
주문이 검토 상태에 있음: VibeFox Helcim Gateway 탭의 메모를 읽으십시오. Helcim의 응답이 주문과 일치하지 않았습니다(응답 검증 실패). Helcim에서 거래를 확인한 후 주문을 처리하거나 결제를 환불하십시오.
캡처할 수 없음: 캡처할 금액은 0보다 커야 하고 승인된 금액을 넘으면 안 되며, 주문이 결제된 모드의 토큰이 설정되어 있어야 합니다.
환불 실패: 메시지를 확인하십시오. 캡처되지 않은 사전 승인은 전액으로만 해제할 수 있습니다. 모드에 관한 메시지는 주문이 결제된 모드의 토큰이 비어 있다는 뜻입니다. 거절된 환불은 기록되지 않습니다. You do not have permission to capture or refund (modify this extension).는 사용자 그룹에 확장 프로그램을 수정할 권한이 없다는 뜻입니다.
테스트 결제: 테스트 모드는 결제, 캡처, 환불을 Helcim 테스트 계정으로 보냅니다. 주문은 결제된 모드를 유지하므로, 나중에 모드를 바꿔도 해당 주문의 캡처와 환불이 다른 계정으로 옮겨지지 않습니다.
제거
Extensions > Extensions로 이동하여 유형을 Payments로 선택하고, VibeFox Helcim Gateway 옆의 Uninstall(빨간색 − 버튼)을 클릭합니다. 이 확장 프로그램의 라이선스 키와 라이선스 상태는 항상 제거됩니다. OpenCart는 확장 프로그램 자체의 설정을 항상 제거합니다. 즉 Enable / Disable, Sort Order, Geo Zone, Total과 Orders 섹션의 주문 상태는 재설치 시 기본값으로 돌아갑니다. OpenCart 4에서는 체크아웃 페이지 위에 메시지를 표시하는 이 확장 프로그램의 OpenCart 이벤트도 제거됩니다. Delete data on uninstall이 켜져 있으면 나머지 게이트웨이 설정(제목, 설명, API 토큰, 테스트 모드, 거래 유형, 계정 통화, 디버그 로그 스위치)과 로그가 삭제됩니다. 꺼져 있으면 이후 재설치를 위해 유지됩니다. Helcim 거래와 환불은 항상 유지되므로, 이전에 결제된 주문은 재설치 후에도 캡처하고 환불할 수 있습니다. 기존 주문은 결제 메모를 유지합니다.
OpenCart 4에서 확장 프로그램 파일까지 제거하려면, 제거한 후 Extensions > Installer로 이동하여 설치된 확장 프로그램 목록에서 VibeFox Helcim Gateway 옆의 Uninstall(주황색 − 버튼)을 클릭한 다음, 업로드된 패키지를 삭제하려면 Delete(빨간색 휴지통 버튼)를 클릭하십시오.
Helcim은 해당 소유자의 상표입니다. 이 확장 프로그램은 Helcim과 제휴하거나 Helcim의 승인을 받은 것이 아닙니다.
