VibeFox Cardcom for WooCommerce — 도움말

요구 사항

WordPress: 6.0 이상.

WooCommerce: 8.0 이상, 설치 및 활성화되어 있어야 합니다. WooCommerce가 없으면 플러그인이 활성화되지 않습니다.

PHP: 8.0 이상.

HTTPS: Cardcom이 결제 알림을 보낼 수 있도록 쇼핑몰 사이트는 HTTPS로 인터넷에서 접근할 수 있어야 합니다.

통화: 주문 통화는 ILS, USD, EUR 또는 GBP여야 합니다. 그 밖의 통화에서는 체크아웃에서 결제 수단이 숨겨집니다.

Cardcom 계정: 운영 결제에는 터미널 번호, API 사용자 이름, API 비밀번호가 있는 Cardcom 가맹점 계정이 필요합니다. 결제에는 터미널 번호와 API 사용자 이름만 필요합니다. API 비밀번호는 WooCommerce에서 하는 환불에만 사용됩니다. 테스트 모드는 Cardcom 계정 없이도 작동합니다.

VibeFox 라이선스 키: vibefox.net에서 구매합니다. 키 1개는 도메인 1개에서 작동합니다.

설치

1. WordPress에서 Plugins > Add New > Upload Plugin으로 이동하여 플러그인 ZIP 파일을 선택한 다음 Install Now를 클릭하세요. FTP로 wcp_cardcom_payment_gateway 폴더를 /wp-content/plugins/에 업로드할 수도 있습니다.

2. Activate를 클릭하세요.

3. 설정을 엽니다: WooCommerce > Settings > Payments > Cardcom > Manage, 또는 플러그인 페이지에서 플러그인 이름 아래의 Settings를 클릭하세요.

4. 페이지 상단의 라이선스 영역에 VibeFox 라이선스 키를 입력하고 Activate를 클릭하세요.

5. Enable/Disable을 켜고 Test Mode는 켠 상태로 두세요. 카드 4580 0000 0000 0000, 만료일은 미래의 아무 날짜, CVV 123으로 테스트 주문을 하세요.

6. 실제 결제를 받으려면 Test Mode 체크를 해제하고 Cardcom에서 받은 Terminal Number, API Username, API Password를 입력하세요.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > Cardcom. 테스트 모드가 켜져 있는 동안에는 입력 항목 위에 Test mode is on.이 표시됩니다. 운영 모드에서는 터미널 번호 또는 API 사용자 이름이 없으면 경고가 표시되며(이 경우 Cardcom은 체크아웃에서 숨겨집니다), API 비밀번호가 없으면 WooCommerce에서 환불할 수 없다는 안내가 표시됩니다. 쇼핑몰 통화가 지원되지 않으면 경고도 표시됩니다. 터미널 번호 또는 API 사용자 이름 없이 운영 모드를 저장하면, 입력될 때까지 게이트웨이가 체크아웃에서 숨겨진다는 오류 메시지가 표시됩니다.

일반

Enable/Disable: Enable Cardcom Payment Gateway로 결제 수단을 켜거나 끕니다. 기본값: 꺼짐.

Title: 체크아웃에서 고객이 보는 결제 수단 이름입니다. 기본값: Credit Card (Cardcom).

Description: 체크아웃에서 결제 수단 아래에 표시되는 문구입니다. 기본값: Pay securely with your credit card via Cardcom.

테스트 모드

테스트 모드는 공개 Cardcom 테스트 터미널 1000(API 사용자 CardTest1994)을 사용합니다. 실제 돈은 청구되지 않으며 Cardcom 계정도 필요하지 않습니다. 테스트 카드: 4580 0000 0000 0000, 만료일은 미래의 아무 날짜, CVV 123. 테스트 모드에서는 체크아웃에도 이 테스트 카드에 대한 안내 줄이 표시됩니다.

Test Mode: Enable test mode (terminal 1000, no real money). 기본값: 켜짐. 체크를 해제하면 아래 운영 자격 증명으로 실제 결제를 받습니다. 환불은 항상 주문이 결제된 모드의 자격 증명으로 전송됩니다.

운영 자격 증명

터미널 번호, API 사용자 이름, API 비밀번호는 가맹점 계정과 함께 Cardcom에서 제공합니다. Cardcom 대시보드의 API 설정 또는 Cardcom 지원팀에서 확인할 수 있습니다. 이 필드는 운영 모드에서만 사용됩니다.

Terminal Number: Cardcom 터미널 번호입니다. 숫자만 입력해야 합니다. 다른 문자를 입력하면 오류가 표시되고 이전 값이 유지됩니다.

