BTCPay 결제 화면에 스테이블코인을 추가하세요.

설치

1. 다운로드 BTCPayServer.Plugins.WhollyCrypto.btcpay 한 다음 릴리스의 다음 항목과 대조하세요: SHA256SUMS. GitHub 소스 ZIP이 아니라 플러그인 파일을 사용하세요.
2. BTCPay 관리자로 다음을 여세요: 플러그인 관리 → 플러그인 업로드, 파일을 업로드하고 BTCPay를 재시작하세요.
3. 스토어 → 플러그인 → Wholly Crypto를 선택하세요. 설치만으로 스토어가 연결되지는 않아요.

업데이트도 같은 업로드 절차를 사용해요. Wholly 판매자 소프트웨어를 업데이트해도 BTCPay 플러그인은 업데이트되지 않아요.

스토어 연결

1. Wholly에서 결제 수단, 백업된 지갑, 환율, 확인 횟수를 갖춘 활성 프로젝트와 스토어를 만드세요. 최신 판매자 설치를 사용하세요. 이 커넥터는 6.4.5 API를 대상으로 해요.
2. 다음에서 프로젝트·스토어 UUID를 복사하세요: 스토어 → 기본 → API ID. 프로젝트로 제한한 읽기·쓰기 API 인증 정보를 만드세요. 다음을 켜세요: 스토어 → IPN 하고 해당 서명 비밀 키를 복사하세요. 웹훅 비밀 키는 사용하지 마세요.
3. BTCPay의 Wholly 설정에 해당 값과 API·결제 오리진을 입력하세요. 예: https://api.example.com 및 https://pay.example.com. 경로 없이 443번 포트의 공개 HTTPS를 사용하세요.
4. 활성화 결제 화면에서 Wholly Crypto 제공, 저장한 다음 읽기 접근 테스트. 필요하면 스토어에서 받는 결제 수단 중 일부만 선택할 수 있어요.

양쪽 방화벽에서 Wholly 서버가 BTCPay로 보내는 HTTPS 콜백을 허용하세요. 플러그인이 콜백 URL을 제공해요. 이 경로에는 브라우저 로그인, CAPTCHA, Basic Auth를 적용하지 말고 서명 검증은 반드시 켜 두세요.

삽입형 결제 화면

기본값은 전체 페이지 결제이며 모바일 지갑 앱에 특히 좋아요. iframe을 쓰려면:

1. Wholly의 다음 화면에서: 스토어 → 고급, 다음을 켜세요: 삽입형 결제 화면 허용. 정확한 BTCPay HTTPS 오리진을 다음에 추가하세요: 허용된 HTTPS 오리진, 경로나 와일드카드 없이 입력하세요.
2. BTCPay 플러그인 설정에서 다음을 선택하세요: 고객 결제 화면 → 삽입형 결제 화면(iframe) 하고 저장하세요.
3. 새 청구서를 테스트하세요. 기존 청구서는 원래 표시 모드를 유지해요. 전체 결제 화면 열기 는 프레임을 불러오지 못해도 같은 청구서에서 계속 사용할 수 있어요.

브라우저 메시지와 반환 링크는 이동용일 뿐 결제 증거가 아니에요.

결제 흐름 확인

테스트 스토어에서 양수인 소액 법정화폐 청구서를 만드세요. 선택할 항목: 스테이블코인 및 암호화폐 · Wholly. 결제 화면, 서명된 IPN, API 검증을 최종 확인까지 점검하세요. BTCPay에서 정산된 청구서만 근거로 주문을 한 번씩 이행하세요.

읽기 접근 테스트 는 청구서 생성이나 IPN을 테스트하지 않아요. 다음을 사용하세요: 연결 및 연결된 결제 에서 안전한 오류 메시지, 주문 참조, 결제 확인을 볼 수 있어요.