VibeFox CCAvenue for WooCommerce — 도움말

요구 사항

WordPress: 5.8 이상.

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

PHP: 8.0 이상, OpenSSL 확장 포함(요청 암호화와 응답 복호화에 사용).

CCAvenue 계정: Merchant ID, Access Code, Working Key가 있는 CCAvenue 가맹점 계정이 필요합니다. Access Code와 Working Key는 웹사이트 도메인에 대해 발급되므로, 이 쇼핑몰의 도메인에 대해 생성하세요. CCAvenue는 테스트 환경에도 같은 자격 증명을 사용하며, 테스트 액세스는 CCAvenue가 계정에 대해 활성화해야 합니다. 플러그인은 CCAvenue 인도 엔드포인트를 사용합니다.

통화: 주문 통화는 그대로 CCAvenue에 전송됩니다. CCAvenue 계정은 기본적으로 INR을 받으며, 그 밖의 통화는 CCAvenue 계정에서 다중 통화 처리가 필요합니다.

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

설치

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

2. Activate를 클릭하세요.

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

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

5. CCAvenue 대시보드의 Merchant ID, Access Code, Working Key를 입력하고 Enable/Disable을 켜세요.

6. 테스트하는 동안에는 Test mode를 켜 두고, 실제 결제를 받으려면 끄세요.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > CCAvenue. 입력 항목 위에서 CCAvenue가 활성화되어 있는데 Merchant ID, Access Code 또는 Working Key가 없으면 페이지가 경고를 표시합니다(세 가지가 모두 설정될 때까지 결제 수단이 체크아웃에서 숨겨집니다). 테스트 모드가 켜져 있는 동안에는 CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken.를 표시하며, 쇼핑몰 통화가 INR이 아니면 다중 통화 처리에 대해 알려 줍니다.

일반

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

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

Description: 체크아웃에서 결제 수단 아래에 표시되는 문구입니다. 기본값: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.

API 자격 증명

CCAvenue 가맹점 대시보드(M.A.R.S.)에 로그인하여 Settings > API Keys를 여세요. 이 쇼핑몰의 도메인에 대해 Access Code와 Working Key를 생성하세요. 자격 증명의 공백은 저장할 때 제거됩니다.

Merchant ID: 숫자로 된 CCAvenue Merchant ID입니다. 숫자 이외의 문자가 있으면 저장할 때 오류가 표시되고 이전에 저장된 값이 유지됩니다.

Access Code: 이 웹사이트의 Access Code입니다.

Working Key: 이 웹사이트의 Working Key(암호화 키)입니다. 결제 요청을 암호화하며, CCAvenue 응답을 검증하는 유일한 방법이므로 비밀로 유지하세요.

Test mode: Send customers to the CCAvenue test environment (test.ccavenue.com). CCAvenue는 테스트와 운영에 같은 Merchant ID, Access Code, Working Key를 사용하며, 테스트 액세스는 CCAvenue가 계정에 대해 활성화해야 합니다. 테스트 모드에서는 체크아웃에 TEST MODE: no real transactions will be processed.가 표시됩니다. 기본값: 켜짐. 실제 결제를 받으려면 끄세요.

반환 URL

CCAvenue는 이 섹션에 표시된 주소로 고객을 돌려보냅니다. 주소는 https://your-site/wc-api/ccavenue_p_callback/과 같은 형태입니다. 플러그인이 모든 결제마다 이 URL을 보내므로 CCAvenue에서 설정할 것은 없습니다. 이 URL은 CCAvenue에 등록된 도메인에 속해야 합니다.

고급

Debug log: Log CCAvenue events는 주문 ID, CCAvenue 참조 번호, 상태를 WooCommerce > Status > Logs에 소스 wcp_ccavenue_payment로 기록합니다. 키, 카드 데이터, 주소는 기록되지 않습니다. 기본값: 꺼짐.

Delete data on uninstall: Remove the plugin settings, logs and CCAvenue order references when the plugin is deleted. 플러그인을 비활성화해도 아무것도 삭제되지 않습니다. 기본값: 꺼짐.