API Username: 이 터미널의 Cardcom API 사용자 이름(ApiName)입니다. 저장할 때 공백이 제거됩니다.

API Password: Cardcom API 비밀번호입니다. WooCommerce에서 하는 환불에만 필요하며, 입력한 그대로 저장됩니다.

결제 페이지

Cardcom은 이 섹션에 표시된 주소로 결제 알림(IndicatorUrl)을 보냅니다. 주소 형식은 https://your-site/wc-api/cardcom_p_callback/과 같습니다. 이 주소는 주문 ID와 함께 모든 결제마다 자동으로 Cardcom에 전달되므로 Cardcom에서 따로 설정할 것은 없습니다. 주소는 인터넷에서 접근할 수 있어야 합니다.

Operation: Cardcom 결제 페이지에서 Cardcom이 수행하는 작업입니다.

Max Installments: 고객이 Cardcom 페이지에서 선택할 수 있는 최대 할부 횟수(결제 횟수)로, 1–36입니다. 1은 할부 없음을 뜻합니다. 기본값: 1.

Success Order Status: 결제가 확인된 후의 주문 상태입니다. 상태는 한 번에 설정되며, 두 번째 상태 변경은 없습니다.

고급

Debug log: Log API requests and notifications는 WooCommerce > Status > Logs에 소스 wcp_cardcom_payment_gateway로 기록합니다. 오류는 항상 기록됩니다. 자격 증명, 카드 토큰, 카드 소유자 정보는 절대 기록되지 않습니다. 기본값: 꺼짐.

Delete on Uninstall: Delete all plugin data when uninstalling. 켜져 있으면 플러그인을 삭제할 때 설정, 주문에 저장된 Cardcom 데이터, 로그가 영구적으로 제거됩니다. 주문 자체는 유지됩니다. 기본값: 꺼짐.

체크아웃

고객은 결제 수단(기본값: Credit Card (Cardcom))을 선택하고 주문합니다. 플러그인은 주문 통화로 된 주문 합계에 대한 Cardcom 결제 페이지를 생성하고 고객을 그곳으로 보냅니다. 쇼핑몰 언어가 히브리어이면 페이지는 히브리어로, 그 밖에는 영어로 열립니다. 주문 품목은 상품명으로 Cardcom에 전달됩니다. 고객은 카드 정보를 입력하고, 할부가 허용된 경우 결제 횟수를 선택합니다.

결제 후 고객은 쇼핑몰의 주문 접수 페이지로 돌아갑니다. Cardcom이 결제를 확인한 후에만 주문이 결제 완료로 표시됩니다. Cardcom이 알림 주소를 호출하면 플러그인은 그 호출에서 결제 페이지 코드만 가져옵니다. 이 코드가 해당 주문에 대해 쇼핑몰에서 발급된 것인지 확인한 다음, 서버 간 통신으로 Cardcom에 실제 결과를 요청합니다. 알림이 늦게 도착하면, 고객이 주문 접수 페이지에 도착할 때 같은 확인이 실행됩니다.

결제가 완료되지 않으면 Cardcom은 고객을 체크아웃(또는 Pay for order 페이지)으로 돌려보내고, 이때 The card payment was not completed. Please try again or choose a different payment method.가 표시됩니다. Cardcom이 확인한 거부된 결제는 주문을 실패로 표시합니다. 고객은 결제되지 않은 주문을 다시 결제할 수 있습니다. 예를 들어 Pay for order 페이지에서 가능합니다. 같은 주문의 이전 결제 페이지에서 이루어진 결제도 여전히 인식됩니다. 고객이 다른 결제 수단으로 바꿨지만 Cardcom 페이지에서 결제한 경우, 결제는 기록되고 결제 수단은 다시 Cardcom으로 설정됩니다.

Cardcom이 결제 페이지를 열 수 없으면 고객에게 Could not connect to Cardcom. Please try again in a moment.와 같은 짧은 메시지가 표시되거나, Cardcom 코드와 함께 Cardcom이 결제 페이지를 열 수 없었다는 메시지가 표시됩니다. 고객은 다른 결제 수단을 선택할 수 있습니다.

이 결제 수단은 클래식 체크아웃, 체크아웃 블록, Pay for order 페이지에서 작동합니다. WooCommerce 고성능 주문 저장소(HPOS)와 호환됩니다.

