VibeFox CorvusPay for WooCommerce — 도움말

요구 사항

WordPress: 6.0 이상.

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

PHP: 8.0 이상.

통화: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK 또는 USD. 그 외 통화에서는 결제 수단이 체크아웃에서 숨겨집니다. 금액은 소수점 2자리로 전송되며, 소수점 자릿수가 더 많은 합계(예: 소수점 3자리를 사용하는 BHD 쇼핑몰)는 반올림되지 않고 거부됩니다.

CorvusPay 계정: CorvusPay 가맹점 계정이 필요합니다. CorvusPay는 쇼핑몰마다, 테스트와 운영을 구분하여 Store ID와 Secret Key를 발급하며, 이는 CorvusPay Merchant Center에 표시됩니다. 플러그인의 Success URL과 Cancel URL을 그곳에 입력해야 합니다(설정 참조).

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

설치

1. WordPress에서 Plugins > Add New > Upload Plugin으로 이동해 플러그인 ZIP 파일을 선택하고 Install Now를 클릭합니다. wcp_corvuspay_gateway 폴더를 FTP로 /wp-content/plugins/에 업로드해도 됩니다.

2. Activate를 클릭합니다.

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

4. 페이지 상단의 라이선스 블록에 VibeFox 라이선스 키를 입력하고 Activate를 클릭합니다.

5. CorvusPay 테스트 쇼핑몰의 Store ID와 Secret Key를 입력합니다(실제 결제를 받으려면 운영 쇼핑몰의 값도 입력). 설정 페이지에 표시된 Success URL과 Cancel URL을 테스트 쇼핑몰용과 운영 쇼핑몰용으로 CorvusPay Merchant Center에 복사합니다.

6. Enable/Disable을 켜고 테스트 주문을 한 다음, Test Mode 체크를 해제하여 운영으로 전환합니다.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > CorvusPay. 이 페이지는 테스트 모드가 켜져 있는 동안 필드 위에 Test mode is on.을 표시하고, 게이트웨이가 활성화되어 있는데 현재 모드의 Store ID 또는 Secret Key가 비어 있는 경우(값이 입력될 때까지 체크아웃에서 숨겨집니다)와 쇼핑몰 통화를 CorvusPay에서 지원하지 않는 경우에 경고를 표시합니다.

일반

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

Title: 고객이 체크아웃에서 보는 결제 수단 이름. 기본값: Credit/Debit Card (CorvusPay).

Description: 체크아웃에서 결제 수단 아래에 표시되는 텍스트. 기본값: Pay securely with your credit or debit card via CorvusPay. 테스트 모드에서는 여기에 (Test mode — no real payment is taken.)가 추가됩니다.

쇼핑몰 인증 정보

Store ID와 Secret Key는 CorvusPay가 쇼핑몰마다(테스트와 운영을 구분하여) 발급하며 CorvusPay Merchant Center에 표시됩니다.

Test Mode: Enable test mode는 CorvusPay 테스트 환경(wallet.test.corvuspay.com)과 테스트용 Store ID 및 Secret Key를 사용합니다. 기본값: 켜짐.

Test Store ID: CorvusPay 테스트 쇼핑몰의 숫자 Store ID.

Test Secret Key: CorvusPay 테스트 쇼핑몰의 Secret Key. HMAC-SHA256 서명에 사용됩니다.

Live Store ID: CorvusPay 운영 쇼핑몰의 숫자 Store ID.

Live Secret Key: CorvusPay 운영 쇼핑몰의 Secret Key. HMAC-SHA256 서명에 사용됩니다.

Store ID에는 숫자만 사용할 수 있습니다. 다른 값을 입력하면 오류가 표시되고 이전 값이 유지됩니다. 결제는 항상 그 결제가 이루어진 쇼핑몰의 Secret Key로 확인되므로, 테스트 주문이 아직 열려 있는 동안에는 테스트 키를 입력된 상태로 두세요.

Success URL 및 Cancel URL

이 섹션에 표시된 두 주소를 테스트 쇼핑몰용과 운영 쇼핑몰용으로 CorvusPay Merchant Center에 복사합니다. CorvusPay는 결제 후 고객을 이 주소로 돌려보냅니다.

결제

Transaction Type: 카드를 청구하는 방식.