체크아웃

고객은 결제 수단(기본값: CCAvenue)을 선택하고 주문합니다. Pay for order 페이지에 Thank you for your order. You are being redirected to CCAvenue to complete the payment.가 표시되며, 고객은 CCAvenue 결제 페이지로 이동합니다. JavaScript가 없으면 고객은 Pay via CCAvenue 또는 Cancel order를 클릭해야 합니다. 시도마다 새 CCAvenue 주문 참조 번호가 발급됩니다. 주문 합계와 통화, 청구 및 배송 정보, 주문 키는 암호화된 요청으로 전송됩니다. 이름과 주소는 CCAvenue가 허용하는 문자와 길이에 맞게 정리되며, 국가와 주는 이름으로, 전화번호는 숫자만 전송됩니다.

결제 후 CCAvenue는 암호화된 응답과 함께 고객을 돌려보냅니다. 주문은 CCAvenue가 확인한 후에만 결제 완료로 표시됩니다. 응답은 Working Key로 복호화되어야 하며, 이 주문에 속해야 하고, 주문과 같은 금액과 통화를 담고 있어야 합니다. 그런 다음 고객은 주문 접수 페이지에 도착합니다.

결제가 실패하면 고객은 Payment was not completed. Please try again or choose a different payment method.와 함께 체크아웃으로 돌아갑니다. 고객이 CCAvenue 페이지에서 취소하면 메시지는 Payment was cancelled. You may try again.입니다. 응답을 검증할 수 없으면 메시지는 We could not confirm the payment result. If your account was charged, please contact us before paying again.입니다. 고객은 결제되지 않은 주문을 다시 결제할 수 있으며, 예를 들어 Pay for order 페이지에서 가능합니다. 결제가 Pay for order 페이지에서 시작되었고 장바구니가 비어 있다면, WooCommerce가 장바구니 페이지에 메시지를 표시하며, 실패한 주문은 My account > Orders에서 다시 결제할 수 있습니다.

이 결제 수단은 클래식 체크아웃, 체크아웃 블록, Pay for order 페이지에서 작동합니다. WooCommerce 고성능 주문 저장소(HPOS)와 호환됩니다. 고객에게 표시되는 문구는 힌디어로 번역되어 있습니다.

결과는 고객이 CCAvenue에서 돌아올 때에만 가져옵니다. 서버 간 알림이나 상태 요청은 없습니다. 고객이 돌아오기 전에 브라우저를 닫으면 주문은 결제 대기 중 상태로 남습니다. 플러그인은 WooCommerce에서의 환불, 저장된 카드, 구독 또는 정기 결제, iframe 또는 사이트 내 카드 입력 양식을 지원하지 않으며, CCAvenue UAE 또는 기타 지역 플랫폼도 지원하지 않습니다.

주문

주문 상태

Pending payment: 고객이 CCAvenue로 보내졌지만 아직 돌아오지 않았습니다. 고객이 돌아오지 않으면 CCAvenue 대시보드에서 결제를 확인하세요.

Processing: 결제가 확인되었습니다(가상 다운로드 상품만 있는 주문은 WooCommerce 기본 동작에 따라 완료됨 상태가 됩니다). 주문 메모에는 은행 참조 번호, CCAvenue 추적 ID, 결제 모드가 표시됩니다. 주문의 거래 ID는 CCAvenue 추적 ID입니다.

On hold, 금액/통화 불일치: CCAvenue가 주문과 금액 또는 통화가 다른 결제를 확인했습니다. 예를 들어 고객이 결제를 시작한 후 주문이 수정되었거나, CCAvenue 할인 프로모션이 적용된 경우입니다. 메모에는 받은 금액과 예상 금액이 표시됩니다. CCAvenue 대시보드에서 결제를 확인한 다음 주문을 완료하거나 환불하세요.

