VibeFox MakeCommerce for WooCommerce — 도움말

요구 사항

WordPress: 6.0 이상.

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

PHP: 8.0 이상.

사이트에 대한 인터넷 접근성: MakeCommerce는 쇼핑몰로 결제 알림을 전송하므로 사이트가 인터넷에서 접근 가능해야 합니다(HTTPS 권장). 방화벽, 유지보수 모드 또는 기본 인증(Basic Auth)이 알림을 차단할 수 있습니다.

MakeCommerce 계정: MakeCommerce Merchant Portal(Settings > API)의 Shop ID와 Secret key가 필요합니다. 테스트 환경과 운영 환경은 별도의 계정과 키를 사용합니다. 제공되는 결제 수단 및 통화는 MakeCommerce 계약에 따라 정의됩니다(뱅크링크는 EUR 기준). KWD, BHD 등 소수점 세 자리 통화는 제공되지 않습니다.

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

설치

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

2. Activate를 클릭합니다.

3. 설정을 엽니다: WooCommerce > Settings > Payments > MakeCommerce > Manage로 이동하거나 플러그인 페이지의 플러그인 이름 아래에서 Settings를 클릭합니다.

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

5. 테스트 환경의 Shop ID와 Secret key를 입력하고, 실제 결제를 위해 운영 키를 입력합니다(구성 참조). Merchant Portal에서 구성해야 할 사항은 없습니다.

6. Enable/Disable을 켭니다. Test mode를 켠 상태에서 결제를 테스트한 후 실제 결제를 받으려면 체크를 해제합니다.

구성

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > MakeCommerce. 테스트 모드가 켜져 있는 동안 필드 상단에 Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged.가 표시됩니다. 결제 방법이 활성화되었으나 현재 환경의 Shop ID 또는 Secret key가 비어 있거나 쇼핑몰 통화를 MakeCommerce에서 청구할 수 없는 경우 경고가 표시됩니다. 두 경우 모두 해당 결제 방법은 체크아웃에서 숨겨집니다. 결제 수단 목록에서 MakeCommerce는 현재 환경에 키가 설정될 때까지 설정 필요로 표시됩니다. 저장 시 키에서 공백이 자동으로 제거됩니다.

General

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

Title: 고객이 체크아웃에서 보게 되는 결제 수단 이름입니다. 기본값: Bank link or card (MakeCommerce).

Description: 체크아웃에서 결제 수단 아래에 표시되는 텍스트입니다. 기본값: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

MakeCommerce account

Shop ID와 Secret key는 MakeCommerce Merchant Portal의 Settings > API에 있습니다. 테스트 포털과 운영 포털은 별도의 계정과 키를 사용합니다. 이 섹션에는 두 포털 및 MakeCommerce 가입 페이지에 대한 링크가 포함되어 있습니다.

Test mode: Use the MakeCommerce test environment (no real money is charged). 새로운 결제는 선택한 환경에서 해당 키로 생성됩니다. 각 주문은 결제된 환경을 기억하므로 상태 확인 및 환불은 항상 해당 환경으로 전달됩니다. 체크아웃 시 TEST MODE — MakeCommerce test environment, no real money is charged. 줄이 표시됩니다. 기본값: 켜짐.

Test Shop ID: 테스트 계정의 Shop ID이며, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 형식입니다.

Test Secret key: 테스트 계정의 Secret key입니다.

Live Shop ID: 운영 계정의 Shop ID입니다.

Live Secret key: 운영 계정의 Secret key입니다.

Payment notifications