Payment Page Language: CorvusPay 결제 페이지의 언어. Site language(기본값)는 CorvusPay가 지원하는 경우 사이트의 현재 언어를 사용하고, 그렇지 않으면 영어를 사용합니다. 크로아티아어, 영어, 독일어, 이탈리아어, 세르비아어, 슬로베니아어 중에서 선택할 수도 있습니다.

Order Status After Payment: Sale 결제 성공 후의 주문 상태. 상태는 두 번째 상태 변경 없이 즉시 설정됩니다.

고급

Logging: Enable debug logging은 WooCommerce > Status > Logs의 소스 wcp_corvuspay_gateway에 기록합니다. 오류는 항상 기록되며, 비밀 값과 고객 데이터는 절대 기록되지 않습니다. 기본값: 꺼짐.

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled). 비활성화해도 아무것도 삭제되지 않습니다. 주문에 저장된 결제 데이터는 항상 유지됩니다. 기본값: 꺼짐.

체크아웃

고객은 결제 수단(기본값은 Credit/Debit Card (CorvusPay))을 선택하고 주문합니다. 주문은 결제 대기 중 상태로 유지되며, Pay for order 페이지에 Redirecting to CorvusPay for payment. Please wait...가 표시되고 서명된 양식이 CorvusPay 결제 페이지로 전송됩니다. 리디렉션이 시작되지 않으면 고객이 Pay via CorvusPay를 클릭합니다. 주문 합계, 통화, 간단한 장바구니 설명, 청구 정보(결제 페이지를 미리 채우기 위함)가 전송됩니다. 금액이 바뀌지 않는 동안에는 같은 CorvusPay 주문 번호가 재사용되며, CorvusPay는 해당 번호에 대한 두 번째 결제를 받지 않습니다.

결제 후 CorvusPay는 고객을 Success URL로 돌려보냅니다. 주문은 CorvusPay가 확인한 후에만 결제 완료로 표시됩니다. CorvusPay 주문 번호가 이 주문을 위해 발급된 것이어야 하고, 서명이 결제가 이루어진 쇼핑몰의 Secret Key와 일치해야 하며, 금액과 통화가 주문과 일치해야 합니다. 그런 다음 고객은 주문 접수 완료 페이지로 이동합니다. 재고는 결제가 확인될 때 차감되고, 장바구니는 주문 접수 완료 페이지에서 비워집니다.

고객이 CorvusPay 페이지에서 취소하면 미결제 주문은 취소되고, 고객은 장바구니가 그대로 유지된 채 The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method.와 함께 체크아웃으로 돌아갑니다. 결제가 Pay for order 페이지에서 시작되었고 장바구니가 비어 있으면, WooCommerce가 장바구니 페이지에 The CorvusPay payment was cancelled and the order was not paid.를 표시합니다. Success URL 요청을 확인할 수 없는 경우 고객에게는 We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again.가 표시되며 주문은 변경되지 않습니다.

이 결제 수단은 클래식 체크아웃, 체크아웃 블록, Pay for order 페이지에서 작동합니다. WooCommerce High-Performance Order Storage(HPOS)와 호환됩니다. 텍스트는 크로아티아어로 번역되어 있습니다.

주문은 CorvusPay가 고객을 Success URL로 돌려보낼 때만 확정되며, 서버 간 알림은 없습니다. 고객이 결제 직후 브라우저를 닫으면 주문은 결제 대기 중 상태로 남습니다. 이 플러그인은 WooCommerce에서의 환불, 캡처, 무효화를 지원하지 않으며(CorvusPay 서버 API에는 클라이언트 인증서가 필요합니다), 저장된 카드, 구독, 할부, IBAN / PIS, CorvusWallet 옵션도 없습니다.

주문

주문 상태

Pending payment: 고객이 CorvusPay로 이동했으며 아직 돌아오지 않았습니다. 고객이 결제했지만 돌아오지 않은 경우, CorvusPay Merchant Center에서 결제를 확인하고 주문을 수동으로 완료하세요.

Processing, Completed 또는 On Hold: Sale 결제가 확인되었습니다. 상태는 Order Status After Payment를 따릅니다. 주문 메모에는 CorvusPay 주문 번호, 승인 코드, 카드 종류가 표시됩니다. 주문의 거래 ID는 CorvusPay 거래 ID이며, CorvusPay가 보내지 않은 경우에는 CorvusPay 주문 번호입니다. 이 번호로 Merchant Center에서 결제를 찾을 수 있습니다.

