PrestaShop 플러그인

PrestaShop용 암호화폐 결제.

쇼핑몰을 직접 운영하는 Wholly Crypto 결제 페이지에 연결해. 고객은 네트워크와 토큰을 고르고, 검증된 알림으로 주문이 업데이트돼.

플러그인 받기

v1.0.1

첫 버전은 PrestaShop 9.x와 PHP 8.1+용이야. PrestaShop 9.2.0에서 테스트했어. 네 테마와 결제 흐름은 테스트 환경에서 먼저 확인해.

MIT 라이선스 · PHP SDK 포함 · Composer 설정 불필요

간단한 결제. 검증된 주문.

  • 스토어에서 허용한 자산을 사용하는 호스팅 결제 페이지
  • 서명된 IPN 및 인증된 API 점검
  • 저장된 청구서 재시도와 중복 결제 처리 방지

지갑 키는 Wholly Crypto에 그대로 있어. 플러그인은 별도 비율 수수료를 추가하지 않지만 처리 크레딧 정책은 계속 적용돼.

설치

설치 패키지를 내려받고 SHA256SUMS를 확인해. GitHub의 소스 코드 ZIP은 사용하지 마.

whollycrypto-prestashop-1.0.1.zip

다음 메뉴에서 ZIP을 업로드해:

Modules → Module Manager → Upload a module

모듈 설정을 열어. 멀티스토어를 사용한다면 먼저 스토어 하나를 선택해.

Wholly Crypto → Configure

스토어 연결

API와 결제 페이지의 오리진, 프로젝트와 스토어의 API UUID, 해당 프로젝트로 제한된 읽기/쓰기 API 자격 증명, 스토어 IPN 서명 비밀키를 입력해. Wholly에서 IPN을 켜면 콜백 URL은 플러그인이 넣어 줘.

HTTPS를 사용해. 콜백은 CAPTCHA나 브라우저 로그인 없이 방화벽을 통과하도록 허용해. 저장하고 연결을 확인한 다음 테스트 결제를 완료해.

연결 확인은 API 접근만 테스트해. 전체 결제 테스트는 아니야.

결제 흐름 확인

미확정 또는 부분 결제는 대기 상태로 남아. 주문과 일치하는 정산 완료 결제는 주문을 한 번만 업데이트해. 초과 입금, 늦거나 잘못된 결제, 변경된 주문은 확인이 필요해. 브라우저로 돌아온 것만으로는 결제가 확인되지 않아.

PrestaShop 주문 상세에 청구서 ID가 표시돼. 모듈의 복구 양식으로 새 청구서를 만들지 않고 지연된 결제를 확인해.

제한 및 전송 문제

이 버전은 양수 금액의 법정화폐 주문과 전체 페이지 결제를 지원해. 자동 환불이나 정기 출금은 없어. PrestaShop 분할 배송 장바구니는 지원하지 않아.

크레딧이 부족하면 IPN이 멈출 수 있지만 고객은 계속 결제할 수 있어. 크레딧을 충전하고 Wholly 전송 기록에서 실패한 알림을 다시 보내.

처리 크레딧 작동 방식 → · IPN 가이드 →