VibeFox eWAY for WooCommerce — 도움말

요구 사항

WordPress: 6.0 이상.

WooCommerce: 8.0 이상, 설치 및 활성화되어 있어야 합니다.

PHP: 8.0 이상.

상점 통화: AUD, NZD, SGD, HKD 또는 MYR. 그 밖의 통화에서는 체크아웃에서 이 결제 수단이 표시되지 않습니다. 주문은 주문 자체의 통화로 청구됩니다.

eWAY 계정: Rapid API 접근 권한이 있는 eWAY 가맹점 계정과 그 Rapid API 키 및 비밀번호가 필요합니다. 키와 비밀번호는 MyeWAY의 Settings, API Key에서 확인할 수 있습니다. 테스트를 위해서는 자체 키와 비밀번호가 있는 eWAY 샌드박스 계정이 필요합니다. 샌드박스 키와 운영 키는 서로 다릅니다. eWAY에서 별도로 설정할 것은 없습니다. 모든 결제에 복귀 URL이 함께 전송됩니다.

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

설치

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

2. Activate를 클릭합니다.

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

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

5. 샌드박스 API 키와 비밀번호를 입력하고, Sandbox Mode는 켜 둔 채로 Enable/Disable을 켠 뒤, eWAY 테스트 카드 4444333322221111로 테스트 주문을 합니다.

6. 운영 API 키와 비밀번호를 입력하고, Sandbox Mode 체크를 해제한 뒤 저장합니다.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > eWAY. 입력란 위의 배지에 모드가 표시됩니다. SANDBOX(결제는 eWAY 샌드박스로 전송되며 실제 금액은 청구되지 않음) 또는 LIVE(운영 API 키로 실제 결제가 이루어짐). 현재 모드의 API 키나 비밀번호가 없으면(이 경우 체크아웃에 게이트웨이가 표시되지 않음) 또는 상점 통화가 지원되지 않으면 페이지에 경고가 표시됩니다. 결제 수단 목록에서는 현재 모드에 자격 증명이 입력될 때까지 eWAY가 설정 필요 상태로 표시되며, 샌드박스 모드에서는 테스트 모드 배지가 표시됩니다.

일반

Enable/Disable: Enable eWAY Payment Gateway는 이 결제 수단을 켜거나 끕니다. 기본값: 끔.

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

Description: 체크아웃에서 결제 수단 아래에 표시되는 문구입니다. 기본값: Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.

API 자격 증명

Rapid API 키와 비밀번호는 MyeWAY의 Settings, API Key에 있습니다. eWAY는 운영 키와 샌드박스 키에 대한 안내를 제공하며, 이 섹션에 링크가 있습니다. 샌드박스와 운영는 서로 다른 키를 사용합니다.

Sandbox Mode: Enable sandbox (test) mode는 샌드박스 키로 결제를 eWAY 샌드박스에 보냅니다. 실제 금액은 청구되지 않습니다. 기본값: 켬. 운영 키로 실제 결제를 받으려면 체크를 해제합니다.

Live API Key: eWAY 운영 계정의 Rapid API 키입니다.

Live API Password: eWAY 운영 계정의 Rapid API 비밀번호입니다.

Sandbox API Key: eWAY 샌드박스(partner/developer) 계정의 Rapid API 키입니다.

Sandbox API Password: eWAY 샌드박스 계정의 Rapid API 비밀번호입니다.

주문

Order Status on Success: eWAY가 결제를 확인한 후의 주문 상태입니다.

고급

Debug log: Enable logging은 API 호출과 결제 결과를 WooCommerce > Status > Logs에 기록합니다. 소스는 wcp_eway_payment_gateway입니다. 카드 정보와 키는 기록되지 않습니다. 오류는 항상 기록됩니다. 기본값: 끔.

Uninstall: Delete all plugin data on uninstall. 체크하면 플러그인을 삭제할 때 게이트웨이 설정과 로그가 제거됩니다. 주문에 저장된 결제 참조 정보는 유지됩니다. 기본값: 끔.

체크아웃

고객은 결제 수단(기본값 Credit Card (eWAY))을 선택하고 주문합니다. 플러그인은 주문 통화로 주문 총액에 대한 결제 페이지를 eWAY에 요청합니다. 이때 주문 번호를 청구 참조로, 고객의 청구 정보를 함께 보내며, 고객을 eWAY Responsive Shared Page로 이동시킵니다. 고객은 그곳에서 카드로 결제합니다. 결제는 즉시 승인됩니다.