플러그인은 Cardcom 페이지에서의 카드 결제만 받습니다. 저장된 카드나 원클릭 결제, 구독을 지원하지 않으며, 저장된 토큰으로 청구하지 않고, Cardcom 인보이스 또는 영수증 설정이 없으며, Cardcom을 통한 Bit, Apple Pay, Google Pay 또는 PayPal도 지원하지 않습니다. iframe 모드와 나중 캡처 거래도 없습니다. 중단된 결제 페이지는 자동으로 확인되지 않습니다.

주문 및 환불

주문 상태

Pending payment: 고객이 Cardcom으로 이동했지만 아직 결제하지 않았거나, Cardcom이 아직 결제를 확인하지 않았습니다.

Processing, Completed or On Hold: 결제가 확인되었습니다. 상태는 Success Order Status 설정을 따릅니다. 주문 메모에는 Cardcom 거래가 표시되며, Cardcom이 제공하는 경우 카드 끝 4자리, 인보이스 번호, 할부 횟수도 표시됩니다. 테스트 결제에는 Test mode — no real money was charged.가 표시됩니다. 주문의 거래 ID는 Cardcom 거래 번호입니다.

On hold after payment: Cardcom이 주문과 일치하지 않는 결제를 확인했습니다. 예를 들어 결제 페이지를 연 후 주문 합계가 변경되었거나, 다른 금액 또는 통화가 청구된 경우입니다. 주문 메모에 설명되어 있습니다. Cardcom 대시보드에서 결제를 주문과 대조한 다음 주문을 이행하거나 결제를 환불하세요.

Failed: Cardcom이 결제를 거부했습니다. 주문 메모에 Cardcom 응답 코드가 표시됩니다. 이전 결제 페이지에서의 거부는 더 새로운 시도를 실패로 만들지 않으며, 늦게 도착한 거부는 결제 완료된 주문을 절대 변경하지 않습니다.

이미 결제된 주문에 두 번째 성공 결제가 도착하면(예: 고객이 브라우저 탭 두 개에서 결제한 경우), 주문은 다시 변경되지 않습니다. 메모는 고객이 이중으로 청구되었을 수 있다고 경고하며, Cardcom 대시보드에서 환불하라고 안내합니다.

환불

주문을 열고 Refund를 클릭한 다음 금액을 입력하고 Refund via Credit Card (Cardcom)를 클릭하세요(버튼에는 결제 수단 제목이 표시됩니다). 전액 및 부분 환불을 지원하며, 한 주문에 대해 부분 환불을 여러 번 할 수 있습니다. 환불은 주문이 결제된 모드의 자격 증명으로 전송됩니다. 즉, 운영 모드로 전환한 후에도 테스트 주문은 Cardcom 테스트 터미널에서 환불되고, 운영 주문은 항상 운영 자격 증명을 사용합니다. 운영 환불에는 API Username과 API Password가 필요합니다. Cardcom이 환불을 수락하지 않으면 WooCommerce가 오류를 표시하고 환불은 기록되지 않습니다. 성공한 환불은 Cardcom 환불 거래와 사유와 함께 주문 메모에 추가됩니다.

Cardcom 대시보드에서 한 환불은 쇼핑몰로 보고되지 않습니다. 필요하면 게이트웨이의 Refund via 기능을 사용하지 않고 WooCommerce에서 수동 환불을 생성하세요.

라이선스 키

플러그인은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 영역은 WooCommerce > Settings > Payments > Cardcom 페이지 상단에 있습니다. 키를 License key에 붙여 넣고 Activate를 클릭하세요. 이 영역에는 상태(예: 라이선스가 유효한 기한)와 도메인이 표시됩니다. 상태를 다시 확인하려면 Check now, 다른 키를 입력하려면 Change key, 이 사이트에서 키를 제거하려면 Remove key를 사용하세요. Manage licenses and domains in your account 링크를 클릭하면 vibefox.net 계정이 열립니다.

키 1개는 도메인 1개에서 작동합니다. 사이트에서 키를 제거해도 도메인 슬롯은 비워지지 않습니다. vibefox.net 계정에서 슬롯을 비우세요.

활성 키가 없으면 체크아웃에서 고객에게 Cardcom이 표시되지 않습니다. 결제가 그래도 시작되면 고객에게 This payment method is not available. Please choose another one.가 표시됩니다. 로그인한 쇼핑몰 관리자에게는 결제 수단이 여전히 표시되며 (unlicensed — visible to admins only)로 표시되므로, 키를 구매하기 전에 플러그인을 설정하고 테스트할 수 있습니다. 플러그인 페이지와 WooCommerce 페이지에 알림이 표시됩니다. 기존 주문은 영향을 받지 않습니다. 이미 시작된 결제는 계속 확인되며, 환불도 작동합니다.