Merchant Portal에서 구성해야 할 사항은 없습니다. 각 거래는 이 섹션에 표시된 주소(예: https://your-site/wc-api/wc_mkc_payment/)에 주문 번호와 주문 키가 추가된 고유한 복귀, 취소 및 알림 URL을 포함합니다. MakeCommerce는 알림 URL로(서버 간 통신) 그리고 고객 브라우저를 통해 복귀 또는 취소 URL로 서명된 메시지를 전송합니다. 서명은 거래가 생성된 환경의 Secret key로 확인됩니다. 유효한 서명이 없는 메시지는 거부됩니다.

플러그인은 다음과 같은 MakeCommerce 거래 상태를 처리합니다:

고객이 쇼핑몰로 돌아왔을 때도 결제가 확인됩니다. 고객이 서명된 메시지 없이 돌아오는 경우 플러그인이 MakeCommerce API에 상태를 조회합니다.

Advanced

Debug log: Log API calls and payment notifications는 WooCommerce > Status > Logs의 소스 wcp_makecommerce_payment에 세부 정보를 기록합니다. 오류는 항상 기록됩니다. 키와 고객 데이터는 절대 기록되지 않습니다. 기본값: 꺼짐.

Delete data: Delete the gateway settings and logs when the plugin is deleted. 주문 및 결제 메모는 항상 유지됩니다. 플러그인을 비활성화해도 아무것도 삭제되지 않습니다. 기본값: 꺼짐.

체크아웃

고객이 결제 방법(기본값: Bank link or card (MakeCommerce))을 선택하고 주문을 진행합니다. 플러그인은 주문 통화의 주문 총액에 대해 MakeCommerce 거래를 생성하고 고객을 MakeCommerce 결제 페이지로 안내합니다. 그곳에서 고객은 뱅크링크 또는 카드를 선택합니다. 청구서 이메일과 국가 정보가 MakeCommerce로 전달되며, MakeCommerce가 지원하는 경우 쇼핑몰 언어(에스토니아어, 영어, 라트비아어, 리투아니아어, 핀란드어, 러시아어, 독일어, 폴란드어)로 페이지가 열리고 그렇지 않으면 영어로 열립니다.

결제 후 고객은 쇼핑몰의 주문 접수 페이지로 돌아옵니다. 주문은 MakeCommerce가 결제를 확인한 후에만 결제 완료로 표시됩니다. 즉, 서명된 알림이나 고객의 서명된 복귀를 통해, 그리고 MakeCommerce API를 통한 거래 확인을 거친 후 완료됩니다.

고객이 MakeCommerce 페이지에서 취소하거나 결제 세션이 만료된 경우, 고객은 메시지(예: The payment was cancelled. You can try again or choose another payment method. 또는 The payment session expired. Please try again.)와 함께 체크아웃(또는 Pay for order 페이지)으로 돌아옵니다. 결제를 아직 확인할 수 없는 경우 We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. 메시지가 표시됩니다. 고객은 다시 결제할 수 있습니다. 동일한 주문의 이전 결제 링크는 계속 유효하며 주문이 두 번 결제될 수 없습니다.

MakeCommerce가 결제를 시작할 수 없는 경우 고객에게는 MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. 또는 MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. 메시지가 표시됩니다. 기술적인 원인은 주문 메모와 로그에 추가됩니다.

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

은행이나 카드는 쇼핑몰의 체크아웃이 아닌 MakeCommerce 페이지에서 선택합니다. 플러그인에는 저장된 카드, 정기 결제 또는 WooCommerce Subscriptions 기능이 없으며, MakeCommerce 배송(무인 택배 보관함, 운송장 라벨)도 포함되지 않습니다.

주문 및 환불

주문 상태

Pending payment: 고객이 MakeCommerce로 이동한 후 아직 결제하지 않았거나 MakeCommerce가 아직 결제를 확인하지 않았습니다. 주문 메모에 MakeCommerce 거래, 금액 및 환경이 표시됩니다.

Processing: 결제가 확인되었습니다. 가상 다운로드 상품만 포함된 주문은 WooCommerce 기본값에 따라 완료됨으로 변경됩니다. 주문 메모에는 금액, 거래, 환경 및 확인 방식(MakeCommerce API 또는 서명된 알림)이 표시됩니다. 거래 ID는 MakeCommerce 거래 ID입니다.

On hold: 결제 금액이나 통화가 주문과 다르거나, 금액이 누락되었거나, MakeCommerce의 거래 상태가 아직 최종 상태가 아니거나, 취소된 주문에 대해 결제가 도달한 경우입니다. 주문 메모에 이유가 설명됩니다. 이러한 거래는 나중에 주문을 자동으로 결제 완료 상태로 변경하지 않습니다. Merchant Portal에서 거래를 확인하고 수동으로 주문을 완료하거나 환불하세요.

Failed: 주문의 최근 결제가 취소되었거나 만료되었거나 실패했습니다. 고객은 다시 결제할 수 있습니다.

이미 결제된 주문에 대해 두 번째 결제가 도착하더라도 주문은 다시 변경되지 않습니다. 메모를 통해 MakeCommerce Merchant Portal에서 중복 결제분을 환불하도록 요청합니다.

Check MakeCommerce payment status

주문 화면의 주문 작업에서 Check MakeCommerce payment status를 선택합니다. 플러그인은 MakeCommerce API에 주문 거래의 상태(가장 최근 거래부터)를 조회하여 적용하고 결과가 포함된 메모를 추가합니다. 고객이 결제했음에도 주문이 결제 대기 상태로 유지될 때 사용하세요.

환불

주문을 열고 Refund를 클릭한 후 금액을 입력하고 Refund via Bank link or card (MakeCommerce)를 클릭합니다(버튼에 설정한 Title이 표시됨). 전액 및 부분 환불이 지원됩니다. 환불은 주문이 결제된 환경(테스트 또는 운영)으로 전송되므로 해당 환경의 키가 설정되어 있어야 합니다. MakeCommerce가 환불을 수락하지 않으면 WooCommerce에 오류가 표시되고 메모가 추가되며 환불이 기록되지 않습니다. MakeCommerce에서 결제를 여전히 처리 중인 경우 MakeCommerce is still processing this payment — try the refund again later. 메시지가 표시됩니다. 성공한 환불은 MakeCommerce 환불 ID와 함께 주문 메모에 추가됩니다.

Merchant Portal에서 처리된 환불은 거래 상태와 함께 도달하여 주문 메모에 추가됩니다. 이 환불은 WooCommerce 환불로 자동 기록되지 않습니다.

라이선스 키

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

하나의 키는 하나의 도메인에서 작동합니다. 사이트에서 키를 제거해도 도메인 슬롯이 해제되지 않습니다. vibefox.net 계정에서 도메인 슬롯을 해제하세요.

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

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

문제 해결

체크아웃에 MakeCommerce가 표시되지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 현재 환경의 키(테스트 모드의 경우 Test Shop ID 및 Test Secret key, 운영 모드의 경우 Live Shop ID 및 Live Secret key)가 설정되어 있는지 확인하세요. 쇼핑몰 통화(또는 Pay for order 페이지의 주문 통화)의 소수점 자릿수가 최대 두 자리인지 확인하세요. 설정 페이지에는 이러한 각 문제에 대한 경고가 표시됩니다.

결제는 완료되었으나 주문이 결제 대기 상태로 유지됨: 방화벽, 유지보수 모드 또는 기본 인증 등의 원인으로 인해 알림이 사이트에 도달하지 못했습니다. 주문을 열고 주문 작업 Check MakeCommerce payment status를 실행하세요. 결제가 진행된 환경의 키가 설정되어 있는지 확인하세요. 알림은 해당 환경의 Secret key로 확인되며, 키가 없으면 MakeCommerce가 오류를 수신하고 재시도합니다.

주문이 MakeCommerce 메모와 함께 보류 상태임: 결제가 주문(금액, 통화, 상태)과 일치하지 않거나 취소된 주문에 대해 도착했습니다. Merchant Portal에서 거래를 확인하고 수동으로 주문을 완료하거나 환불하세요.

알림이 거부됨: 서명이 잘못되었거나, 다른 주문 또는 다른 쇼핑몰용이거나, 해당 주문을 위해 생성되지 않은 거래에 대한 메시지는 거부되며 주문은 변경되지 않습니다. Shop ID와 Secret key가 동일한 MakeCommerce 계정 및 환경에 속하는지 확인하세요.

주문 진행 시 고객에게 오류가 표시됨: 주문 메모를 열거나 Debug log를 켜고 WooCommerce > Status > Logs의 소스 wcp_makecommerce_payment를 확인하세요. MakeCommerce에서 청구할 수 없는 통화인 경우 MakeCommerce cannot process payments in과 함께 통화 코드가 표시됩니다.

환경에 대한 메시지와 함께 환불 실패: 주문이 테스트 또는 운영 환경에서 결제되었으며 해당 환경의 키가 구성되지 않았습니다. 키를 입력하고 다시 시도하세요.

No MakeCommerce transaction ID found for this order 메시지와 함께 환불 실패: 주문에 MakeCommerce 거래가 없습니다. Merchant Portal에서 환불하세요.

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

제거

플러그인을 비활성화해도 모든 데이터가 유지됩니다. 플러그인을 완전히 제거하려면 Plugins 페이지에서 비활성화한 후 삭제하세요. 이 플러그인의 라이선스 키와 라이선스 상태는 항상 제거됩니다. 게이트웨이 설정과 로그는 Delete data가 켜져 있던 경우에만 제거됩니다. 그렇지 않은 경우 나중에 재설치할 수 있도록 보존됩니다. 기존 주문의 결제 메모와 거래 ID는 그대로 유지됩니다.

MakeCommerce는 해당 소유자의 상표입니다. 이 플러그인은 MakeCommerce와 제휴하거나 MakeCommerce의 보증을 받지 않았습니다.