결제 후 고객은 쇼핑몰로 돌아옵니다. 플러그인은 브라우저를 신뢰하지 않습니다. 이 주문에 대해 생성된 결제 페이지의 결과를 서버 간 통신으로 eWAY에 요청합니다. eWAY가 확인하고 승인된 금액과 통화가 주문과 일치할 때만 주문이 결제 완료로 표시됩니다. 그 다음 고객은 “주문 접수” 페이지에 도착합니다. 이 시점에 eWAY에 요청할 수 없었다면 주문은 “결제 대기” 상태로 남고, 페이지에는 We have not received the confirmation of your payment from eWAY yet. If you completed the payment, this order will be updated shortly — please do not pay again. 메시지가 표시됩니다. 결제는 “주문 접수” 페이지를 열 때, 그리고 WooCommerce가 미결제 주문을 자동으로 취소하기 전에 다시 확인됩니다.

결제가 거절되면 고객은 사유와 함께 체크아웃(또는 Pay for order 페이지)으로 돌아갑니다. 예: Your payment was declined: Insufficient funds. Please try again or use a different payment method. 고객이 eWAY 페이지에서 Cancel을 클릭하면 플러그인은 먼저 eWAY에 결제된 금액이 없는지 확인합니다. 체크아웃에서 생성된 주문은 취소되고, Pay for order 페이지에서 결제하려던 주문은 미결제 상태로 남습니다. 고객에게는 You cancelled the payment on the eWAY page. Your order has not been paid — you can try again. 메시지가 표시됩니다. 결제가 완료되지 않았다면 메시지는 The payment was not completed. Please try again. 입니다.

고객은 미결제 주문을 다시 결제할 수 있습니다. 주문의 모든 결제 페이지가 추적되므로, 이전 페이지를 통한 결제도 인식됩니다. eWAY가 결제 페이지를 만들 수 없으면 고객은 Payment error: Unable to connect to eWAY. Please try again. 같은 짧은 메시지를 보게 됩니다.

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

eWAY는 Shared Page에 대해 서버 간 알림을 보내지 않습니다. 결과는 고객이 돌아왔을 때와 위에서 설명한 확인 과정에서 가져옵니다. 플러그인은 귀하의 사이트에 카드 입력란이 없으며, 카드 저장이나 구독을 지원하지 않고, 승인만 하고 나중에 캡처하는 방식도 지원하지 않습니다. 또한 Beagle 사기 점수는 평가하지 않습니다(eWAY의 사기 방지 규칙으로 차단된 거래는 eWAY가 직접 거절합니다).

주문 및 환불

주문 상태

Pending payment: 고객이 eWAY로 이동했지만 아직 결제하지 않았거나, eWAY에서 결과를 아직 가져오지 못한 상태입니다(주문 메모에 표시됩니다).

Processing or Completed: 결제가 승인되었습니다. 상태는 Order Status on Success를 따릅니다. 주문 메모에는 eWAY 거래 ID, 승인 코드, 응답이 표시됩니다. 주문의 거래 ID는 eWAY 거래 ID입니다.

On hold after payment: eWAY가 주문과 다른 금액이나 통화를 승인한 경우(예: Approved for partial amount, 또는 고객이 결제 페이지를 연 뒤 주문이 수정된 경우), 또는 주문이 취소된 후에 결제가 승인된 경우입니다. 메모에 이유가 설명되어 있습니다. “주문 접수” 페이지에서 고객에게는 Your payment was received and is being reviewed by the store. We will contact you if anything is needed. 메시지가 표시됩니다. 주문을 완료하거나 결제를 환불하십시오.

Failed: eWAY가 결제를 거절했습니다. 메모에 eWAY 코드와 그 의미가 표시됩니다.

Cancelled: 고객이 체크아웃에서 주문한 후 eWAY 페이지에서 취소했거나, eWAY가 미결제를 확인한 뒤 귀하 또는 WooCommerce 재고 보류 시간 초과로 주문이 취소된 경우입니다.

이미 결제 완료된 주문에 대해 두 번째 결제가 승인되더라도 주문은 변경되지 않습니다. 메모에서 중복 결제를 MyeWAY에서 환불하라고 안내합니다.

환불

주문을 열고 Refund를 클릭한 뒤 금액을 입력하고 Refund via Credit Card (eWAY)를 클릭합니다(버튼에는 결제 수단 제목이 사용됩니다). 전액 환불과 부분 환불을 지원합니다. 환불은 결제가 이루어진 환경(샌드박스 또는 운영)으로 전송되므로, 해당 환경의 API 키와 비밀번호가 설정되어 있어야 합니다. eWAY가 환불을 거절하면 WooCommerce에 eWAY 코드가 표시되며 환불은 기록되지 않습니다. 환불이 성공하면 eWAY 환불 거래 ID와 함께 주문 메모에 추가됩니다.