라이선스가 만료되어도 플러그인은 계속 작동하지만, 업데이트와 지원을 받으려면 갱신이 필요합니다. 상태는 백그라운드에서 자동으로 다시 확인됩니다.

문제 해결

체크아웃에 Cardcom이 표시되지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 주문 통화가 ILS, USD, EUR 또는 GBP인지 확인하세요. 운영 모드에서는 Terminal Number와 API Username이 입력되어 있는지 확인하세요. 설정 페이지에 누락된 항목이 있으면 경고가 표시됩니다.

결제는 완료됐지만 주문이 Pending payment 상태로 남아 있음: Cardcom이 사이트에 접근하지 못했습니다. 예를 들어 유지 보수 모드, 방화벽, 비밀번호 보호 또는 로컬 개발 사이트 때문일 수 있습니다. 알림 주소는 인터넷에서 HTTPS로 접근할 수 있어야 합니다. 고객이 주문 접수 페이지로 돌아올 때도 주문이 확인됩니다. Debug log를 켜고 WooCommerce > Status > Logs에서 소스 wcp_cardcom_payment_gateway를 확인하세요.

알림 응답: Missing or invalid lowprofilecode 또는 Unknown lowprofilecode for this order: 이 호출에 해당 주문에 대해 쇼핑몰에서 발급한 결제 페이지 코드가 없었습니다. 주문은 변경되지 않습니다.

알림 응답: Gateway not configured 또는 Indicator check failed: 결제 페이지가 생성된 모드의 자격 증명이 없거나, 확인을 위해 Cardcom에 연결할 수 없었습니다. 주문은 변경되지 않으며, 고객이 쇼핑몰로 돌아올 때 다시 확인됩니다.

알림 응답: ReturnValue mismatch 또는 Terminal mismatch: Cardcom이 다른 주문 또는 다른 터미널에 대한 결제를 보고했습니다. 주문은 변경되지 않습니다. Terminal Number가 계정의 터미널인지 확인하세요.

고객에게 Payment error: this currency is not supported by Cardcom.:가 표시됨: 주문 통화가 ILS, USD, EUR 또는 GBP가 아닙니다.

고객에게 Card payment is temporarily unavailable. Please choose another payment method.:가 표시됨: 운영 모드가 켜져 있지만 터미널 번호 또는 API 사용자 이름이 없습니다.

고객이 주문할 때 오류를 봄: 주문 메모를 열거나 Debug log를 켜고 로그를 확인하세요. 연결 문제와 Cardcom 오류 코드가 거기에 기록됩니다.

결제 후 주문이 On hold 상태임: 주문 메모를 읽어 보세요. 결제된 금액 또는 통화가 주문과 달랐습니다. 주문을 이행하거나 결제를 환불하세요.

환불 실패, 메시지: API username and API password are required for refunds: 설정에서 API Password(및 API Username)를 입력한 다음 다시 시도하세요.

환불 실패, 메시지: Could not connect to Cardcom: 환불이 이루어졌을 수도 있고 아닐 수도 있으므로, 다시 시도하기 전에 Cardcom 대시보드를 확인하세요.

라이선스 영역에 오류가 표시됨: 영역에 표시된 메시지를 따르세요. 예를 들어 키가 이미 다른 도메인에서 사용 중이면, vibefox.net 계정에서 슬롯을 비운 후 Check now를 클릭하세요. 사이트 주소가 변경되었다면 Check now를 클릭하여 새 도메인에 대해 키를 활성화하세요. 라이선스 서버에 연결할 수 없으면 플러그인은 마지막으로 확인된 상태로 계속 작동합니다.

개발자의 경우, readme 파일에 통화 목록을 확장하는 필터 cardcom_p_supported_currencies가 나와 있습니다(Cardcom 터미널에서 활성화된 통화만 추가하세요).

제거

플러그인을 비활성화하면 모든 데이터가 유지됩니다. 제거하려면 Plugins 페이지에서 비활성화한 후 삭제하세요. 이 플러그인의 라이선스 키와 라이선스 상태는 항상 제거됩니다. 게이트웨이 설정, 주문에 저장된 Cardcom 데이터, 로그는 Delete on Uninstall이 켜져 있었던 경우에만 제거됩니다. 그렇지 않으면 나중에 재설치할 때를 위해 유지됩니다. 기존 주문은 결제 메모와 거래 ID를 그대로 유지합니다.

Cardcom은 해당 소유자의 상표입니다. 이 플러그인은 Cardcom과 제휴하거나 Cardcom의 승인을 받지 않았습니다.