KR
EUR
뒤로

VibeFox 2C2P for WooCommerce — 도움말

요구 사항

WordPress: 5.8 이상.

WooCommerce: 6.0 이상, 설치 및 활성화되어 있어야 합니다. WooCommerce가 없으면 플러그인은 관리자 영역에 알림을 표시하고 결제 수단은 로드되지 않습니다.

PHP: 8.0 이상.

2C2P 계정: 2C2P 가맹점 계정의 Merchant ID와 Secret Key가 필요합니다. 가맹점 계정을 개설할 때 2C2P가 발급합니다. 샌드박스 계정과 운영 계정의 키는 서로 다릅니다. 개발자 문서와 샌드박스 테스트 카드는 developer.2c2p.com에 있습니다.

통화: 쇼핑몰 통화는 플러그인이 지원하고 2C2P 계정에서 활성화되어 있어야 합니다. 지원되는 통화에는 THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR, GBP 등이 있습니다. 쇼핑몰 통화가 지원되지 않으면 체크아웃에서 결제 수단이 숨겨집니다.

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

설치

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

2. Activate를 클릭하세요.

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

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

5. 샌드박스 Merchant ID와 Secret Key를 입력하고, Enable/Disable을 켠 다음 테스트 주문을 하세요.

6. 준비가 되면 운영 자격 증명을 입력하고 Sandbox Mode의 체크를 해제하세요.

반환 URL과 알림 URL은 모든 결제와 함께 전송됩니다. 2C2P 포털에서 아무것도 설정할 필요가 없습니다.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > 2C2P. 샌드박스 모드가 켜져 있는 동안에는 필드 위에 Sandbox mode is active. No real transactions will be processed.가 표시됩니다. 또한 결제 게이트웨이가 활성화되어 있지만 현재 모드의 Merchant ID 또는 Secret Key가 비어 있거나 쇼핑몰 통화가 지원되지 않으면 경고합니다. 두 경우 모두 체크아웃에서 결제 수단이 숨겨집니다. Sandbox Mode가 꺼진 상태로 저장할 때 운영 Merchant ID 또는 Secret Key가 비어 있으면 플러그인이 이를 입력하라고 요청합니다.

일반

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

Title: 체크아웃에서 고객이 보는 결제 수단 이름입니다. 기본값: 2C2P Payment.

Description: 체크아웃에서 결제 수단 아래에 표시되는 문구입니다. 기본값: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. 샌드박스 모드에서는 여기에 (TEST MODE)가 추가됩니다.

테스트 모드(샌드박스)

Sandbox Mode: Enable sandbox / test mode는 결제를 아래의 샌드박스 자격 증명으로 2C2P 샌드박스(demo2.2c2p.com)에 보냅니다. 기본값: 켜짐. 실제 결제를 받으려면 체크를 해제하세요.

Sandbox Merchant ID: 샌드박스 2C2P Merchant ID입니다.

Sandbox Secret Key: 샌드박스 2C2P Secret Key입니다.

운영 API 자격 증명

샌드박스 모드가 꺼져 있을 때 사용됩니다.

Merchant ID: 운영 2C2P Merchant ID입니다. 샌드박스 모드가 꺼져 있을 때 필수입니다.

Secret Key: 운영 2C2P Secret Key입니다. 샌드박스 모드가 꺼져 있을 때 필수입니다. 키는 따옴표와 백슬래시를 포함하여 입력한 그대로 저장됩니다.

결제 페이지