MyeWAY에서 처리한 환불은 WooCommerce와 동기화되지 않습니다. 필요하면 eWAY 환불 버튼을 사용하지 말고 WooCommerce에서 수동 환불을 만드십시오.

라이선스 키

이 플러그인은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록은 WooCommerce > Settings > Payments > eWAY 상단에 있습니다. 키를 License key에 붙여 넣고 Activate를 클릭합니다. 블록에는 라이선스가 유효한 날짜와 귀하의 도메인 같은 상태가 표시됩니다. Check now로 상태를 다시 확인하고, Change key로 다른 키를 입력하며, Remove key로 이 사이트에서 키를 제거합니다. Manage licenses and domains in your account 링크는 vibefox.net 계정을 엽니다.

키 하나는 도메인 하나에서만 작동합니다. 사이트에서 키를 제거해도 해당 도메인 슬롯은 해제되지 않습니다. vibefox.net 계정에서 슬롯을 해제하십시오.

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

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

문제 해결

eWAY does not appear at checkout: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 현재 모드의 API 키와 비밀번호가 설정되어 있는지(샌드박스 모드에서는 샌드박스 필드, 운영 모드에서는 운영 필드), 상점 통화가 AUD, NZD, SGD, HKD 또는 MYR인지 확인하십시오. Pay for order 페이지에서는 주문 통화가 확인됩니다.

The payment went through, but the order stays Pending payment: 고객이 eWAY에서 돌아오지 않았거나, 그 시점에 eWAY에 요청할 수 없었습니다. eWAY는 Shared Page에 대한 알림을 보내지 않습니다. 결제는 “주문 접수” 페이지를 열 때, 그리고 WooCommerce가 미결제 주문을 취소하기 전에 다시 확인됩니다. MyeWAY에서 거래를 확인하고 WooCommerce > Status > Logs(소스 wcp_eway_payment_gateway)를 확인하십시오.

고객이 This payment method is temporarily unavailable 메시지를 봅니다: 현재 모드의 API 키 또는 비밀번호가 없거나 eWAY가 이를 거절했습니다. 현재 모드의 자격 증명을 확인하십시오.

고객이 eWAY could not start the payment 메시지를 봅니다: eWAY가 오류 코드를 반환했으며, 그 코드가 메시지에 표시됩니다. 대개 청구 정보가 올바르지 않은 경우입니다.

고객이 We could not match this payment to an order 메시지를 봅니다: 복귀 링크가 이 쇼핑몰의 어떤 주문에도 속하지 않습니다. 고객에게 청구가 되었다면 MyeWAY에서 결제를 찾으십시오.

고객이 We could not confirm your payment with eWAY 메시지를 봅니다: 결제 결과를 확인할 수 없었습니다. 결과를 가져오면 주문이 업데이트됩니다. 고객은 다시 결제하지 않아야 합니다.

Order is On hold after payment: 주문 메모를 읽어 보십시오. 승인된 금액이나 통화가 주문과 달랐거나, 주문이 취소된 후에 결제가 도착했습니다. 주문을 완료하거나 결제를 환불하십시오.

샌드박스 또는 운영 모드와 관련된 메시지와 함께 환불이 실패합니다: 주문은 그 환경에서 결제되었으며, 해당 환경의 API 키와 비밀번호가 설정되어 있지 않습니다. 입력한 뒤 다시 시도하십시오.

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

개발자의 경우, readme에는 eWAY 계정이 더 많은 통화에 대해 활성화된 경우 사용할 수 있는 eway_p_supported_currencies 필터가 나와 있습니다.

제거

플러그인을 비활성화하면 모든 데이터가 유지됩니다. 제거하려면 Plugins 페이지에서 비활성화한 뒤 삭제하십시오. 이 플러그인의 라이선스 키와 라이선스 상태는 항상 제거됩니다. 게이트웨이 설정과 로그는 Uninstall(Delete all plugin data on uninstall)이 켜져 있을 때만 제거됩니다. 그렇지 않으면 나중에 재설치할 수 있도록 남아 있습니다. 주문에 저장된 결제 참조 정보는 항상 유지됩니다. 기존 주문은 결제 메모와 거래 ID를 그대로 유지합니다.

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