On hold, 은행 확인 대기: CCAvenue가 결제를 Awaited로 보고했습니다. 돈이 아직 캡처될 수 있으므로 주문은 실패로 표시되지 않습니다. 주문을 이행하기 전에 CCAvenue 대시보드에서 확인하고 상태를 수동으로 변경하세요. 같은 추적 ID의 이후 응답은 여전히 적용됩니다.

On hold, 취소된 주문에 대한 결제: 고객이 주문이 취소된 후에 결제했습니다. 재고를 확인한 다음 주문을 이행하거나 환불하세요.

Cancelled: 고객이 CCAvenue 페이지에서 결제를 중단했습니다.

Failed: 결제가 실패했거나, CCAvenue가 Invalid, Timeout 또는 그 밖의 실패 상태를 반환했습니다. 메모에 CCAvenue 메시지가 표시됩니다. 늦게 도착한 실패는 결제 완료된 주문을 절대 변경하지 않습니다.

이미 결제된 주문에 다른 성공 결제가 도착하면(예: 두 개의 브라우저 탭에서 결제한 경우), 주문은 다시 변경되지 않습니다. 메모에는 CCAvenue 대시보드에서 중복 결제를 환불하라는 안내가 표시됩니다.

Refunds: WooCommerce에서의 환불은 지원되지 않습니다. CCAvenue 대시보드에서 결제를 환불한 다음 WooCommerce에 수동으로 기록하세요.

라이선스 키

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

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

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

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

문제 해결

체크아웃에 CCAvenue가 표시되지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 그리고 세 가지 자격 증명이 모두 설정되어 있는지 확인하세요: Merchant ID, Access Code, Working Key. 하나라도 없으면 설정 페이지에 경고가 표시됩니다.

결제는 완료됐지만 주문이 Pending payment 상태로 남아 있음: 고객이 브라우저를 닫는 등의 이유로 CCAvenue에서 쇼핑몰로 돌아오지 않았습니다. 플러그인에는 서버 간 알림이 없습니다. CCAvenue 대시보드에서 결제를 확인하고 주문을 수동으로 업데이트하세요.

모든 결제가 We could not confirm the payment result로 끝남: 응답을 복호화할 수 없습니다. Working Key가 잘못되었거나, 다른 도메인에 속하거나, 추가 문자가 포함된 채로 복사되었습니다. 이 쇼핑몰의 도메인에 대해 키를 다시 생성하고 붙여 넣으세요. Debug log를 켜고 WooCommerce > Status > Logs에서 소스 wcp_ccavenue_payment를 확인하세요.

결제 페이지 전에 CCAvenue에서 오류 표시: Access Code와 Working Key가 이 도메인에 대해 생성되었는지, 반환 URL이 CCAvenue에 등록된 도메인에 속하는지, 그리고 테스트 모드에서는 CCAvenue가 계정에 대해 테스트 액세스를 활성화했는지 확인하세요. INR이 아닌 통화의 경우 CCAvenue 계정에서 다중 통화 처리가 활성화되어 있어야 합니다.

고객에게 This payment method is temporarily unavailable가 표시됨: 자격 증명 중 하나가 없습니다.

고객에게 Payment gateway error: encryption failed가 표시됨: 요청을 암호화할 수 없었습니다. PHP OpenSSL 확장이 설치되어 있는지 확인하세요.

결제 후 주문이 On hold 상태임: 주문 메모를 읽어 보세요. 결제된 금액 또는 통화가 주문과 달랐거나, 결제가 은행 확인을 기다리고 있거나, 주문이 취소되었습니다. CCAvenue 대시보드에서 결제를 확인한 다음 주문을 이행하거나 결제를 환불하세요.

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

개발자의 경우, readme 파일에 CCAvenue로 전송되는 데이터를 변경하는 필터 ccavenue_p_request_params(예: merchant_param2에서 merchant_param5까지 또는 promo_code. amount, currency, order_id, merchant_param1은 변경하지 마세요)와 체크아웃 아이콘용 필터 ccavenue_p_icon이 나와 있습니다.

제거

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

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