이 섹션은 참고용으로 프런트엔드 반환 URL(https://your-site/?wc-api=tc2p_p)과 백엔드 알림 URL(https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1)을 보여줍니다. 두 URL은 모든 결제와 함께 자동으로 전송됩니다.

Payment Page Language: 2C2P 결제 페이지의 언어입니다. 기본값: English.

Options: English, Thai, Japanese, Bahasa Indonesia, Burmese, Simplified Chinese.

Redirect API version: 계정이 여전히 구버전 7.0(SHA-1 서명)을 사용한다고 2C2P가 알리지 않았다면 8.5를 유지하세요. 전환 이전에 시작된 결제의 결과도 계속 검증됩니다.

8.5 — HMAC-SHA256 (recommended): 현재 버전입니다(기본값).
7.0 — HMAC-SHA1 (legacy accounts): 이전 2C2P 계정용입니다.

Order ID prefix: 선택 사항이며 문자와 숫자만 사용할 수 있습니다(최대 10자). 예: SHOP1. 2C2P는 이미 사용된 주문 ID를 거부합니다. 여러 쇼핑몰이 하나의 2C2P 계정을 공유하는 경우, 그리고 테스트 가맹점 계정을 여러 개발자가 함께 쓰는 샌드박스에서는 고유한 접두사를 설정하세요. 다른 문자는 저장할 때 경고와 함께 제거됩니다.

고급 설정

Enable Logging: Log 2C2P events는 WooCommerce > Status > Logs에 소스 wcp_2c2p_payment로 기록합니다. 카드 데이터와 Secret Key는 기록되지 않습니다. 기본값: 꺼짐.

Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted. 기본값: 꺼짐.

체크아웃에서의 작동 방식

고객은 결제 수단(기본값: 2C2P Payment)을 선택하고 주문합니다. 다음 페이지에 Thank you for your order. You will be redirected to 2C2P to complete your payment.가 표시되고, 잠시 후 고객을 2C2P 결제 페이지로 보냅니다. 그렇지 않으면 고객이 Pay via 2C2P를 클릭합니다. 이 페이지에는 Cancel order 버튼도 있습니다.

2C2P 페이지에서 고객은 2C2P 계정에서 활성화된 모든 수단(예: 카드, 전자 지갑, QR 결제, 인터넷 뱅킹, 현금 결제)으로 결제할 수 있습니다. 플러그인은 주문 금액을 주문 통화로, 고객의 청구 이메일과 주문한 상품 이름을 전달합니다. 결제는 24시간 이내에 완료할 수 있습니다.

2C2P는 결과를 두 번 보고합니다. 고객의 브라우저가 쇼핑몰로 돌아오고, 2C2P가 서버 간 알림을 보냅니다. 두 경우 모두 같은 방식으로 처리됩니다. 주문은 2C2P가 유효한 서명으로 확인한 후에만 결제 완료로 표시됩니다. 결과는 해당 주문에 속해야 하므로 가맹점 ID, 주문 키, 주문 ID, 결제 수단도 확인됩니다. 유효하지 않은 서명의 결과는 거부됩니다.

결제가 성공하거나 대기 중이면 고객은 주문 접수 페이지로 이동하고 장바구니가 비워집니다. 결제가 완료되지 않았다면 고객은 Payment was not completed. Please try again or choose a different payment method. 메시지와 함께 체크아웃으로 돌아갑니다. 주문은 취소되고 장바구니는 유지되므로 고객은 새 주문을 할 수 있습니다. 결과를 확인할 수 없으면 고객에게 We could not confirm the payment result. If your account was charged, please contact us before paying again.가 표시됩니다.

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

플러그인은 WooCommerce에서의 환불, 저장된 카드, 정기 결제 또는 WooCommerce Subscriptions, 쇼핑몰 사이트의 카드 입력 필드를 지원하지 않으며, 2C2P PGW 4.x API도 지원하지 않습니다.

주문

주문 상태

Pending payment: 고객이 2C2P로 이동했지만 아직 결과가 도착하지 않았습니다.

Processing or Completed: 2C2P가 결제 성공(상태 000)을 보고했습니다. WooCommerce는 주문을 처리중으로 설정하거나, 다운로드 가능한 가상 상품만 있는 주문은 완료됨으로 설정합니다. 주문 메모에는 2C2P 거래, 승인 코드, 날짜 및 결제 채널이 표시됩니다. 거래 ID는 2C2P 거래 참조 번호입니다.

On hold: 2C2P에서 결제가 대기 중입니다(상태 001). 예를 들어 고객이 아직 지불하지 않은 현금 결제입니다. 2C2P가 결제를 보고하면 주문이 결제 완료가 됩니다. 2C2P가 주문 합계와 다른 금액이나 통화를 보고하는 경우에도 주문이 보류됩니다. 주문 메모에는 받은 값과 예상 값이 표시됩니다. 2C2P 포털에서 주문과 거래를 확인하세요.

Cancelled: 결제가 거부되었거나, 고객이 취소했거나, 실패했습니다(상태 002, 003, 999). 주문 메모에는 상태와 사유가 표시됩니다.

결제 완료되었거나 환불된 주문은 이후의 결과로 절대 변경되지 않으며, 오래된 결과가 다시 도착해도 취소한 주문이 다시 열리지 않습니다.

환불

WooCommerce에서의 환불은 지원되지 않습니다. 2C2P 가맹점 포털에서 결제를 환불한 다음, WooCommerce에서 수동 환불을 생성하세요.

라이선스 키

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

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

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

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

문제 해결

체크아웃에 2C2P가 표시되지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 그리고 현재 모드에 Merchant ID와 Secret Key가 있는지 확인하세요. 샌드박스 모드에서는 샌드박스 필드를, 운영 모드에서는 운영 필드를 확인하세요. 쇼핑몰 통화가 지원되는지도 확인하세요. 두 경우 모두 설정 페이지에 경고가 표시됩니다.

결제는 완료됐지만 주문이 Pending payment 상태로 남아 있음: 유효한 결과가 쇼핑몰에 도달하지 않았습니다. 현재 모드의 Merchant ID와 Secret Key가 결제한 2C2P 계정과 일치하는지, 그리고 Redirect API version이 계정과 맞는지 확인하세요. 서명이 잘못되었거나 다른 Merchant ID의 결과는 거부됩니다. Enable Logging을 켜고 WooCommerce > Status > Logs에서 hash 또는 merchant ID 메시지를 찾아보세요. 또한 서버가 2C2P의 백엔드 알림 URL 요청을 수락하는지 확인하세요.

2C2P에서 주문 ID가 이미 존재한다고 표시됨: 2C2P는 같은 주문 ID를 두 번 받지 않습니다. 이는 여러 쇼핑몰이 하나의 2C2P 계정을 공유하거나, 데모 가맹점 계정을 많은 개발자가 공유하는 샌드박스에서 발생합니다. 고유한 Order ID prefix를 설정하세요.

결제는 됐지만 주문이 On hold 상태임: 결제가 아직 2C2P에서 대기 중이거나(예: 고객이 아직 지불하지 않은 현금 결제), 결제된 금액이나 통화가 주문과 일치하지 않은 경우입니다. 주문 메모와 2C2P 포털에서 거래를 확인하세요.

고객에게 This payment method is currently unavailable for this order가 표시됨: 주문 통화가 지원되지 않거나, 현재 모드의 Merchant ID 또는 Secret Key가 비어 있습니다.

저장 시 Please enter your live Merchant ID 또는 Please enter your live Secret Key가 표시됨: 샌드박스 모드가 꺼져 있고 운영 필드가 비어 있습니다. 운영 자격 증명을 입력하거나 Sandbox Mode를 켜 두세요.

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

제거

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

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