MAGENTO 플러그인

Magento 2에서 암호화폐 결제를 받으세요.

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

Magento 2

v1.0.0

Magento 2.4 · PHP 8.2+ · HTTPS · InnoDB

Magento Open Source 2.4.8-p5의 기본 결제 화면에서 테스트했어요. 사용하는 Magento 버전의 PHP 요구 사항을 따라주세요.

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

설치

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

Magento 루트 폴더에 ZIP을 풀고, 쇼핑몰 파일을 소유한 사용자로 아래 명령을 실행하세요. en_US는 쇼핑몰에서 쓰는 언어 코드로 바꾸세요.

php bin/magento module:enable WhollyCrypto_Payment
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f en_US
php bin/magento cache:flush

스토어 연결

Stores → Configuration → Sales → Payment Methods → Wholly Crypto를 여세요. 스토어 뷰를 고르고 결제 수단을 켜세요.

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

IPN 콜백이 CAPTCHA나 브라우저 로그인 없이 방화벽을 통과하도록 허용하세요. 정식 운영 전에 테스트 상점에서 결제를 확인하세요.

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

결제 흐름 확인

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

Magento에는 결제 완료 인보이스가 한 번만 기록돼요. 주문의 Payment Information과 메모에서 Wholly 인보이스 ID와 검증 결과를 볼 수 있어요.

누락된 업데이트 확인

Magento cron이 저장된 인보이스를 5분마다 확인해요. 쇼핑몰 폴더에서 수동 확인도 실행할 수 있어요.

php bin/magento whollycrypto:reconcile --limit=50
제한 및 전송 문제

자동 환불, 정기 출금, 주문 분할 결제와 내장 결제 화면은 지원하지 않아요.

Hyvä, PWA/헤드리스 결제 화면, Adobe Commerce 전용 확장 기능은 테스트 환경에서 따로 검증해야 해요.

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

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