On hold, 승인됨: Authorize only가 선택되어 있습니다. CorvusPay Merchant Center에서 결제를 캡처한 다음 주문을 처리 중으로 변경하세요.

On hold, 금액/통화 불일치: 결제된 금액 또는 통화가 주문과 일치하지 않습니다. CorvusPay Merchant Center에서 결제를 확인하기 전에는 배송하지 마세요.

On hold, 취소된 주문에 대한 결제: 주문이 취소된 후(예: 미결제 주문 시간 초과로 인해) 성공한 결제가 도착했습니다. 주문을 이행하거나 CorvusPay Merchant Center에서 결제를 환불하세요.

Cancelled: 고객이 CorvusPay 페이지에서 결제를 취소했습니다.

이미 결제되었거나 종료된 주문에 대해 다른 성공한 결제가 도착하면 주문은 변경되지 않습니다. 메모에서 CorvusPay Merchant Center를 확인하고 필요한 경우 중복 결제를 환불하도록 안내합니다.

Refunds: WooCommerce에서의 환불, 캡처, 무효화는 지원되지 않습니다. CorvusPay Merchant Center에서 처리하고 환불 내역은 WooCommerce에 수동으로 기록하세요.

라이선스 키

플러그인은 vibefox.net의 VibeFox 라이선스 키로 작동합니다. 라이선스 블록은 WooCommerce > Settings > Payments > CorvusPay 상단에 있습니다. 키를 License key에 붙여 넣고 Activate를 클릭합니다. 블록에는 상태가 표시되며, 예를 들어 라이선스 만료일과 도메인이 나타납니다. 상태를 다시 확인하려면 Check now, 다른 키를 입력하려면 Change key, 이 사이트에서 키를 제거하려면 Remove key를 사용합니다. Manage licenses and domains in your account 링크는 vibefox.net 계정을 엽니다.

키 하나는 도메인 하나에서 사용할 수 있습니다. 사이트에서 키를 제거해도 해당 도메인 슬롯은 해제되지 않습니다. 슬롯은 vibefox.net 계정에서 해제하세요.

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

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

문제 해결

CorvusPay가 체크아웃에 나타나지 않음: 라이선스가 유효한지, Enable/Disable이 켜져 있는지, 현재 모드의 Store ID와 Secret Key가 입력되어 있는지(테스트 모드에서는 Test Store ID와 Test Secret Key, 운영 모드에서는 Live Store ID와 Live Secret Key), 쇼핑몰 통화를 CorvusPay에서 지원하는지 확인하세요. 설정 페이지는 각 경우에 경고를 표시합니다.

결제는 완료되었지만 주문이 결제 대기 중으로 남음: Success URL이 CorvusPay Merchant Center에 입력되지 않았거나, WooCommerce의 Secret Key가 쇼핑몰과 일치하지 않을 가능성이 큽니다. Logging을 켜고 WooCommerce > Status > Logs의 소스 wcp_corvuspay_gateway에서 INVALID signature를 찾아보세요. 고객이 돌아오기 전에 브라우저를 닫은 경우에도 주문은 대기 상태로 남습니다. 이 경우 Merchant Center에서 결제를 확인하고 주문을 수동으로 완료하세요.

고객에게 We could not confirm this CorvusPay payment가 표시됨: Success URL 요청이 거부되었습니다. 필수 필드가 없었거나, CorvusPay 주문 번호가 해당 주문을 위해 발급되지 않았거나, 해당 쇼핑몰의 Secret Key가 비어 있거나, 서명이 일치하지 않았습니다. 주문은 변경되지 않습니다. 이유는 로그에 표시됩니다.

고객에게 This order total cannot be paid via CorvusPay가 표시됨: 합계가 0이거나 소수점 자릿수가 2자리를 넘습니다.

고객에게 CorvusPay is not configured 또는 CorvusPay does not accept payments in …가 표시됨: 현재 모드의 Store ID 또는 Secret Key가 없거나 주문 통화가 지원되지 않습니다.

주문이 On hold 상태임: 주문 메모를 읽어 보세요. Authorize only가 선택되었거나, 결제된 금액 또는 통화가 주문과 일치하지 않았거나, 주문이 취소된 후에 결제가 도착한 경우입니다.

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

제거

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

CorvusPay는 해당 소유자의 상표입니다. 이 플러그인은 CorvusPay와 제휴 관계가 없으며 CorvusPay의 승인을 받지 않았습니다.