개발자/생태계 및 리소스

CardV Gift Cards for WooCommerce

WooCommerce 스토어에서 CardV 디지털 기프트카드를 판매하세요. 판매할 카드를 고르면 플러그인이 상품을 만들고, 고객이 결제하면 CardV 잔액으로 코드를 구매해 주문 페이지와 주문 이메일로 전달합니다.

WordPress.org에서 설치 ↗API 키 받기 ↗

#주요 기능

  • 카탈로그에서 가져오기. WordPress 관리자 화면에서 CardV 카탈로그를 둘러보고 클릭 한 번으로 카드를 스토어에 추가합니다.
  • 고정 금액과 자유 금액. 고정 금액 카드는 금액을 선택할 수 있는 하나의 상품이 됩니다. 자유 금액 카드에는 금액 입력란이 있으며 가격을 실시간으로 미리 볼 수 있습니다.
  • 마진을 지키는 가격 설정. 스토어 전체 또는 카드별로 마크업을 설정합니다. 가격은 최소 마진 아래로 내려가지 않으므로 원가가 올라도 손해를 보고 팔지 않습니다.
  • 예약 동기화. 카탈로그, 원가, 재고는 지정한 주기로 동기화됩니다(기본값 6시간마다).
  • 규칙에 따른 자동 전달. 결제 후 코드는 자동으로 전달되며, 결제 수단, 주문 금액, 고객별·IP별 주문 수, 첫 주문 한도, 국가 확인에 따라 검토 대기로 보류할 수도 있습니다.
  • 코드를 안전하게 보관. 코드는 암호화되어 저장되며 구매한 고객에게만 표시됩니다. 관리자 이메일에는 코드가 포함되지 않습니다.
  • Sandbox. Sandbox 키로 실제 돈 없이 전체 흐름을 테스트합니다.

#요구 사항

WordPress6.5 이상
WooCommerce설치 및 활성화
PHP7.4 이상
CardV 계정API 키가 있는 승인된 가맹점 계정
잔액CardV 선불 잔액(주문 대금이 여기서 결제됨)

고객에 대한 판매자는 귀하입니다. 가격을 정하고, 어떤 주문을 자동으로 전달할지 결정하며, 고객 지원과 환불을 처리합니다.

#설치

WordPress 관리자 화면에서 설치(권장). 플러그인 > 새로 추가(Plugins > Add New) 를 열고 CardV Gift Cards를 검색한 뒤 설치하고 활성화합니다.

zip 파일 업로드. WordPress.org에서 플러그인을 내려받은 뒤 플러그인 > 새로 추가 > 플러그인 업로드(Plugins > Add New > Upload Plugin) 를 열고 zip 파일을 선택해 설치하고 활성화합니다.

#설정

  1. CardV 가맹점 계정을 신청합니다. 계정은 주문하기 전에 심사를 거칩니다.
  2. 포털에서 Sandbox API 키를 만들고 키 ID, 서명 시크릿, Webhook 시크릿을 저장합니다.
  3. CardV > Settings를 열고 Sandbox를 선택한 뒤 세 값을 붙여 넣고 저장합니다. 플러그인이 연결을 테스트합니다. 키는 이 페이지에서 입력하며 암호화되어 저장되므로 wp-config.php를 수정할 필요가 없습니다.
  4. Settings 페이지에 표시된 Webhook URL을 포털에 복사합니다.
  5. CardV > Products를 열고 판매할 카드를 선택해 가져옵니다.
  6. 가격과 전달 규칙을 확인하고 테스트 주문을 넣은 뒤, Live 키를 추가하고 Live로 전환합니다.

#작동 방식

상품. CardV 카드 하나가 WooCommerce 상품 하나가 됩니다. 고정 금액 카드는 금액을 선택할 수 있고, 자유 금액 카드에는 금액 입력란이 있으며 고객이 입력한 금액에 맞춰 가격이 계산됩니다.

가격과 동기화. 동기화할 때마다 플러그인은 원가, 가격, 판매 가능 여부를 업데이트합니다. 상품 제목, 설명, 이미지는 덮어쓰지 않습니다.

전달. 선택한 결제 수단으로 결제되고 전달 규칙을 통과한 주문은 자동으로 전달됩니다. 나머지 주문은 CardV > Orders에서 승인 또는 거절을 기다립니다. CardV 잔액이 부족하면 잔액이 장바구니 금액을 충당할 때까지 기프트카드 결제가 일시 중지되므로, 전달할 수 없는 카드에 대해 고객이 결제하는 일은 없습니다.

고객 데이터. 플러그인은 코드 구매에 필요한 정보만 CardV에 보냅니다. 상품, 금액, 수량, 예상 가격, 주문 참조 번호입니다. 고객의 이름, 이메일 주소, 우편 주소, IP 주소, 결제 정보는 보내지 않습니다. 자세한 내용은 개인정보처리방침을 참고하세요.

#스크린샷

잔액, 상품, 처리가 필요한 주문을 보여 주는 개요 화면

  1. 잔액, 상품, 처리가 필요한 주문을 보여 주는 개요 화면.

CardV 카탈로그에서 상품 가져오기

  1. CardV 카탈로그에서 상품 가져오기.

상품 페이지에서 금액 선택

  1. 상품 페이지에서 금액 선택.

주문 페이지의 기프트카드 코드

  1. 주문 페이지의 기프트카드 코드.

가격 및 전달 규칙

  1. 가격 및 전달 규칙.

#자주 묻는 질문

CardV 계정이 필요한가요? 네. 플러그인은 CardV 상품을 판매하고 그 대금을 CardV 잔액에서 결제합니다.

상품 제목, 설명, 이미지를 바꿀 수 있나요? 네. 동기화는 원가, 가격, 판매 가능 여부만 업데이트합니다.

테마에서 코드 표시 방식을 바꿀 수 있나요? 네. 플러그인의 templates 폴더에서 원하는 파일을 yourtheme/cardv-gift-cards/로 복사해 수정하세요.

플러그인을 삭제하면 무엇이 제거되나요? 설정, 암호화된 시크릿, 예약 작업, 활동 로그입니다. 상품과 주문은 WooCommerce에 남고, 전달된 코드는 주문에 암호화된 상태로 유지됩니다.

#지원

이 플러그인은 무료이며 GNU General Public License 버전 2 이상으로 배포됩니다. CardV 서비스 이용에는 이용약관이 적용됩니다. 도움이 필요하면 Merchant ID와 주문 번호를 적어 [email protected]으로 이메일을 보내 주세요.

연동 관련 문의는 Merchant ID와 주문 ID 또는 요청 ID를 포함해 [email protected]로 보내 주세요.